https://github.com/shchuko/tg-shell-bot
Run shell commands remotely with Telegram bot
https://github.com/shchuko/tg-shell-bot
kotlin shell telegram telegram-bot
Last synced: about 2 months ago
JSON representation
Run shell commands remotely with Telegram bot
- Host: GitHub
- URL: https://github.com/shchuko/tg-shell-bot
- Owner: shchuko
- License: apache-2.0
- Created: 2022-08-25T01:15:28.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2022-08-26T06:35:04.000Z (almost 4 years ago)
- Last Synced: 2025-04-04T07:43:29.283Z (about 1 year ago)
- Topics: kotlin, shell, telegram, telegram-bot
- Language: Kotlin
- Homepage:
- Size: 74.2 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# tg-shell-bot - Run shell commands remotely with Telegram bot
The bot allows to execute commands on remote machine it is deployed.
Features:
- you can filter the users who can access the bot
- process output (stderr & stdout) is auto-updated and displayed by bot
- multiple processes can run in parallel
- running processes can be terminated with button (use case: start ngrok, use it, terminate when all's done)
---
Configuration file is expected to present as `$HOME/.config/tg-shell-bot/config.property` and contain:
```properties
telegram.api.key=0000000000:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
telegram.users.allowed=foobar,foobaz
shell.path=/bin/bash
```
You can specify custom config path or override properties with commandline arguments:
```bash
./tg-shell-bot -config "$CONFIG_PATH" -allowedUsers "user0,user1,user2" -shellPath "/bin/sh"
```
---
