How to Add IPTV to Plex (Step-by-Step, 2026)

· Updated 2 November 2026· 5 min read

Plex logo

Plex shows live TV only from a TV tuner. It can't open an IPTV playlist (an M3U link) by itself. The fix is a small free program called Threadfin: it reads your playlist and your TV guide and presents them to Plex as a network tuner. Plex then treats your IPTV channels like ordinary TV channels, with a full guide, and with recording if you have Plex Pass.

Plan on about 30 minutes. You'll install Threadfin, add your playlist and guide, choose the channels you want, then add the tuner in Plex.

What you need

  • Plex Media Server on a computer or NAS that stays on. Live TV needs a server that can convert video on the fly (transcode), which some low-power NAS models can't do.
  • Your playlist link (M3U) and, ideally, your TV guide link (EPG, in XMLTV format). Your IPTV provider gives you both. If you only received a username and a password, ask your provider for the two links. 1ClickTV subscribers can get them from our support team.
  • Threadfin, free and open source, from its GitHub page. Older guides use xTeVe. xTeVe is no longer maintained; Threadfin is its successor and works the same way.
  • Plex Pass, if you want to record. Watching live TV through a tuner is free in current versions of Plex, and recording (DVR) needs a Plex Pass. Some users report that the setup screen asks for Plex Pass anyway; if yours does, you'll need it to continue.

Step 1: Install Threadfin

  1. On the Threadfin releases page, download the file for your system (Windows, macOS or Linux), or use its Docker image if your server runs Docker.
  2. Install it on the Plex server itself, or on another machine on the same home network.
  3. Start Threadfin, then open http://SERVER-IP:34400/web in a browser. Replace SERVER-IP with that machine's local address, for example 192.168.1.20. 34400 is Threadfin's default port.

Step 2: Add your playlist and TV guide

The first time you open Threadfin, a short setup wizard starts:

  1. Tuners: enter how many streams you want to watch at the same time. Don't go above the number of connections in your IPTV plan, or the extra streams will fail.
  2. EPG source: choose XEPG. It lets you match guide data to each channel yourself, which gives the most complete guide.
  3. M3U: paste your playlist link.
  4. XMLTV: paste your guide link.

Threadfin then downloads both. A large playlist can take a few minutes.

Step 3: Choose the channels you want

This is the step that decides whether the rest works. An IPTV playlist can hold tens of thousands of channels, and Plex can't take that many on one tuner: users report that the channel scan stops working above roughly 480 channels. So keep only what you watch.

  1. In Filter, add a filter for each channel group you want. The groups come from your playlist, for example one country's news or entertainment channels. Only channels in these groups go on to the next step.
  2. In Mapping, switch on the channels you want, check that each one has guide data from your XMLTV source, and set the names and numbers you want to see in Plex.
  3. Keep the active list to a few hundred channels. You can come back and change it at any time.

Step 4: Add Threadfin as a tuner in Plex

  1. Open Plex in a browser and go to Settings → Live TV & DVR → Set Up Plex DVR.
  2. Plex looks for tuners on your network and should find Threadfin as an HDHomeRun device. If it doesn't, click Don't see your HDHomeRun device? Enter its network address manually and type SERVER-IP:34400.
  3. When Plex asks where the TV guide comes from, choose the option to use an XMLTV guide and enter http://SERVER-IP:34400/xmltv/threadfin.xml.
  4. Check the channel list Plex shows, then click Continue to finish. The guide fills in within a few minutes.

Step 5: Watch, and record if you have Plex Pass

Your channels now appear under Live TV in every Plex app: smart TVs, phones, tablets, streaming sticks and the browser. With Plex Pass you can record a single show or a whole series from the guide.

Fixes for common problems

ProblemWhat to do
Plex doesn't find the tunerEnter SERVER-IP:34400 by hand (Step 4). Make sure Plex and Threadfin are on the same network and that the firewall allows port 34400.
The channel scan finds nothing or failsThe lineup is usually too big. Switch off channels in Threadfin's Mapping until a few hundred remain, then scan again.
Channels have no guideIn Threadfin's Mapping, give each channel its XMLTV entry, then refresh the guide data in Plex's Live TV & DVR settings.
Buffering or freezingIn Threadfin's settings, turn on a stream buffer (Threadfin's own or FFmpeg). Check your connection too: plan on about 15 Mbps per HD stream and 25 Mbps for 4K.
Streams fail when several people watchYou're asking for more streams than your tuner count or your IPTV plan allows. Match the tuner count to your plan's connections.

Easier options

  • Jellyfin and Emby accept an M3U link and an XMLTV link directly, so you don't need Threadfin.
  • An IPTV player app is the quickest route if you don't need Plex. On Android TV, Google TV, Fire TV and Android phones, 1ClickTV Player is free and records too. See also our TiviMate guide, our Kodi guide, or the installation guides for each device.

Questions people ask

Can Plex play an M3U playlist without extra software?

No. Plex reads live TV only from tuners, so an M3U playlist has to go through a tuner emulator such as Threadfin.

Can I still use xTeVe?

An existing xTeVe setup keeps working, but it no longer gets fixes. Threadfin is based on xTeVe, works the same way and is still updated.

Do I need Plex Pass?

For recording, yes. Watching live channels through a tuner is free in current versions of Plex, though some users report that the setup still asks for Plex Pass.

How many channels can I add?

Keep it to a few hundred per tuner. Users report that Plex stops scanning above roughly 480 channels.

New to playlists? Start with what an IPTV M3U playlist is and how to use it. Looking for a subscription? See the 1ClickTV plans.

Get exclusive deals by signing up to our Newsletter.

Sales support
support@oneclicktv.net
WhatsApp / Telegram
+44 7532 789713 · @oneclicktvdotnet
Live chatWhatsAppTelegramEmail

Having Playback Issues While Using a VPN?

If you are using a VPN and experiencing a Playback Error or Error 511, please change your IPTV Host URL to one of the alternative hosts below:

Simply replace your current Host URL with one of the addresses above in your IPTV app, then reconnect.

If one host does not work with your VPN, please try another from the list.

Tip: Restart your IPTV app after changing the Host URL.