NEO-WZML NEO-WZML

Open source · Self-hosted

NEO-WZML
Telegram mirror & leech bot

Run your own bot to download from torrents, direct links, Mega.nz, Google Drive, and yt-dlp sources — then mirror to cloud storage or leech to Telegram. Forked from the WZML-X ecosystem with a focus on Mega reliability and a cleaner web experience.

This page documents the software project. Limits, speed, and storage are determined by your server and configuration.

Project highlights

Quick facts — not a hosted service tier.

GPLv3
License
Same lineage as upstream mirror-leech projects; see LICENSE in the repo.
Docker
Deploy
Compose-oriented workflow; bring your own VPS or homelab.
You
Your hardware
Parallel tasks, file caps, and bandwidth follow your machine & settings.

What you get

Highlights beyond a typical stock WZML-X deployment — plus the usual ecosystem tools when enabled in config.

Mega.nz done seriously

Mega SDK 8.1.1 with optional web-based folder file selection, coordinated between the bot and the FastAPI worker.

Modern web UI

Landing page (this site) and PIN-protected file picker for torrents and Mega — styled for NEO-WZML, not generic stock templates.

Leech & mirror

Upload completed downloads to Telegram or to rclone-compatible remotes (and friends), driven by commands and user settings.

Broad download sources

Torrents / qBittorrent, aria2, direct links, Google Drive, yt-dlp, JDownloader, and more — enable what you need.

MongoDB-backed settings

Persistent bot configuration and task metadata for multi-user deployments.

Maintained fork

Active development under irisXDR, including work on PyroBlack for Telegram API viability.

Self-host in three steps

Copy sample_config.py to config.py , set variables (or use environment) — see the README on GitHub.

1

Deploy

Clone the repo and run with Docker Compose on a machine you control, or install dependencies manually if you prefer.

2

Configure

Set bot token, MongoDB, optional BASE_URL for the web file picker, and upload targets (rclone, Drive, etc.).

3

Use Telegram

Talk to your bot instance: send links or torrents, pick files on the web UI when prompted, and monitor tasks in chat.

Contributions welcome

Stars, bug reports, and pull requests help keep the fork sustainable. There is no separate “hosted tier” advertised here — everything runs on infrastructure you provide.