A Terminal in Telegram!
There is a lovely messenger in the world that 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 need telegram developer API and a bot token
API ID API hash
Bot token
Very fast and easy you can have those, just follow this two official links.
pip install telminal
setup.mp4
Run telminal
command after installation finished. Telminal needs those Telegram tokens for 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 last running process by sending /interactive_mode
or by clicking on 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 starts with ^
has own meaning and behave like a control command so ^c
means CTRL + C
.
To return to normal mode and creating 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 current directory and runs a ls -la | grep <your_query>
in background.
With !get
command you can specify 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 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 a 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