Home Download Manager Bot

A simple Telegram bot for managing downloads on your home server via Aria2 RPC. Prebuilt image - sparshbajaj14/telegram-bot:latest

Features

• Torrent/Magnet link handling
• Download progress tracking
• Casa OS optimized deployment
• Local network integration
• Family-friendly access controls

Home Server Setup

graph TD
    A[Install Docker] --> B[Configure .env]
    B --> C[Start Containers]
    C --> D[Access via Telegram]
    
    C -->|Backups| C1[Local NAS]
    C -->|Monitoring| C2[Casa OS UI]

Loading

Getting Started

Prerequisites

• Docker & Docker Compose
• Telegram API credentials
• Aria2 RPC server

Docker Deployment

Using Pre-built Image (Recommended):

mkdir telegram-bot && cd telegram-bot
curl -O https://raw.githubusercontent.com/sparshbajaj/telegram-bot/main/docker-compose.yml
curl -O https://raw.githubusercontent.com/sparshbajaj/telegram-bot/main/.env.example

# Rename env file and edit credentials
cp .env.example .env
nano .env

# Start containers
docker-compose up -d

Build from Source:

git clone https://github.com/sparshbajaj/telegram-bot.git
cd telegram-bot

# Set up environment
cp .env.example .env
nano .env  # Add your credentials

# Build and run
docker-compose up --build -d

Environment Variables

Variable	Required	Description
BOT_TOKEN	Yes	Telegram bot token
ARIA2_RPC_URL	Yes	Aria2 RPC endpoint
ARIA2_RPC_SECRET	Yes	Aria2 RPC secret
TELEGRAM_API_ID	Yes	Telegram API ID
TELEGRAM_API_HASH	Yes	Telegram API Hash

Monitoring

View logs:

docker-compose logs -f

Check status:

docker-compose ps

CI/CD Pipeline

Automatically builds and pushes Docker images to: Docker Hub

Images are tagged with:

• latest - Most recent stable build
• Commit SHA - Specific version builds

Contributing

1. Fork the repository
2. Create feature branch
3. Submit PR with detailed description

Security Notice: Never commit sensitive information in configuration files