{"id":13611279,"url":"https://github.com/fnzv/trsh","last_synced_at":"2025-05-01T19:30:29.228Z","repository":{"id":107778145,"uuid":"89135231","full_name":"fnzv/trsh","owner":"fnzv","description":"Telegram Remote-Shell","archived":false,"fork":false,"pushed_at":"2023-10-20T13:27:10.000Z","size":107,"stargazers_count":69,"open_issues_count":2,"forks_count":27,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-04-06T17:05:14.094Z","etag":null,"topics":["linux","shell","sysadmin","telegram","telegram-api","telepot"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fnzv.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}},"created_at":"2017-04-23T10:56:07.000Z","updated_at":"2025-03-16T09:47:36.000Z","dependencies_parsed_at":"2023-07-06T11:31:23.746Z","dependency_job_id":null,"html_url":"https://github.com/fnzv/trsh","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fnzv%2Ftrsh","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fnzv%2Ftrsh/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fnzv%2Ftrsh/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fnzv%2Ftrsh/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fnzv","download_url":"https://codeload.github.com/fnzv/trsh/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251932532,"owners_count":21667159,"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":["linux","shell","sysadmin","telegram","telegram-api","telepot"],"created_at":"2024-08-01T19:01:53.697Z","updated_at":"2025-05-01T19:30:28.924Z","avatar_url":"https://github.com/fnzv.png","language":"Python","readme":"## TRSH\n\nTelegram Remote-Shell is a python script that allows to comunicate to your Linux server via Telegram API (with bots). \n\nUPDATE:\nHey, there is a remake in go of the same Python script in Golang [here](https://github.com/fnzv/trsh-go)\n\n-----------------\n![Telegram](/img/telegrambot-img.jpg?raw=true \"Telegram\")\n \u003cbr\u003e\n -------------------------------\n## Requirements\n- Linux System\n- Bot created from @BotFather via Telegram\n- Software Packages: python-pip (to install telepot) \u0026 basic linux tools like nmap,dig,mtr (optional)\n\n## Installation\n\nThe setup is quite easy: \u003cbr\u003e\n\n* Chat with BotFather to create a Bot ( https://telegram.me/botfather ), just launch the command /newbot to get your Telegram Token. \u003cbr\u003e\n Open the bot chat and send some messages to activate the bot. \u003cbr\u003e\n\n* Launch this command on your Linux system: \u003cbr\u003e\n\n```\ncd /home \u0026\u0026 git clone https://github.com/fnzv/trsh.git \u0026\u0026 cd trsh \u0026\u0026 bash install.sh \n```\n\n##### WARNING: this command will install the required/missing packages ( supervisor, dnsutils, python-pip, python, nmap, mtr, pip-telepot )\n\n##### NOTES:\n\n- You will be asked to insert your Telegram Bot Token aquired on the first step. \u003cbr\u003e\n\n- The script will guess your Sender-id based on the messages you send on the first step. \u003cbr\u003e\n\n- If you cannot figure out how to find your Sender-id manually launch the script get-sender-id.py from commandline and you will get a raw output containing chat_id,sender_id,username,type \u003cbr\u003e\n\nAfter you finished the installation the python script will run as a system service with supervisor.\n\n## Usage\n\n- /ping - Tests connectivity \n- /dig - Resolve the given domain, supports RR.. example /dig A google.com or /dig MX google.com\n- /mtr - Execute a mtr with a following report\n- /nmap - Execute a nmap -Pn -A\n- /curl - Execute a curl request\n- /whois - Whois lookup\n- /sysinfo - Display generic system information (disk usage, network \u0026 memory)\n- /sh - Execute a command with Bash.. example /sh cat namefile , /sh ps auxf | grep ssh\n\n## Tests\n\nThe following scripts are being tested on Ubuntu 16.04 LTS, Raspian Jessie and marked as working.\n\n## Contributors\n\nFeel free to open issues or send me an email\n\n## License\n\nCode distributed under MIT licence.\n\n","funding_links":[],"categories":["Python","Python (1887)"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffnzv%2Ftrsh","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffnzv%2Ftrsh","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffnzv%2Ftrsh/lists"}