Awesome

TeleAria: The Ultimate Telegram-Controlled Aria2 Downloader

TeleAria is a powerful download manager that seamlessly integrates Aria2's robust downloading capabilities with the convenience of Telegram control. Whether you need to download files, torrents, or videos, TeleAria can handle it all with ease. Here are some of the key features:

• Comprehensive Download Support: Download virtually anything, including files, torrents, and videos, with Aria2’s multi-protocol support.
• Telegram Integration: Control your downloads directly from your Telegram app. Start, stop, and manage downloads remotely with simple commands.
• High-Speed Downloads: Enjoy fast and efficient downloading with Aria2's advanced download acceleration.
• User-Friendly Interface: Easy setup and intuitive commands make managing downloads a breeze.
• Real-Time Notifications: Get instant updates on your download status, ensuring you’re always in the loop.
• Smart File Organization: Automatically organize downloaded files into folders based on file type or category.
• Download Scheduling: Schedule downloads to start and stop at specific times for optimal bandwidth usage.
• Bandwidth Limiting: Set limits on download and upload speeds to prioritize network resources.

With TeleAria, downloading has never been easier or more efficient. Perfect for users who demand flexibility and performance in their download management.

Installation

Using npm

First, ensure you have Git installed on your system. Then, you can install TeleAria via npm with the following command:

npm install -g github:besoeasy/telearia

Running TeleAria

To start TeleAria, replace your-telegram-bot-token with your actual Telegram bot token and run:

TELEGRAMBOT=your-telegram-bot-token telearia

Using Docker

You can also run TeleAria using Docker. Replace your-telegram-bot-token with your actual Telegram bot token. Ensure the ~/Downloads directory on the host is mounted to /downloads in the container.

docker run -d \
  --name telearia \
  --restart unless-stopped \
  -p 6600:6600 \
  -p 6800:6800 \
  -p 6881-6888:6881-6888 \
  -v ~/Downloads:/downloads \
  -e TELEGRAMBOT=your-telegram-bot-token \
  ghcr.io/besoeasy/telearia:main

This command does the following:

• -d: Runs the container in detached mode (background).
• --name telearia: Names the container telearia for easy management.
• --restart unless-stopped: Ensures the container restarts automatically unless it is explicitly stopped.
• -p 6600:6600: Maps port 6600 on the host to port 6600 in the container for the server HTTP.
• -p 6800:6800: Maps port 6800 on the host to port 6800 in the container for Aria2 RPC.
• -p 6881-7999:6881-7999: Maps ports 6881-7999 for BitTorrent.
• -e TELEGRAMBOT=your-telegram-bot-token: Sets the environment variable TELEGRAMBOT with your Telegram bot token.
• -v ~/Downloads:/downloads: Mounts the ~/Downloads directory on your host to /downloads inside the container for downloading files.

Pairing with Cloudflare Tunnel

To set up your own self-hosted cloud download manager controlled via Telegram, you can pair TeleAria with a Cloudflare Tunnel.

For more detailed instructions and troubleshooting, visit our GitHub repository.