Metadata-Version: 2.1
Name: WinSystemShell
Version: 0.0.2
Summary: A local privilege escalation utility that allows elevating from an administrator context to the SYSTEM account on Windows to perform high-privilege operations.
Home-page: https://github.com/mauricelambert/WinSystemShell
Author: Maurice Lambert
Author-email: mauricelambert434@gmail.com
Maintainer: Maurice Lambert
Maintainer-email: mauricelambert434@gmail.com
License: GPL-3.0 License
Download-URL: https://mauricelambert.github.io/info/python/security/WinSystemShell.pyz
Project-URL: Github, https://github.com/mauricelambert/WinSystemShell
Project-URL: Documentation, https://mauricelambert.github.io/info/python/security/WinSystemShell.html
Project-URL: Python Executable, https://mauricelambert.github.io/info/python/security/WinSystemShell.pyz
Project-URL: Windows Executable, https://mauricelambert.github.io/info/python/security/WinSystemShell.exe
Keywords: privilege escalation,privesc,SYSTEM,Windows,elevated rights,local admin
Platform: Windows
Classifier: Topic :: System
Classifier: Topic :: Security
Classifier: Environment :: Console
Classifier: Topic :: System :: Shells
Classifier: Natural Language :: English
Classifier: Programming Language :: Python
Classifier: Topic :: System :: System Shells
Classifier: Programming Language :: Python :: 3.8
Classifier: Operating System :: Microsoft :: Windows
Classifier: Topic :: System :: Systems Administration
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE.txt

![WinSystemShell Logo](https://mauricelambert.github.io/info/python/security/WinSystemShell_small.png "WinSystemShell logo")

# WinSystemShell

## Description

A local privilege escalation utility that allows elevating from an
administrator context to the SYSTEM account on Windows to perform
high-privilege operations.

## Requirements

This package require:

 - python3
 - python3 Standard Library

## Installation

### Pip

```bash
python3 -m pip install WinSystemShell
```

### Git

```bash
git clone "https://github.com/mauricelambert/WinSystemShell.git"
cd "WinSystemShell"
python3 -m pip install .
```

### Wget

```bash
wget https://github.com/mauricelambert/WinSystemShell/archive/refs/heads/main.zip
unzip main.zip
cd WinSystemShell-main
python3 -m pip install .
```

### cURL

```bash
curl -O https://github.com/mauricelambert/WinSystemShell/archive/refs/heads/main.zip
unzip main.zip
cd WinSystemShell-main
python3 -m pip install .
```

## Usages

### Command line

```bash
WinSystemShell              # Using CLI package executable
python3 -m WinSystemShell   # Using python module
python3 WinSystemShell.pyz  # Using python executable
WinSystemShell.exe          # Using python Windows executable

python WinSystemShell.py --executable C:\Windows\System32\cmd.exe --schtasks "SystemRunOnce.exe" --server-path C:\temp\server.py --pipein shellpipein --pipeout shellpipeout
```

### Python script

```python
from WinSystemShell import *

PipeClient(executable=r"C:\Windows\System32\cmd.exe", schtasks="SystemRunOnce.exe", server_path=r"C:\temp\server.py", pipein="shellpipein", pipeout="shellpipeout").run()
```

## Links

 - [Pypi](https://pypi.org/project/WinSystemShell)
 - [Github](https://github.com/mauricelambert/WinSystemShell)
 - [Documentation](https://mauricelambert.github.io/info/python/security/WinSystemShell.html)
 - [Python executable](https://mauricelambert.github.io/info/python/security/WinSystemShell.pyz)
 - [Python Windows executable](https://mauricelambert.github.io/info/python/security/WinSystemShell.exe)
 - [Server Documentation](https://mauricelambert.github.io/info/python/security/SystemShellServer.html)
 - [Server Python executable](https://mauricelambert.github.io/info/python/security/SystemShellServer.pyz)
 - [Server Python Windows executable](https://mauricelambert.github.io/info/python/security/SystemShellServer.exe)

## License

Licensed under the [GPL, version 3](https://www.gnu.org/licenses/).


