WZML-X

Telegram mirroring and leeching platform with a container-based runtime, a lightweight web UI, and a configurable transfer pipeline.

Index

Table of Contents Click Here

• At a Glance
• Why Use It
• What It Covers
• How It Runs
• Deployment
• Configuration
• Project Layout
• Documentation
• Support
• Credits
• License

At a Glance

Area	Details
Runtime	Python Telegram bot + web UI
Deployment	Docker & Docker Compose
Required config	BOT_TOKEN, TELEGRAM_API, TELEGRAM_HASH, OWNER_ID, DATABASE_URL
Port controls	BASE_URL_PORT, RCLONE_SERVE_PORT
License	LICENSE

Why Use It

WZML-X is built for users who want a single bot stack that can mirror, leech, manage files, and expose a simple web-based selection flow without stitching together multiple tools. The README focuses on what you need to deploy it quickly, understand the moving parts, and tune the behavior safely.

What It Covers

Capability	Outcome
Mirroring	Send files to Telegram with a controllable pipeline
Leeching	Deliver files in the format you prefer, including document and media workflows
File selection UI	Review and select torrent / NZB / upload contents before finalizing
Multi-source downloads	Use qBittorrent, Aria2, JDownloader, Mega, NZB, and yt-dlp integrations
Storage and upload paths	Push content to Google Drive, Rclone, Mega, and other supported routes
Automation	Limit tasks, tune queues, and manage startup updates from one config layer

How It Runs

Deploy with Docker and provide the required configuration values. The container takes care of the runtime path, so users only need to build or start the image and set their settings.

What you need Click Here

• Docker installed
• Your Telegram bot token and Telegram API credentials
• A MongoDB connection string
• The optional service credentials you want to enable, such as Drive, Rclone, Mega, JDownloader, or SABnzbd

Deployment

Recommended: Docker Compose

git clone https://github.com/SilentDemonSD/WZML-X.git
cd WZML-X
docker compose up --build

Use this when you want the simplest full deployment path.

Single Container

git clone https://github.com/SilentDemonSD/WZML-X.git
cd WZML-X
docker build -t wzmlx .
docker run -p 80:80 -p 8080:8080 wzmlx

Use this if you want a manual one-container deployment.

Deployment Notes

1. Set BASE_URL_PORT and RCLONE_SERVE_PORT to match the ports you want to expose.
2. If you use qBittorrent, tune AsyncIOThreadsCount to your machine size.
3. Stop the container before removing it, and remove the container before pruning images.
4. Useful cleanup commands:

sudo docker container prune
sudo docker image prune -a

Legacy Workflow Guide

Some users still rely on the external workflow path referenced by the previous README:

• WZ Deploy workflow guide

Keep this only if that workflow still matches your deployment style.

Configuration

Start with the required values:

• BOT_TOKEN
• TELEGRAM_API
• TELEGRAM_HASH
• OWNER_ID
• DATABASE_URL

Then tune the optional behavior from config_sample.py.

Important user-facing settings

Setting	User impact
DEFAULT_LANG	Bot language
STATUS_LIMIT	How much status data is shown
DEFAULT_UPLOAD	Default upload target
LEECH_SPLIT_SIZE	How large leech outputs are split
QUEUE_ALL, QUEUE_DOWNLOAD, QUEUE_UPLOAD	Queue pressure and concurrency
SHOW_CLOUD_LINK	Whether cloud links are shown to users
WEB_PINCODE	Protects web access to file selection
UPDATE_PKGS	Package refresh behavior during startup

Integrations available in config

The sample config also covers:

• qBittorrent and Aria2-related controls
• JDownloader login details
• Mega credentials
• SABnzbd server definitions
• Google Drive settings
• RSS, search, media metadata, and logging controls

Project Layout

Path	Purpose
bot/	Bot core, handlers, listeners, and modules
web/	FastAPI app, templates, and the file selector UI
gen_scripts/	Setup helpers for sessions, tokens, and drive configuration
plugins/	Optional bot plugins
qBittorrent/	Default qBittorrent configuration
sabnzbd/	Default SABnzbd configuration

Documentation

Note

This documentation is still being expanded.

• Full guides: docs/
• Deployment notes: the docs site linked from the repository at WZ Docs
• Configuration reference: config_sample.py

Support

Join Community

• Telegram channel: https://t.me/WZML_X
• Support group: https://t.me/WZML_Support

Credits

WZML-X is a fork of mirror-leech-telegram-bot. The base project belongs to anasty17 and upstream contributors.

Bot Authors

Avatar	Name	Role	Profile
	SilentDemonSD	Author, UI design, and custom features	GitHub
	RjRiajul	Co-author and maintainer	GitHub
	CodeWithWeeb	Feature expansion and wrap-up improvements	GitHub
	Maverick	Co-author and bug testing	GitHub

License

This project is distributed under the terms of the repository license. See LICENSE for the full text.