A Terminal in Telegram!
Telegram is a lovely messenger and has so many features that we can manage our Linux server with those features.
Telminal is a Python package that helps you have your own server assistant Telegram bot. You can use Telminal as a terminal or to download & upload files.
Telminal features
- HTML and image output
- Process state info
- Interactive command support
- Download from server
- Upload to server
- Multi user
- Tasks
You must have a telegram developer API and a bot token
API ID API hash
Bot token
Very fast and easy, you can have those. Just follow these two official links.
sudo apt-get install python3.9 python3.9-dev python3.9-venv
python3.9 -m venv venv
source ./venv/bin/activate
pip install telminal
telminal
sudo apt-get install chromium-chromedriver
sudo apt install -y gconf-service libasound2 libatk1.0-0 libc6 libcairo2 libcups2 libdbus-1-3 libexpat1 libfontconfig1 libgcc1 libgconf-2-4 libgdk-pixbuf2.0-0 libglib2.0-0 libgtk-3-0 libnspr4 libpango-1.0-0 libpangocairo-1.0-0 libstdc++6 libx11-6 libx11-xcb1 libxcb1 libxcomposite1 libxcursor1 libxdamage1 libxext6 libxfixes3 libxi6 libxrandr2 libxrender1 libxss1 libxtst6 ca-certificates fonts-liberation libappindicator1 libnss3 lsb-release xdg-utils wget
setup.mp4
Run telminal
command after installation finished. Telminal needs those Telegram tokens for the first run.
Also, you can create a config.json
file inside the package directory in this format:
{ "api_id": 1234, "api_hash": "abcs", "token": "efgh", "admins": [8888, 9999] }
In this sample config 8888 must be your Telegram user ID.
interactive-mode.mp4
You can activate this mode for the last running process by sending /interactive_mode
or by clicking on the Interactive mode
button of each process.
In interactive mode, you are talking to the process and each message means an input for that process.
Also, a two characters message that starts with ^
has its meaning and behave like a control command so ^c
means CTRL + C
.
To return to normal mode and create a new process just use /normal_mode
or Exit interactive mode
button.
text-version.mp4
Image creation for process result is optimized and will be okay on a server with minimum resources.
However, creating an image on the server is an expensive process. so if you want to run multiple commands at once or have a process that does not require image output, I strongly recommend using the text version by sending \image_off
command.
download-from-server.mp4
You can save any file (up to 2GB) of your server on telegram.
There are two ways to do this :
- Inline query
- !get command
Inline query just works for the current directory and runs a ls -la | grep <your_query>
in the background.
With !get
command you can specify the path of a file manually.
Also, you have a nice progress bar when you are downloading or uploading a heavy file.😎
upload-to-server.mp4
Upload a file on your server just by sending it to Telminal chat.
that file can be in telegram or on your hard disk.
multi-admin-multi-chat.mp4
Fortunately, all features can be used in a group too. by default, Telminal only responds to your commands.
!trust
and !untrust
are two commands that manage user permission.
just reply to one of the user's messages with these commands.
tasks.mp4
At this moment, there is only one type of task.
A watcher
task downloads a file periodically. write your first watcher in the following format:
!watch <number><s,m,h> <file_path>
Some real examples :
1️⃣ get telminal.log
every 50 seconds
👉 !watch 50s telminal.log
2️⃣ get temp.png
every 5 minutes
👉 !watch 5m home/temp.png
3️⃣ get sql.dump
every 24 hours
👉 !watch 24h /backups/sql.dump
Finally set Telminal commands in Botfather using this text.
image_off - Just text output image_on - Text and image output tasks - List of active tasks interacive_mode - Interact with last process normal_mode - Process creation mode