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

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]
}

⚠️ First admin can manage other admins, so order of admins list matter.
In this sample config 8888 must be your Telegram user ID.

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.

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.

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 a file on your server just by sending it to Telminal chat.
that file can be in telegram or on your hard disk.

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.

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

pexpect
Telethon
xterm.js
puppeteer