⚠️ Stability Notice: The project is currently in a large refactor phase. During this period, behavior may be unstable and breaking changes can happen between updates until the refactor is completed.

🌟 Features

☁️ Rclone

• Copy file/folder from cloud to cloud
• Leech file/folder from cloud to Telegram
• Mirror Link/Torrent/Magnets/Mega/Telegram-Files to cloud
• Mirror from Telegram to multiple clouds at the same time
• Telegram Navigation Button Menus to interact with cloud
• File Manager: size, mkdir, delete, dedupe and rename
• Service Accounts support with automatic switching
• Create cloud index as http or webdav webserver
• Sync between clouds (not folders)
• Search files on cloud
• Clean cloud trash
• View cloud storage info

🔧 Core Features

📦 Additional Features

• Send rclone config file from bot
• Renaming menu for Telegram files
• Index support (rclone index for all remotes)
• Search TMDB titles
• Mirror and Leech files in batch from Telegram private/restricted channels
• Mirror and Leech links in batch from .txt file
• Extract and zip link/file from Telegram to cloud
• Extract and zip folder/file from cloud to Telegram
• Mirror to local host (no cloud upload)
• Refactored to use Pyrogram with asyncio
• Docker-based image (Ubuntu)
• Compatible with Linux amd64, arm64/v8, arm/v7

🤖 Bot Commands

Set these commands through @BotFather.

📥 Mirror Commands

📤 Leech Commands

☁️ Cloud Management

⚙️ System & Tools

📊 Status & Info

🔧 Admin Commands

🚀 Deployment

1️⃣ Installing Requirements

Clone the repository:

git clone https://github.com/Sam-Max/rcmltb rcmltb/ && cd rcmltb

For Debian-based distros:

sudo apt install python3 python3-pip

Install Docker by following the official Docker docs

For Arch and derivatives:

sudo pacman -S docker python

Install dependencies for setup scripts:

pip3 install -r requirements-cli.txt

2️⃣ Configuration

Copy the sample config file:

cp sample_config.env config.env

NOTE: All values must be filled between quotes, even if it's Int, Bool, or List.

Required Configuration

Optional Configuration

General Settings

Update Settings

NOTE: If docker or requirements change, rebuild the image for changes to apply.

☁️ Rclone Settings

Template Variables: {username}, {user_id}, {date}, {year}, {month}, {day}, {category}, {task_type}

📁 Google Drive Settings

Note: Add token.pickle to root for cloning. Use /files command to add via bot.

📤 Leech Settings

☁️ MEGA Settings

⬇️ JDownloader Settings

📊 Queue System Settings

🌐 qBittorrent/Aria2c Settings

qBittorrent Note: For RAM issues, limit MaxConnecs, decrease AsyncIOThreadsCount, and set DiskWriteCacheSize to 32.

🔍 Torrent Search Settings

3️⃣ Deploying with Docker

Build Docker image:

sudo docker build . -t rcmltb

Run the image:

sudo docker run -p 80:80 -p 8080:8080 rcmltb

Stop container:

sudo docker ps
sudo docker stop <container_id>

Clear container:

sudo docker container prune

Delete images:

sudo docker image prune -a

4️⃣ Deploying with Docker Compose

NOTE: Change ports in docker-compose.yml if not using 80 (torrents) or 8080 (rclone).

Install docker-compose:

sudo apt install docker-compose

Build and run:

sudo docker-compose up

After editing files:

sudo docker-compose up --build

Stop/Start:

sudo docker-compose stop
sudo docker-compose start

🔐 Session Generation

To generate USER_SESSION_STRING:

python3 session_generator.py

Run this on your PC from the repository folder.

🗄️ MongoDB Setup

Local MongoDB with Docker Compose (No Auth)

docker-compose.yml includes a local mongo service with persistent storage.

1. Set DATABASE_URL in config.env:

DATABASE_URL="mongodb://mongo:27017/rcmltb"

2. Start services:

docker compose up -d

3. Verify both containers:

docker compose ps

MongoDB data persists in the mongo_data volume.

MongoDB Atlas (Cloud)

1. Go to mongodb.com and sign up
2. Create a Shared Cluster (Free)
3. Add username and password, click Add my current IP Address
4. Click Connect → Connect your application
5. Choose Driver: Python, Version: 3.6 or later
6. Copy the connection string, replace <password> with your user's password
7. Go to Network Access, click Edit → Allow access from anywhere → Confirm

☁️ Rclone Configuration

Video Tutorial: YouTube Guide

Quick Tips:

• Add at least two accounts in rclone.conf for cloud-to-cloud copy
• Android users: Use RCX app

Supported Providers:

1Fichier, Amazon Drive, Amazon S3, Backblaze B2, Box, Ceph, DigitalOcean Spaces, Dreamhost, Dropbox, Enterprise File Fabric, FTP, GetSky, Google Cloud Storage, Google Drive, Google Photos, HDFS, HTTP, Hubic, IBM COS S3, Koofr, Mail.ru Cloud, Mega, Microsoft Azure Blob Storage, Microsoft OneDrive, Nextcloud, OVH, OpenDrive, Oracle Cloud Storage, ownCloud, pCloud, premiumize.me, put.io, Scaleway, Seafile, SFTP, WebDAV, Yandex Disk, and more.

View all providers

🔑 Google OAuth Setup

Requirements: OS with a browser. Windows users need Python3 and pip.

1. Visit Google Cloud Console
2. Go to OAuth Consent tab, fill it, save
3. Credentials tab → Create Credentials → OAuth Client ID
4. Choose Desktop and Create
5. Publish your OAuth consent to prevent token expiry
6. Download credentials, move to bot root, rename to credentials.json
7. Visit Google API Library
8. Search and enable Google Drive API
9. Generate token:

pip3 install google-api-python-client google-auth-httplib2 google-auth-oauthlib
python3 generate_drive_token.py

🌱 Bittorrent Seeding

Using -d alone uses global options for aria2c/qBittorrent.

qBittorrent Global Options:

• GlobalMaxRatio and GlobalMaxSeedingMinutes in qbittorrent.conf
• -1 = no limit
• Don't change MaxRatioAction

🔧 Service Accounts (Google Drive)

Set USE_SERVICE_ACCOUNTS="True" to enable. Recommended for Team Drive only.

Limits

• 1 Service Account = ~750 GB/day
• 1 Project = 100 Service Accounts = ~75 TB/day

Generate Service Accounts

List projects:

python3 gen_sa_accounts.py --list-projects

Enable services:

python3 gen_sa_accounts.py --enable-services $PROJECTID

Create Service Accounts:

python3 gen_sa_accounts.py --create-sas $PROJECTID

Download keys:

python3 gen_sa_accounts.py --download-keys $PROJECTID

Quick setup (new project):

python3 gen_sa_accounts.py --quick-setup 1 --new-only

Add to Team Drive

Method 1: Via Google Group (Recommended)

cd accounts
# Extract emails
grep -oPh '"client_email": "\K[^"]+' *.json > emails.txt
cd ..
# Add emails.txt to Google Group, then add Group to Team Drive as Manager

Method 2: Direct add:

python3 add_to_team_drive.py -d SharedTeamDriveSrcID

🔐 .netrc Authentication

For yt-dlp premium accounts or protected Index Links, create .netrc:

machine host login username password my_password

Example:

machine instagram login user.name password mypassword

Notes:

• Instagram: Must login even for public posts; confirm login from new IP
• YouTube: Use cookies.txt instead

Aria2c index link example:

machine example.workers.dev password index_password

☕ Support