Two open-source tools, one Telegram-powered stack

Turn Telegram into your streaming server & mirror engine

CineFlow Watch streams your channels straight into Stremio & Nuvio with posters, catalogs and subscriptions. WZML-X CineFlow mirrors and leeches anything, anywhere, at full speed. Self-hosted, free, and yours forever.

Explore the Projects Join Update Channel
CineFlow Watch WZML-X CineFlow Nuvio / Stremio Setup Deployment Guides
2
Open Projects
Stremio + Nuvio
Native Support
8+
Download Sources
1-Command
Docker Deploy
No Expiry
Stream Links
MIT
Licensed
Which one do you need?

Built for different jobs, sharing one theme

Watch is your streaming front-end for finished media. WZML-X is the engine that fetches, mirrors and leeches the files in the first place. Most self-hosters end up running both.

CineFlow Watch WZML-X CineFlow
Watching a private library
Posters, catalogs, subscriptions, multi-user access → CineFlow Watch
Fetching & mirroring files
Torrent, NZB, Drive, Mega, direct links → WZML-X CineFlow
Both together
Leech with WZML-X into your channels, then watch them in Stremio via CineFlow Watch

CineFlow Watch

Self-hosted Stremio / Nuvio media server

Forward a movie or episode to your Telegram channel and it instantly becomes a permanent, no-expiry stream — complete with posters, descriptions, seasons and episodes. Everything is managed from a friendly web panel, no coding required.

FastAPI MongoDB PyroFork Docker Stremio Addon
Instant, permanent streaming links — no expiry
Auto posters & metadata from IMDb / TMDb
Auto & custom catalogs, private & exclusive lists
Built-in subscriptions & access control
Split-file & multi-part playback as one stream
Anime-aware metadata + global search
In-app Telegram login, no session strings
Live activity dashboard + announcements

WZML-X CineFlow

Telegram mirror & leech bot — zero limits, max speed

A container-based Telegram bot for mirroring and leeching from almost anywhere — torrents, NZBs, direct links, Google Drive and more — with a lightweight web UI for file selection and a fully configurable transfer pipeline.

Python MongoDB Docker Compose qBittorrent / Aria2 Rclone / Mega / Drive
Mirror to Telegram, leech to your device format
File selection UI before finalizing a transfer
qBittorrent, Aria2, JDownloader, Mega, NZB, yt-dlp
Upload to Google Drive, Rclone remotes & Mega
Queue limits, task tuning, startup automation
Video tools (-vt) & subtitle merge command
One-command Docker Compose deployment
Multi-instance & VPN (Gluetun) support
4 steps, 2 minutes

Watch your library in Nuvio or Stremio

CineFlow Watch is a standard Stremio-style addon, so it works in any compatible player. We recommend Nuvio for the smoothest cross-device experience.

1

Get your manifest URL

Open your bot on Telegram and send /start — it replies with your personal addon link.

2

Install a player

Grab Nuvio or Stremio for your device — Android, Android TV, Fire TV, iOS, Windows or the web.

3

Add the addon

Open the app → Addons → paste your manifest URL → tap install.

4

Start watching

Your Telegram library appears in the catalog instantly, ready to stream — no downloads, no waiting.

NuvioGoogle Play — Android / TV / Fire TV Nuvio StreamingAll platforms — latest builds on GitHub StremioWindows, macOS, Linux, Android, web
/start → https://your-cineflow-domain.com/manifest.json
Own your stack

Deploy either project in minutes

Pick a hosting path for each project — everything ships with Docker, so most setups are a single command away.

VPS + Docker Recommended

Full control, 24/7 uptime, public URL out of the box. Best for multi-user hosting with subscriptions.

docker compose up -d

Heroku

Deploy straight from the repo's heroku.yml for a managed, no-server setup.

git push heroku main

Hugging Face Spaces

Free, always-online hosting with zero VPS — great for trying CineFlow Watch before committing to a VPS.

sdk: docker · app_port: 8000

VPS / Docker Compose Recommended

Clone, configure config.py, and bring the whole stack up behind a Cloudflare tunnel.

docker buildx compose up -d

VPS with VPN (Gluetun)

Route all bot traffic, including the tunnel, through your VPN provider for extra privacy.

network_mode: "service:gluetun"

Multi-Instance

Run several bots side by side, each with its own config and data volumes, on one host.

app2 / tunnel2 services

Stay updated, get support, ship faster

New releases, deployment help and troubleshooting all happen in the CineFlow Telegram channel — the fastest way to reach the community.