Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Shell remote control from telegram

Description of the ShellRemoteBot

Helps you work with your server (or remote computer) via telegram bot emulating terminal operations (sh for Linux and cmd for Windows) and a file manager functionality.

It is possible to work in the terminal from under any user in OS. You can configure access to several telegram users or only for You.

The program can run as a regular console program or run as a daemon/service.

Tested in Linux but You can try to use in other OS also. Developed with FreePascal. It depends on fp-telegram lib .

Script files (macros)

You can specify predefined shell scripts. Create script file with extention .script in the same folder where INI file is located. Get the script menu by command /scripts. Click the selected script.

File manager

You can call the file manager by /dir command then select directory inline button (select another folder) or file inline button (select the file to download).

You can set the default value in the configuration file (DefaultDir in [File] section)


  1. Create bot . You must select (keep default) longpolling method for getting updates.
  2. Create config ini file tgshd.ini in app folder:
;; Specify Your token
;; Actual if telegram server is blocked in server/computer region
;; Timeout for lognpolling requests while getting updates

;; Specify all admin users (Telegram UserID [Integer]). For example: 
;; where 'a' character is means administrator, 'b' - banned
;; If You can want to use HTTP proxy please use tgsynapsehttpclientbroker

;; You can specify directory for script file folder. Default value equal configuration file directory

;; You can specify default initial directory path for file manager called by /dir command
  1. Run as a console program or daemon/service.

DEB package

You can easily install using a .deb file on Debian/Ubuntu/etc. Download deb package from release section Then install for example:

sudo dpkg --install tgsh_1.2-1_amd64.deb
# After package installation set up at least token and admin user id in the INI file located at /etc/tgshd/tgshd.ini
# for example with Nano editor
sudo nano /etc/tgshd/tgshd.ini
# Now You can run /usr/bin/tgshd -r
# Or is better enable and run as a daemon (service file for systemd inlcluded in the DEB package)
systemctl enable tgshd
systemctl start tgshd

Users rights and telegram user ID

You can define user access in configuration file tgshd.ini by adding string like user_id=a where user_id is telegram user id of administrator. You can add more than one administrator. If any simple telegram user sends any message, command etc to the bot then the bot will reply You cannot access to this bot!. if You add a line user_id=b then user will banned and the bot will not respond anything

There are some ways to determine your user_id but You can simply send /myid to @HelloLazarusBot chat

Telegram bot commands


Reads messages from the shell console. Sometimes the program does not wait for a response immediately after execution in the console, and in this case, you can read the newly appeared messages by the /read command.

/sig and /sigXXXX

It is worked under Unix systems. You can send POSIX signal to terminal. For example, /sig 9 where 9 is kill sig number or You can send commands /sigint, /sigkill, /sigquit and /sigterm.


Calls the menu for executing the prepared script from the list of files. Scripts must located in the same folder where the INI file is located, or you can set the folder in the settings in the the [Scripts] section / Directory


Calls the file Manager. You can set the default value in the configuration file

HTTP proxy

If you want to add HTTP proxy support, then:

  • add laz_synapse.lpk depending on the project
  • add tgsynapsehttpclientbroker to the uses block
  • set the proxy data in the INI file. Note: The native FPHTTPClient does not yet have full HTTPS proxy support. So in the case of synapse HTTP client, to make the HTTPs proxy work in Linux (laz_synapse.lpk v40.1), comment out the line in the blcksock.pas source unit of the synapse library. // Port := IntToStr(ResolvePort(Port));