Plex IPTV: How to Add an M3U to Plex, Jellyfin and Emby (2026)

Setup guide
Card showing how to add an M3U playlist to Plex and Jellyfin live TV

Illustration: Smart IPTV App.

Plex cannot open an IPTV playlist on its own. Its Live TV & DVR feature expects a TV tuner, so to get IPTV channels into Plex you run a small program that pretends to be one, such as Threadfin or Dispatcharr, point it at your M3U playlist and XMLTV guide, then add it in Plex as if it were a network tuner. You also need a Plex Pass. If you do not want that extra layer, Jellyfin reads an M3U playlist directly and for free, with a full TV guide and recording.

So the honest answer to "how do I add IPTV to Plex?" is: you can, it works well once set up, but Jellyfin gets you to the same place in five minutes. This guide covers both, plus Emby, and the one setting that keeps your IPTV account safe on any of them.

Note: Smart IPTV App is an IPTV provider, and we promote our own service on this page. Plex, Jellyfin, Emby, Threadfin and Dispatcharr are made by independent companies and projects.

Last checked: November 5, 2026, against Plex's Live TV & DVR support page, Jellyfin's Live TV documentation and setup guide, and the Threadfin and Dispatcharr project pages. Menu names can change between versions.

Plex, Jellyfin or Emby: which one for IPTV?

PlexJellyfinEmby
Reads an M3U directlyNo, needs a virtual tuner (Threadfin, Dispatcharr)Yes, built-in "M3U Tuner"Yes, or through a virtual tuner
TV guideThrough the virtual tuner's XMLTVXMLTV link, built inXMLTV
Recording (DVR)Requires Plex PassBuilt in, freeEmby Premiere for some features
CostPlex Pass subscriptionFree and open sourceFree core, paid Emby Premiere
Best forHouseholds already living in PlexThe quickest, cheapest IPTV setupEmby users who want one app

What you need before you start

  • A media server that stays on: a PC, a NAS or a mini PC running Plex Media Server, Jellyfin or Emby.
  • Your M3U playlist link from your IPTV provider. If you only have an Xtream Codes login (server, username, password), ask your provider for the matching M3U Plus link. Our guide to Xtream Codes and M3U explains the difference.
  • Your XMLTV guide link (EPG URL), so the channels show what is on. See how IPTV EPG works.
  • The number of screens on your plan. You will need it for the stream limit below.

Option 1: Jellyfin, the five-minute setup

Jellyfin is free and open source, and its Live TV feature accepts an M3U playlist out of the box. From the Jellyfin documentation:

  1. Open the Admin Panel (dashboard) and click Live TV.
  2. Click the + next to Tuner Devices.
  3. Set Tuner Type to M3U Tuner.
  4. In File or URL, paste your M3U playlist link.
  5. Set Simultaneous stream limit to the number of screens on your IPTV plan (see the warning below), then save.
  6. Back on the Live TV page, add a TV Guide Data Provider, choose XMLTV and paste your guide link.
  7. Open Live TV from the home screen. Channels, the guide and recording are ready in every Jellyfin app.

If a playlist only loads with a custom header, Jellyfin also has a User agent field for that case. Leave it empty unless your provider tells you otherwise.

Option 2: Plex with a virtual tuner

Plex's Live TV & DVR was designed for real antennas and tuners such as an HDHomeRun. Plex's own support page states that you need a compatible tuner connected to your server, and that recording is a premium feature that requires an active Plex Pass. A virtual tuner fills the gap: it reads your M3U and XMLTV, then shows itself to Plex as a network tuner.

The two maintained options in 2026:

  • Threadfin, an M3U proxy for Plex DVR and Emby or Jellyfin Live TV, based on the older xTeVe. Its project page lists a Plex Pass and a Plex client with DVR support as requirements on the Plex side.
  • Dispatcharr, a newer open-source manager for IPTV streams and EPG data. It emulates an HDHomeRun so Plex, Emby or Jellyfin discover it as a live TV source, and can also export M3U or Xtream Codes.

The steps are the same with either:

  1. Install Threadfin or Dispatcharr on the same network as your Plex server. Both run well in Docker.
  2. In its web interface, add your M3U link and your XMLTV link.
  3. Filter the playlist down to the channels you actually watch. Plex handles a few hundred channels far better than thousands.
  4. Map each channel to its guide entry, and set the number of tuners to the number of screens on your plan.
  5. In Plex, open Settings > Live TV & DVR > Set up Plex DVR. Plex should find the virtual tuner; if not, enter its address manually.
  6. When Plex asks for the guide, choose the XMLTV option and give it the guide URL from Threadfin or Dispatcharr.

