# GoTelegram v2.2 Bot

Production-quality Telegram bot for managing MTProxy (telemt engine) on Linux servers.

## Features

- **Complete CLI Feature Parity** - All menu items from CLI version
  - Install (Quick/Stealth modes)
  - Status monitoring
  - Proxy link generation
  - Share with QR codes
  - Service restart
  - Logs viewing
  - Mode/template changes
  - Backup/restore
  - telemt updates
  - Website/SSL management
  - Remove installation
  - Promotional links

- **Template Browsing** - Browse categories → templates → preview → install
- **V1 Migration** - Detects old mtg Docker container and offers migration
- **Access Control** - ALLOWED_IDS from .env
- **Async/Await** - Full async support via python-telegram-bot v21+
- **Inline Keyboards** - Modern UI with callback-based navigation
- **Shell Integration** - Executes system commands via asyncio subprocess
- **Error Handling** - Production-ready error handling

## Installation

### Prerequisites

- Python 3.8+
- Linux system with systemd
- telemt installed and running
- Telegram Bot Token from @BotFather

### Setup

1. Install dependencies:
```bash
pip install -r requirements.txt
```

2. Create .env file:
```bash
cp config.example.env .env
# Edit .env and set your BOT_TOKEN
nano .env
```

3. (Optional) Restrict access to specific users:
```bash
# Edit .env and uncomment ALLOWED_IDS
# ALLOWED_IDS=123456789,987654321
```

### Running the Bot

```bash
python3 bot.py
```

For systemd service:

```bash
[Unit]
Description=GoTelegram Bot
After=network.target

[Service]
Type=simple
User=gotelegram
WorkingDirectory=/opt/gotelegram/bot
ExecStart=/usr/bin/python3 /opt/gotelegram/bot/bot.py
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target
```

## Configuration

### .env Variables

- `BOT_TOKEN` - Telegram bot token (required)
- `ALLOWED_IDS` - Comma-separated user IDs (optional, all users allowed if empty)

### System Paths

- `GOTELEGRAM_CONFIG` - `/opt/gotelegram/config.json`
- `TELEMT_CONFIG` - `/etc/telemt/config.toml`
- `TELEMT_SERVICE` - `telemt` (systemd service name)
- `WEBSITE_ROOT` - `/var/www/gotelegram-site`
- `BACKUP_DIR` - `/opt/gotelegram/backups`
- `TEMPLATES_CATALOG` - `/opt/gotelegram/templates_catalog.json`

## Architecture

### Single File Design
All functionality in one `bot.py` for simplicity and ease of deployment.

### Command Handlers
- `/start` - Main menu
- `/help` - Help text
- `/status` - Quick status
- `/logs` - Recent logs

### Callback Handlers
Organized by feature:
- Installation (quick/stealth modes)
- Status monitoring
- Backup/restore
- SSL management
- Updates
- Removal

### Shell Integration
Async subprocess wrapper:
```python
code, stdout, stderr = await sh("command", "arg1", "arg2")
```

## Callback Data Convention

- `menu_*` - Menu items
- `install_mode_*` - Install options
- `quick_dom_*` - Domain selection
- `stealth_cat_*` - Template categories
- `stealth_tpl_*` - Template selection
- `stealth_confirm_*` - Confirm installation
- `backup_*` - Backup operations
- `ssl_*` - SSL operations
- `restore_backup_*` - Restore operations

## Credits

- **telemt** - MTProxy engine foundation
- **HTML5UP** - Beautiful web templates
- **Learning Zone** - Educational resources
- **Start Bootstrap** - Bootstrap framework
- **Community** - Your feedback and support

## License

GoTelegram v2.2 - Open source community project