Your IPTV, fully under control.
Self-hosted tools for managing and watching live TV, movies, series, guide data, and DVR recordings, served to every player you own from one place.
Website · Docs · Quick Start · Get M3U TV · Discord
Your players only ever talk to M3U Editor. Swap providers, fix channel names, or fill in missing guide data, and every device picks up the change without being reconfigured.
| Your sources | ➡️ | The suite | ➡️ | Your players |
|---|---|---|---|---|
| IPTV providers (M3U, Xtream) XMLTV and Schedules Direct Emby, Jellyfin, and Plex Local and WebDAV media AIOStreams and the *arrs |
M3U Editor cleans, merges, maps, and enriches M3U Proxy handles the streams |
M3U TV Plex, Emby, and Jellyfin TiviMate, Kodi, and VLC Any Xtream or M3U app |
| Project | What it does | |
|---|---|---|
| 🎛️ | M3U Editor Docs |
The web app at the center of the suite. Import M3U and Xtream sources, organize channels, VOD, and series, map guide data, record with the built-in DVR, and publish it all as M3U, Xtream Codes API, HDHomeRun, and XMLTV. |
| ⚡ | M3U Proxy Docs |
A high-performance streaming proxy. Viewers share upstream provider connections, streams fail over automatically, and you can transcode with NVIDIA, Intel, or AMD hardware acceleration, or pass streams through untouched. |
| 🍿 | M3U TV Get the app |
A free player built for M3U Editor, for Android TV, Apple TV, phones, tablets, and desktop. Live TV with a guide, movies, series, sports, DVR, and Continue Watching that follows you between devices. |
M3U Editor works with any player, so M3U TV is optional. It works best for those who want TV pairing without typing a password, push notifications, and synced watch progress.
- 🗂️ Tidy up your lineup: sort, rename, renumber, and bulk edit thousands of channels, and build custom or merged playlists.
- 🗓️ Get a guide that works: use XMLTV files, remote URLs, or Schedules Direct, with smart channel mapping and dummy EPGs.
- 🔀 Stay on air: deduplicate channels across providers and fail over automatically when a stream drops.
- 🔴 Record anything: schedule recordings and series rules from the guide, with Comskip, NFO output, OTA support, and disk quotas.
- 🎬 Manage VOD and series: generate
.strmfiles for your media server, cache content locally, and pull artwork, cast, and ratings from TMDB. - 🖥️ Connect your libraries: bring in Emby, Jellyfin, Plex, local folders, and WebDAV, and serve them next to your live TV.
- 📥 Request and stream more: request titles through Sonarr and Radarr, and stream debrid catalogs with AIOStreams.
- 🤖 Automate it: use plugins, webhooks, post-processing scripts, the REST API, or the in-app AI Copilot.
You need Docker and at least one source, such as an Xtream login or an M3U URL or file.
curl -O https://raw.githubusercontent.com/m3ue/m3u-editor/master/docker-compose.proxy.yml
docker compose -f docker-compose.proxy.yml up -dThen open http://localhost:36400 and sign in with admin / admin. You'll be asked to choose a new password straight away.
The Quick Start covers the other setups, and the compose wizard builds a config for you. Prefer not to host it yourself? ElfHosted offers fully managed instances.
| Project | What it does |
|---|---|
| m3u-editor-docs-v2 | The source for the documentation site. Fixes are welcome. |
| m3u-push-relay | Stateless relay that delivers push notifications from self-hosted editors to M3U TV on phones and tablets |
| channels-dvr-plugin | Maps Gracenote station IDs from a local Channels DVR install to your playlist channels |
| tv-logos-plugin | Fills in channel logos by matching names against the open-source tv-logos repository |
| youtubearr-plugin | Watches YouTube channels for livestreams and creates or removes custom channels automatically |
| m3u-editor-for-emby | Community-maintained Emby plugin for managed library publishing |
Want to build your own? See the plugin developer guide.
- 💬 Chat: ask questions, help others, and try new features on Discord.
- 🐛 Report a problem: open an issue on the relevant repo, such as M3U Editor, or browse the discussions.
- 🗺️ See what's next: follow the project board.
- 🛠️ Contribute: PRs for code and docs are welcome.
- ☕ Support the project: buy us a coffee on Ko-fi.
M3U Editor and M3U Proxy are licensed under CC BY-NC-SA 4.0, and M3U TV under GPL-3.0. The suite is an independent set of tools, not an IPTV provider: it doesn't host channels or partner with streaming services. Only use content you're authorized to access.