Key takeaway: Plex cannot load an IPTV playlist on its own: its Live TV feature expects a TV tuner. To watch IPTV in Plex, you run a free helper called Threadfin, which presents your M3U playlist to Plex as if it were a tuner. If that sounds like too much work, a dedicated IPTV player is the simpler choice.
Plex is a favourite with people who keep their own film and series collection, so it is natural to want IPTV channels in the same place. The good news is that it can be done. The catch is that Plex was built for TV tuners and antennas, not for IPTV playlists, so you need one extra piece of free software in the middle.
This guide explains how Plex Live TV works, why an M3U link will not load directly, and how to connect the two with Threadfin step by step. It also covers the TV guide, what Plex Pass adds, common problems, and when a normal IPTV player is the better answer.
Who this is for: people who already run a Plex Media Server on a computer or NAS and are comfortable installing software on it. If you only want to watch IPTV on your TV, skip to “Simpler alternatives” below.
In this guide
How Plex Live TV works
Plex Live TV and DVR was designed for over-the-air TV. You connect a supported tuner, such as an HDHomeRun, and an antenna to your network, and Plex Media Server finds the tuner, lists its channels and adds a TV guide. According to Plex’s DVR and Live TV FAQ, watching live broadcasts this way is free, while recording (DVR) requires a Plex Pass subscription.
IPTV works differently. Your service gives you an M3U playlist or Xtream Codes login, not a tuner. Plex does not offer a box where you can paste an M3U link, which is why people search for “Plex IPTV” in the first place.
The fix: Threadfin, a free M3U proxy
Threadfin is a free, open-source M3U proxy for Plex, Emby and other media servers. It reads your IPTV playlist and guide, lets you choose which channels to keep, and then presents them to Plex as an HDHomeRun tuner. Plex sees a “tuner”, finds the channels and treats them like normal live TV.
Threadfin is the actively maintained successor to an older tool called xTeVe, so you may see either name in forums.
What you need
- A Plex Media Server on a computer or NAS that stays on.
- Your IPTV login as an M3U playlist link, plus an EPG (XMLTV) guide link if your service provides one. See M3U vs Xtream Codes if you only have Xtream details; most services can give you both.
- A way to run Threadfin: on Windows, macOS or Linux, or most easily with Docker on a NAS or home server.
- Enough connections on your IPTV plan for every Plex user who watches live TV at the same time.
Step 1: Install Threadfin
- Follow the install instructions on the Threadfin project page for your system. On a NAS or home server, the Docker image is the easiest route.
- Start Threadfin and open its web page in a browser. It runs on port 34400 by default, for example http://192.168.1.20:34400/web (use your server’s own address).
- Follow the first-run wizard and choose how many tuners to offer. Set this to the number of connections on your IPTV plan, so Plex never opens more streams than you are allowed.
Step 2: Add your playlist and guide
- In Threadfin, open Playlist and add your M3U link.
- Open XMLTV and add your guide link.
- Open Filter and choose the channel groups you actually watch. Keeping the list short makes everything faster.
- Open Mapping, turn on the channels you want and match each one to its guide entry. Channels without a guide match will show “no information” in Plex.
- Save, and let Threadfin update.
Step 3: Add Threadfin to Plex as a tuner
- In Plex Web, open Settings, then Live TV & DVR under your server, and choose Set up Plex DVR.
- If Plex does not find a device automatically, enter Threadfin’s address and port by hand, for example 192.168.1.20:34400.
- Plex shows the channels Threadfin offers. Continue.
- When Plex asks for a guide, choose the option to use an XMLTV guide and enter Threadfin’s guide address: your server address followed by /xmltv/threadfin.xml, for example http://192.168.1.20:34400/xmltv/threadfin.xml.
- Finish the wizard. Your IPTV channels now appear under Live TV in every Plex app.
What Plex Pass adds
Without Plex Pass, you can watch your channels live in Plex. With Plex Pass, you can also record them with the DVR, as Plex’s FAQ explains for tuner-based live TV. Check the current Plex Pass terms on Plex’s site before buying, because features and plans change.
Common problems and fixes
| Problem | Likely cause | Fix |
|---|---|---|
| Plex cannot find a tuner | Wrong address or port | Enter Threadfin’s address and port 34400 by hand |
| Channels show “no information” | Guide not mapped | Map each channel to a guide entry in Threadfin |
| Some channels will not play | Stream format Plex cannot handle | Try another channel source; check Threadfin’s buffer setting |
| Playback stops when a second person watches | Connection limit reached | Match Threadfin’s tuner count to your plan’s connections |
| Guide times are wrong | Time zone mismatch | Check the server time zone and the guide’s time shift |
If channels buffer in Plex but play fine in other apps, the server may be struggling to convert the stream; see our IPTV buffering fixes for the network side.
Simpler alternatives to Plex IPTV
Plex with Threadfin is great if you want everything in one Plex library. For most people who simply want to watch IPTV on a TV, a dedicated player is easier and smoother:
- TiviMate on Fire TV or Android TV, for a cable-style guide: see TiviMate on Fire TV.
- IPTV Smarters Pro, for films and series and Apple devices: see IPTV Smarters Pro on Fire TV.
- VLC on a computer, for a quick test of any playlist: see IPTV in VLC.
Whichever route you choose, you still need a reliable IPTV service that provides an M3U link and a guide. Many services explain where to find both; for example, 8K IPTV Group’s setup guides cover the main devices and apps, and it offers a free 24-hour trial so you can test the playlist in Threadfin before you pay.
FAQ
Can Plex play an M3U playlist directly?
No. Plex Live TV expects a tuner, so you need a helper such as Threadfin to present your playlist as one.
Is Threadfin free?
Yes. Threadfin is free, open-source software.
Do I need Plex Pass for IPTV in Plex?
Not to watch live. Recording with the DVR requires Plex Pass, according to Plex’s FAQ.
Does Plex IPTV work on Fire TV and smart TVs?
Yes. Once the channels are in your Plex server, they appear under Live TV in the Plex apps on Fire TV, smart TVs, phones and browsers.
How many people can watch at once?
As many as your IPTV plan’s connections allow. Set Threadfin’s tuner count to match, so Plex never goes over the limit; see IPTV multiple connections.
Next steps
New to IPTV logins? Read M3U vs Xtream Codes. Want the easy route instead? Compare the best IPTV players for Fire TV.