Metadata-Version: 2.1
Name: ssh-telegram-manager
Version: 1.0.0
Summary: Python app to launch sshd server from Telegram
License: GPL-3
Author: turulomio
Author-email: turulomio@yahoo.es
Requires-Python: >=3.8,<4.0
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: python-telegram-bot (>=21.4)
Description-Content-Type: text/markdown

# SSH Telegram Manager
SSH Telegram Manager is a Telegram bot to launch ssh on demand. With this tool, you can avoid to expose your ssh port permanently on Internet.

![Screenshot of a working SSH Telegram Manager bot](https://github.com/turulomio/ssh_telegram_manager/blob/main/doc/telegram_bot.png)

## Installation

You can use pip `pip install ssh_telegram_manager`

- Get your Telegram Bot token. This is a way to get it https://www.siteguarding.com/en/how-to-get-telegram-bot-api-token
- Copy `https://github.com/turulomio/ssh_telegram_manager/blob/main/etc/ssh_telegram_manager/ssh_telegram_manager.default` to your `/etc/ssh_telegram_manager/ssh_telegram_manager`
- Just run `ssh_telegram_manager`. 
- When ssh_telegram_manager is working fine, disable ssh daemon from start with `systemctl disable ssh` to hide your ssh port on Internet
- You must use \ssh_start to launch ssh on your Telegram Bot. After 1 minute(you can change in settings) it will be closed.


## Changelog
### 1.0.0 (2024-07-14)
- Updated dependencies
- Removed innecesary code

### 0.6.0 (2023-12-02)
- Migrated setup.py to pyproject.toml with poetry.

### 0.5.0 (2023-01-28)
- Upgraded code to python-telegram-bot-20.0 api

### 0.4.0 (2022-10-22)
- Fixed bug when system time is not set correctly
- Added `ssh_telegram_manager.service` for systemd systems
- Improved spanish translation

### 0.3.0 (2022-08-17)
- Now waits for Internet before connecting to Telegram to avoid errors

### 0.1.1 (2022-08-13)
- Basic functionality

