BlackMamba - C2/post-exploitation Framework

BlackMamba is a multi client C2/post exploitation framework with some spyware features. Powered by Python 3.8.6 and QT Framework.

Some of BlackMamba features are:

  • Multi Client - Supports multiple client connections at the same time.
  • Real Time Communication Updates - Real time communication and updates between the client and server.
  • Encrypted Communication - Almost all communications are encrypt, with exception of screen video streaming.
  • Screenshot Gattering - Get a realtime screenshot from the client.
  • Video Streaming - Watch in real time the client screen.
  • Client Lock - Lock and unlock the machine of the client.
  • Encrypted File Transfer (upload/download) - Download files from the client or uploads files for the client.
  • Keylogger - Register all the keys pressed by client.
  • Web Downloader - Download files from URLs or content by RAW pages.

Install Guide


1º - Download the BlackMamba;

2º - Install the PIP packages;


3º - Open the port 65000 and 65005 in your Gateway or Router (the port number is optional);

4º - Create an exception in firewall for BlackMamba or disable it;

5ª - Go to "BlackMamba/bin/profile/socket.txt" and input the port number opened;


IMPORTANT: Do not change the

6º (OPTIONAL) - Go to BlackMamba folder and open the "" file. Copy the result key and paste in the "BlackMamba/bin/profile/" ;

The BlackMamba use a default cryptography key, is interesting that you change it.

7º - Back to BlackMamba root folder and open the "" file;


sudo chmod 777
sudo python3.8

(sudo chmod 777
(sudo python3

8º - Click on the button that have a person icon and plus signal;

9º - Input the path where the Python file will be created, input the both port numbers and the IP address (external or local) of your host, then click on the "Create" button.


After create the Client script you'll need to open the script in the host target:




1º Download the packages:

scrot -y
python3-pip -y
python3-tk -y
python3-dev -y

2º sudo python3.8

(sudo python3

IMPORTANT: The script of client not have persistence, if you want to do a persistence you'll need to made by yourself. Another important point is that the client script maybe delay some seconds or few minutes for connect/reconnect.

Release status

Currently the BlackMamba is on beta stage, this means that the features are all completed but likely to contain a number of known and unknown bugs. Is important reinforce that the majority of critical bugs like crashes or buffer overflow alredy have been solved.

More information

For more information please take a look in the Wiki.

Call for Contributions

I'm just one person developing the BlackMamba, if anyone finds this tool useful and would like to add some functionality, improve the code performace or improve something in the BlackMamba the best way to get it added is to submit a pull request.

If you want to collaborate but you don't know Python you can help me so much with bug reports, you can do it with Issues :)


Gustavo (Loseys)

Acknowledgments, Contributors & Involuntary Contributors

(In no particular order)

BlackMamba - C2/post-exploitation Framework BlackMamba - C2/post-exploitation Framework Reviewed by Zion3R on 5:30 PM Rating: 5