Give the virtual tuner a fixed IP address on your network, as Plex recommends for network tuners. Otherwise Plex may lose it after a router restart.

The setting that protects your IPTV account

Every IPTV plan allows a set number of screens at the same time. A media server can open more streams than you think: a recording, a second viewer, a channel preview, an app that keeps a stream open. If the server opens more connections than your plan allows, streams start failing, and some providers block accounts that keep going over.

So set the limit once and forget about it: Simultaneous stream limit in Jellyfin, number of tuners in Threadfin or Dispatcharr. Use the number of screens on your plan. On a 1-device plan, that means one live channel or recording at a time across the whole server.

Emby

Emby works much like Jellyfin: it can read an M3U playlist with an XMLTV guide, or use Threadfin or Dispatcharr as a tuner. Some live TV and DVR features depend on an Emby Premiere subscription, so check Emby's own documentation for your version before you plan around recording.

What about Stremio and old Plex plug-ins?

Stremio has no built-in M3U tuner; IPTV in Stremio depends on community add-ons that come and go, and you lose a proper TV guide. For live TV with a schedule, Jellyfin or a dedicated player is the better tool.

Older guides also mention IPTV.bundle, a Plex plug-in. It relies on the plug-in system Plex retired years ago, so it is not a reliable route today. Use a virtual tuner instead.

Watching outside your home

A media server can stream your IPTV channels to your phone when you are away, but every stream then uses your home internet's upload speed, and transcoding can load the server. Keep away streams to HD, and count them in your stream limit like any other screen.

When it does not work

  • No channels after adding the M3U: open the link in a browser or in VLC to check it loads. If it asks for a login, the link is wrong or your plan has ended.
  • Empty TV guide: the XMLTV link is missing, or channels are not mapped to their guide entries.
  • Streams stop after a few seconds: usually the stream limit is too high and the account is over its screens, or the server is transcoding more than it can handle.
  • Plex does not find the tuner: check the virtual tuner's IP address and that Plex and the tuner are on the same network.

More fixes in IPTV not working or buffering.

Media server or dedicated player?

A media server is worth it if you already run Plex or Jellyfin for your films and want live TV in the same app, on every screen, with recording. If you just want to watch IPTV on one TV, a dedicated player such as TiviMate on Android TV or Fire TV is simpler and has a better live TV guide. Compare the options in the best IPTV player for every device, or see Kodi with IPTV Simple Client, another free route.

Try it with a working playlist

All of this needs an M3U and an XMLTV link that actually work. Our free 24-hour trial gives you both, so you can test Jellyfin or a Plex virtual tuner before you pay. Plans for 1 to 4 screens are on the plans page.

Frequently asked questions

Can I add IPTV to Plex?

Yes, but not directly. Plex's Live TV & DVR needs a tuner, so you run a virtual tuner such as Threadfin or Dispatcharr that reads your M3U and XMLTV and shows itself to Plex as a network tuner. Recording requires a Plex Pass.

Does Plex support M3U playlists?

Not on its own for live TV. Plex needs a tuner; a virtual tuner converts your M3U playlist into one Plex can use.

Do I need Plex Pass for IPTV?

Plex states that recording live TV requires an active Plex Pass, and Threadfin lists a Plex Pass as a requirement for use with Plex.

Is Jellyfin better than Plex for IPTV?

For IPTV specifically, Jellyfin is simpler: it reads an M3U playlist and an XMLTV guide directly, records for free, and needs no extra software.

What is xTeVe?

xTeVe was an M3U proxy that let Plex use IPTV as a tuner. Threadfin is based on it and is the maintained successor many users switched to; Dispatcharr is a newer alternative.

Can I use Xtream Codes with Plex or Jellyfin?

They work with an M3U playlist and an XMLTV guide. Ask your provider for the M3U Plus link that matches your Xtream Codes login, or use Dispatcharr, which can take provider sources and export them for your media server.

How many streams can my media server open?

As many as you allow it to. Set the stream limit (Jellyfin) or the number of tuners (Threadfin, Dispatcharr) to the number of screens on your IPTV plan.

Can I record IPTV with Jellyfin?

Yes. Jellyfin's Live TV supports recording from an M3U tuner for free, within the stream limit you set.