mirror-leech-telegram-bot  by anasty17

Telegram bot for mirroring/leeching files to cloud storage

Created 4 years ago
3,925 stars

Top 12.4% on SourcePulse

GitHubView on GitHub
Project Summary

This Telegram bot is designed for efficient file mirroring and leeching from various sources like direct links, torrents, Google Drive, and cloud storage to destinations including Google Drive, Telegram, or rclone-supported clouds. It targets users who need a versatile and automated solution for file transfers and management via a Telegram interface.

How It Works

The bot leverages asynchronous Python programming to handle multiple file transfer operations concurrently. It integrates with download clients like qBittorrent, Aria2c, and Sabnzbd, and cloud storage providers via rclone and Google Drive APIs. Key features include file selection during torrent downloads, configurable seeding ratios/times, and flexible upload options like split sizes, thumbnails, and custom filenames.

Quick Start & Requirements

  • Installation: Clone the repository (git clone https://github.com/anasty17/mirror-leech-telegram-bot mirrorbot/ && cd mirrorbot), install dependencies (pip3 install -r requirements-cli.txt), and configure config.py.
  • Prerequisites: Python 3, pip, Docker (recommended for deployment), MongoDB for database storage. Telegram API credentials (APP_ID, APP_HASH), Bot Token, Owner ID are mandatory.
  • Deployment: Docker image can be built (sudo docker build . -t mltb) and run (sudo docker run --network host mltb), or via docker compose up.
  • Documentation: Official Docs

Highlighted Details

  • Supports a wide array of download clients (qBittorrent, Aria2c, Sabnzbd) and upload destinations (Google Drive, rclone-supported clouds, Telegram).
  • Advanced file management for torrents, including pre-download file selection and seeding controls.
  • Extensive customization for Telegram uploads: split sizes, document/media format, custom prefixes, and media group uploads.
  • Google Drive integration includes download, upload, clone, delete, count, and search functionalities, with support for Service Accounts to bypass rate limits.
  • Rclone integration allows server-side transfers and flexible path selection.
  • Built-in queueing system for managing concurrent downloads and uploads.
  • Torrent search API integration with support for multiple torrent sites.
  • RSS feed monitoring with title filters and real-time editing.

Maintenance & Community

Licensing & Compatibility

  • License: The README does not explicitly state a license. Compatibility for commercial use or closed-source linking is not specified.

Limitations & Caveats

  • The README does not specify a license, which may impact commercial use or integration into closed-source projects.
  • Generating token.pickle for Google Drive requires a local browser environment, which might be a hurdle for server-only deployments.
Health Check
Last Commit

1 week ago

Responsiveness

1 day

Pull Requests (30d)
3
Issues (30d)
0
Star History
53 stars in the last 30 days

Explore Similar Projects

Starred by Patrick von Platen Patrick von Platen(Author of Hugging Face Diffusers; Research Engineer at Mistral) and Jeff Hammerbacher Jeff Hammerbacher(Cofounder of Cloudera).

client-python by mistralai

0.3%
662
Python SDK for Mistral AI platform
Created 1 year ago
Updated 5 days ago
Feedback? Help us improve.