BRUTALLE 🛠️

brutalle is a Python-based command-line tool designed to feel like a mini hacking toolkit. It’s got some neat functionalities like reverse shell listening, file transfer over SSH, a self-destruct mechanism, and an interactive shell mode — all things that make this script feel a bit more "cyber" while actually being a fun way to learn about network programming, system commands, and Python libraries!

FEATURES ✨

Interactive Shell Mode: Offers a basic shell interface where you can execute commands, use tab to complete filenames and view command history.
Reverse Shell Listener: Sets up a reverse shell listener to accept incoming connections from a remote system.
SSH File Transfer: Securely transfer files to and from a target system over SSH.
Self-Destruct Mechanism: When you're done, use kill to delete the tool and any files created by it, leaving no trace behind.

REQUIREMENTS 📝

Python 3.x
Required Libraries:
- paramiko for SSH connection and file transfer.
- readline or pyreadline3 (for Windows) to enable command history and tab completion.
- shutil, subprocess, and other built-in libraries included with Python.

INSTALLATION 🚀

Clone the repository and navigate to it:

git clone https://github.com/RIZZZIOM/brutalle.git
cd brutalle

For Windows:

Run the setup script to install dependencies:
```
python setup.py
```
Run the tool:
```
python brutalle.py
```

For Linux:

Make the scripts executable and run the setup:
```
chmod +x brutalle.py setup.py
./setup.py
```
Run the main script:
```
./brutalle.py
```

USAGE 📖

Here’s a quick rundown of the available commands, their arguments, and usage examples.

COMMAND	ARGUMENTS	DESCRIPTION	EXAMPLE USAGE
`help`	None	Lists all available commands	`help`
`shell`	None	Starts interactive shell mode	`shell`
`reverse`	port	Starts a reverse shell listener on a port	`reverse 4444`
`put`	target, username	Uploads a file to the target via SSH	`put 192.168.1.10 myusername`
`get`	target, username	Downloads a file from the target via SSH	`get 192.168.1.10 myusername`
`exit`	None	Exits the tool	`exit`
`kill`	None	Executes the self-destruct sequence	`kill`

Note: Make sure SSH login credentials are handy when using put or get, as the script will prompt you for the password.

CONTRIBUTING 🤝

Contributions are welcome! Feel free to fork the repo, make your changes, and submit a pull request. If you’re adding features, please try to include relevant tests, and keep things consistent with the existing style.

LICENSE 📜

This project is licensed under the MIT License. See the LICENSE file for details.

RIZZZIOM/brutalle