M3U IPTV

M3U Addon A self-hostable Stremio addon specifically designed for movies and series. It loads M3U playlists and Xtream Codes content, automatically resolves IMDb IDs using TMDB, and integrates the content directly into the Stremio ecosystem.

⚠️ Install Button — Demo Instance (Limited)

The install button uses a demo instance hosted on Render's free plan. It is limited to approximately 50 concurrent users and is only meant for testing purposes.

If the demo is not working or the catalog appears empty, it is likely because the demo instance is currently at capacity. This is expected on the free plan on render.

To use the addon without limits, deploy your own private instance — it only takes a few minutes and is completely free.

One-Click Deploy

Render

https://render.com/deploy?repo=https://github.com/Esmequiinn/addon-m3u_friendly

Railway

https://railway.com/deploy/m3u-addon?referralCode=tn36RQ

Render Blueprint

The one-click Render deployment uses Render Blueprints by default. Depending on your account and region, Render may require a payment method to be added before Blueprint deployments can be created.

If you want to deploy completely free on Render, you can manually create the Web Service instead of using the Blueprint deployment. The manual setup process is simple and only takes a few minutes.

Alternative Deploy Options (Python version)

For users who prefer not to use Render or Railway, the Python version of the addon (in the python/ folder of the repo) can also be deployed manually on:

• Hugging Face Spaces — free, no credit limit, never sleeps. Upload the files from the python/ folder, select the Docker SDK, and the Space builds itself.
• Fly.io — free tier with 3 shared VMs, never sleeps. Requires the Fly CLI: fly auth login → fly launch → fly deploy from inside the python/ folder.

Detailed instructions for all deployment methods can be found in the GitHub repository README (available in English and Spanish): https://github.com/Esmequiinn/addon-m3u_friendly

Features

• Load one or multiple M3U playlists
• Xtream Codes support
• Automatic IMDb ID resolution via TMDB
• Compatible with Cinemeta and metadata addons
• Automatic movie and series matching
• Series grouping by season and episode
• Search support inside catalogs
• Personalized private configuration per user
• Available in Node.js and Python (FastAPI), same functionality on both
• One-click deployment support for Render and Railway
• Manual deployment support for Hugging Face Spaces and Fly.io (Python version, free, never sleeps)
• Automatic keep-alive system for Render deployments
• Prevents free Render instances from going to sleep
• Background IMDb resolution with TMDB
• Memory-efficient playlist loading

How It Works

1. Deploy your own private instance
2. Open the addon configuration page
3. Enter:
   • Your M3U playlist URL or Xtream credentials
   • Your TMDB API key
4. Install the generated addon URL into Stremio
5. Your IPTV content will appear integrated with Stremio metadata

The addon resolves IMDb IDs in the background to improve compatibility with Cinemeta and other metadata addons.

Self Hosting Requirements

• TMDB API Key
• Node.js or Python, depending on which version you choose to deploy

Notes

• IMDb matching may take a moment after startup
• Unresolved titles are resolved dynamically when opened
• Each deployment keeps its configuration private and isolated

Disclaimer This addon does not provide IPTV streams or media content. Users are responsible for the playlists and providers they use.