https://github.com/fnzv/trsh

Telegram Remote-Shell
https://github.com/fnzv/trsh

linux shell sysadmin telegram telegram-api telepot

Last synced: about 1 month ago
JSON representation

Telegram Remote-Shell

• Host: GitHub
• URL: https://github.com/fnzv/trsh
• Owner: fnzv
• License: mit
• Created: 2017-04-23T10:56:07.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2023-10-20T13:27:10.000Z (about 1 year ago)
• Last Synced: 2024-11-07T18:46:46.291Z (about 1 month ago)
• Topics: linux, shell, sysadmin, telegram, telegram-api, telepot
• Language: Python
• Size: 104 KB
• Stars: 68
• Watchers: 10
• Forks: 29
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-hacking-lists - fnzv/trsh - Telegram Remote-Shell (Python)

README

        
## TRSH

Telegram Remote-Shell is a python script that allows to comunicate to your Linux server via Telegram API (with bots). 

UPDATE:

Hey, there is a remake in go of the same Python script in Golang [here](https://github.com/fnzv/trsh-go)

-----------------

![Telegram](/img/telegrambot-img.jpg?raw=true "Telegram")

 


 -------------------------------

## Requirements

- Linux System

- Bot created from @BotFather via Telegram

- Software Packages: python-pip (to install telepot) & basic linux tools like nmap,dig,mtr (optional)

## Installation

The setup is quite easy: 


* Chat with BotFather to create a Bot ( https://telegram.me/botfather ), just launch the command /newbot to get your Telegram Token. 


 Open the bot chat and send some messages to activate the bot. 


* Launch this command on your Linux system: 


```

cd /home && git clone https://github.com/fnzv/trsh.git && cd trsh && bash install.sh 

```

##### WARNING: this command will install the required/missing packages ( supervisor, dnsutils, python-pip, python, nmap, mtr, pip-telepot )

##### NOTES:

- You will be asked to insert your Telegram Bot Token aquired on the first step. 


- The script will guess your Sender-id based on the messages you send on the first step. 


- 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 


After you finished the installation the python script will run as a system service with supervisor.

## Usage

- /ping - Tests connectivity 

- /dig - Resolve the given domain, supports RR.. example /dig A google.com or /dig MX google.com

- /mtr - Execute a mtr with a following report

- /nmap - Execute a nmap -Pn -A

- /curl - Execute a curl request

- /whois - Whois lookup

- /sysinfo - Display generic system information (disk usage, network & memory)

- /sh - Execute a command with Bash.. example /sh cat namefile , /sh ps auxf | grep ssh

## Tests

The following scripts are being tested on Ubuntu 16.04 LTS, Raspian Jessie and marked as working.

## Contributors

Feel free to open issues or send me an email

## License

Code distributed under MIT licence.