irisxdr/neo-wzml repository overview

⁠NEO-WZML — Docker Image

irisXDR/neo-wzml:latest is the pre-built base image for NEO-WZML⁠, a multi-functional Telegram mirror / leech bot for downloading from torrents, Mega, YouTube, Google Drive, rclone, JDownloader, direct links, and more — with built-in FFmpeg processing, archive handling, torrent search, RSS, and a web UI for file selection.

The published image is multi-arch — both linux/amd64 and linux/arm64 manifests are part of the same latest tag, so it pulls correctly on x86 servers, Apple Silicon, Raspberry Pi 4/5, ARM cloud VMs, etc.

⁠Quick start

The typical deployment uses Docker Compose; see the Quick Start in the project README⁠ for the full flow.

git clone https://github.com/irisXDR/NEO-WZML.git
cd NEO-WZML

cp sample_config.py config.py
# Edit config.py and set the required values (BOT_TOKEN, OWNER_ID,
# TELEGRAM_API, TELEGRAM_HASH, DATABASE_URL).

docker compose up -d --build
docker compose logs -follow

The included Dockerfile and docker-compose.yml already reference this base image — there's nothing extra you need to wire up to use it.

⁠Features at a glance

NEO-WZML itself (built on top of this image) supports:

• 🔌 Download engines: Aria2c, qBittorrent, Mega.nz, Google Drive, yt-dlp, Telegram, rclone, JDownloader.
• ☁️ Upload targets: Telegram leech, Google Drive, rclone remotes, GoFile, BuzzHeavier, PixelDrain (single-target or multi-target uploads).
• 🌐 Web file selection for torrents + Mega folders (BASE_URL + WEB_PINCODE).
• 🎬 Media tools: ZIP / unzip, image-only ZIPs, merge videos with FFmpeg, sample videos, screenshots, custom FFmpeg presets, metadata application, thumbnails, audio / video conversion.
• 🛡️ Operator controls: MongoDB-backed persistence, queues, per-user / per-bot / cross-bot universal task limits, daily caps, cooldowns, force-sub, login tokens.
• 🐳 Docker-first deployment, with an optional Gluetun VPN scaffold for torrent traffic.

See the project README⁠ for the full feature matrix and command reference, and the Telegram channel⁠ for release notes.

⁠Support

• 📢 Channel: t.me/Chiheisen⁠
• 💬 Support group: t.me/ChiheisenUnion⁠
• 🐞 Issues: github.com/irisXDR/NEO-WZML/issues⁠

If a build of this base image fails for you on a particular architecture, please open an issue with the platform string, Docker version, and the failing layer.

⁠License

GNU Affero General Public License v3.0⁠