https://github.com/besoeasy/telearia
TeleAria: Telegram-Controlled Cloud Downloader
https://github.com/besoeasy/telearia
aria aria2 aria2c cloud cloud-downloads download downloader jellyfin motrix plex putio seedr seedr-cc stremio stremio-addon telegram
Last synced: 4 months ago
JSON representation
TeleAria: Telegram-Controlled Cloud Downloader
- Host: GitHub
- URL: https://github.com/besoeasy/telearia
- Owner: besoeasy
- Created: 2023-11-08T01:32:49.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-06-15T07:51:59.000Z (4 months ago)
- Last Synced: 2025-06-17T06:03:20.016Z (4 months ago)
- Topics: aria, aria2, aria2c, cloud, cloud-downloads, download, downloader, jellyfin, motrix, plex, putio, seedr, seedr-cc, stremio, stremio-addon, telegram
- Language: JavaScript
- Homepage: https://github.com/besoeasy/telearia
- Size: 299 KB
- Stars: 30
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# TeleAria: Telegram-Controlled Cloud Downloader
TeleAria is a lightweight, self-hosted solution that combines the power of [Aria2](https://aria2.github.io/) and [Telegram](https://telegram.org/) to enable remote downloading of files, torrents, and videos. With real-time updates, bandwidth controls, and seamless sharing via HTTP and Samba (SMB), TeleAria makes it easy to manage and access your downloads from any device.
## Features
- Download files, torrents, and videos via Telegram bot commands
- High-speed, concurrent downloads powered by Aria2
- Real-time progress and status updates in Telegram
- Auto-sorted downloads for easy organization
- Bandwidth and scheduling controls
- Downloads shared via HTTP and Samba (SMB)
## Quick Start (Docker)
```bash
docker run -d \
--name telearia \
--restart unless-stopped \
-p 6799:6799 \
-p 445:445 \
-e TELEGRAMBOT=Your-Telegram-Bot-Token \
ghcr.io/besoeasy/telearia:main
```
- **Restrict access:** `-e WHITE_LIST_USER=123456,654321`
- **Mount downloads:** `-v /tmp/telearia:/tmp/telearia`
## Testing Version
```bash
podman run -d \
--name telearia \
--restart unless-stopped \
-p 6799:6799 \
-p 6800:445 \
-e TELEGRAMBOT=Your-Telegram-Bot-Token \
ghcr.io/besoeasy/telearia:test
```
## Accessing Downloads
- **HTTP:** Open `http://:6799/` in your browser to browse and download files.
- **Samba (SMB) Share:**
- Connect to the SMB share from VLC, NOVA Video Player (Android TV), Linux, Windows, or iOS file managers.
- Network path: `smb:///telearia` (adjust as needed for your setup)
## Optional: Tunneling
Expose your TeleAria instance securely over the internet using Cloudflare Tunnel or Serveo:
- **Cloudflare Tunnel:** [Cloudflare Tunnel Documentation](https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/)
- **Serveo Example:**
```bash
ssh -R 80:localhost:6799 serveo.net
```