SMRS-HANDLER

Simple Multi Reverse Shell Handler (v1.1.0)

Overview

A light, console-based reverse-shell manager and interactive listener written in Python 3. It allows you to accept and manage multiple reverse shell connections, select a client, and interact with it from a single terminal.

Legal & Ethical Notice: This tool can be used for offensive operations. Do not use it against networks, systems, or devices you do not own or for which you do not have explicit, written permission. Use only in your lab, on your machines, or within written scopes of authorized penetration tests.

Downloads

Total Downloads Latest Release

Key Features

  • Listen for multiple reverse shell connections (TCP).
  • Auto-assign incremental client IDs.
  • Interactive console with commands like list, use, helpsh.
  • Per-client output handling.
  • Non-blocking handling via threads and queues.

Requirements

  • Software: Python 3.8+
  • Modules: colorama, pygments
    python3 -m pip install colorama pygments

Workflow

1. Start the listener: python3 smrs.py

2. Run reverse shell payload on target.

3. Handler notifies and auto-selects new connection.

4. Use list to view, use <id> to interact.

5. helpsh for payload templates.

Command List

listList current connections
use <id>Switch to a client
helpshPrint reverse-shell one-liners
clear / clsClear console
exitClose all and exit

Troubleshooting

  • Check IP/Port in payload.
  • Ensure listener host is 0.0.0.0.
  • Verify firewall rules.
  • Use sudo for ports < 1024.

Security

Do not expose this tool on public networks. Run only within isolated lab segments or secure, authorized environments.

MIT License

Copyright (c) 2025 MRITARI

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

View Repository