# Reverse shell server for unbureaucratic server/client connections with file transfer / screenshots
## pip install reverseshellserver
#### Tested against Windows 10 / Python 3.10 / Anaconda
Shell Server: A simple server-side application that allows multiple clients to connect, execute shell-like commands,
taking screenshots, and exchange files over a network using sockets.
To install the client: https://pypi.org/project/reverseshellclient/
This server application implements a basic command shell that listens for client connections, executes user commands,
and responds to the client with appropriate outputs or actions.
Clients can connect to the server using a TCP/IP socket
The server and client communicate using a custom command encoding format to handle large data transmissions.
The server can send data to the client, and the client can send data to the server.
Usage:
1. Instantiate the ShellServer class with desired configurations (port, buffer size, commands, etc.).
2. Start the server using the `do_actions()` method, which listens for incoming client connections and allows communication with clients.
3. Clients can connect to the server using a TCP/IP socket.
Note:
- The server can handle multiple clients simultaneously through multi-threading.
- When a client sends the 'quit' command, the client remains connected.
- When a client sends the 'exit' command, the client is disconnected from the server.
- The server supports the 'putfile' and 'getfile' commands to send and receive files between the server and clients.
- Screenshots can be taken using command_screenshot
```python
from reverseshellserver import ShellServer
se = ShellServer(
port=12345,
listen=5,
byte_len=32768,
command_quit="quit",
command_disconnect="disconnect",
command_exit="exit",
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",
)
se.do_actions()
```
Raw data
{
"_id": null,
"home_page": "https://github.com/hansalemaos/reverseshellserver",
"name": "reverseshellserver",
"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/ac/49/225434b0ee4a3ee923f1b89b48a12a9c8257ed63308a1eed61cd827f47a4/reverseshellserver-0.11.tar.gz",
"platform": null,
"description": "\r\n# Reverse shell server for unbureaucratic server/client connections with file transfer / screenshots \r\n\r\n## pip install reverseshellserver \r\n\r\n#### Tested against Windows 10 / Python 3.10 / Anaconda \r\n\r\nShell Server: A simple server-side application that allows multiple clients to connect, execute shell-like commands,\r\ntaking screenshots, and exchange files over a network using sockets.\r\n\r\nTo install the client: https://pypi.org/project/reverseshellclient/\r\n\r\nThis server application implements a basic command shell that listens for client connections, executes user commands,\r\nand responds to the client with appropriate outputs or actions.\r\nClients can connect to the server using a TCP/IP socket\r\n\r\nThe server and client communicate using a custom command encoding format to handle large data transmissions.\r\nThe server can send data to the client, and the client can send data to the server.\r\n\r\n\r\nUsage:\r\n1. Instantiate the ShellServer class with desired configurations (port, buffer size, commands, etc.).\r\n2. Start the server using the `do_actions()` method, which listens for incoming client connections and allows communication with clients.\r\n3. Clients can connect to the server using a TCP/IP socket.\r\n\r\nNote:\r\n- The server can handle multiple clients simultaneously through multi-threading.\r\n- When a client sends the 'quit' command, the client remains connected.\r\n- When a client sends the 'exit' command, the client is disconnected from the server.\r\n- The server supports the 'putfile' and 'getfile' commands to send and receive files between the server and clients.\r\n- Screenshots can be taken using command_screenshot\r\n\r\n```python\r\n\r\nfrom reverseshellserver import ShellServer\r\nse = ShellServer(\r\n port=12345,\r\n listen=5,\r\n byte_len=32768,\r\n command_quit=\"quit\",\r\n command_disconnect=\"disconnect\",\r\n command_exit=\"exit\",\r\n command_putfile=\"putfile\",\r\n command_getfile=\"getfile\",\r\n command_screenshot=\"screenshot\",\r\n command_getcwd=\"getcwd\",\r\n command_putfile_sep=b\"FILESEP\",\r\n command_start=b\"START_START_START\",\r\n command_end=b\"END_END_END\",\r\n)\r\nse.do_actions()\r\n\t\t\r\n```\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Reverse shell SERVER for unbureaucratic server/client connections with file transfer / screenshots",
"version": "0.11",
"project_urls": {
"Homepage": "https://github.com/hansalemaos/reverseshellserver"
},
"split_keywords": [
"network",
"reverse",
"shell"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2a91065b7c905be0077c842a8c028b04b821626cba2d945b0fcd137ce8c2a908",
"md5": "51d9520c9f7f424ba2f9e221c1c933bd",
"sha256": "54df7a8f331cd66f0e7e6aee44d619afc8f3d00a591b2332796987727f8787fc"
},
"downloads": -1,
"filename": "reverseshellserver-0.11-py3-none-any.whl",
"has_sig": false,
"md5_digest": "51d9520c9f7f424ba2f9e221c1c933bd",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 53513,
"upload_time": "2023-07-26T23:22:15",
"upload_time_iso_8601": "2023-07-26T23:22:15.055447Z",
"url": "https://files.pythonhosted.org/packages/2a/91/065b7c905be0077c842a8c028b04b821626cba2d945b0fcd137ce8c2a908/reverseshellserver-0.11-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ac49225434b0ee4a3ee923f1b89b48a12a9c8257ed63308a1eed61cd827f47a4",
"md5": "acc265c3bef9831b4794c16e48298075",
"sha256": "35a8edeca2241d9687240824ae27542e2620c89fe1bd92088f1ecaf8d2222537"
},
"downloads": -1,
"filename": "reverseshellserver-0.11.tar.gz",
"has_sig": false,
"md5_digest": "acc265c3bef9831b4794c16e48298075",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 52840,
"upload_time": "2023-07-26T23:22:16",
"upload_time_iso_8601": "2023-07-26T23:22:16.809830Z",
"url": "https://files.pythonhosted.org/packages/ac/49/225434b0ee4a3ee923f1b89b48a12a9c8257ed63308a1eed61cd827f47a4/reverseshellserver-0.11.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-07-26 23:22:16",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "hansalemaos",
"github_project": "reverseshellserver",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "reverseshellserver"
}
JSON
