IPTV in Jellyfin Live TV

Why use Jellyfin for IPTV?

Most people watch IPTV in a player app on each TV. Jellyfin works differently: a server at home loads your playlist and guide once, then every Jellyfin app in the house (and outside it, if you allow) sees the same channels, guide and recordings. It suits households with several screens, people who want to record live TV to their own storage, and anyone who already uses Jellyfin for films and series.

What Jellyfin supports

According to Jellyfin’s documentation:

• Tuners: HDHomeRun devices and M3U playlists. In the docs’ words, M3U “allows you to add IPTV channel playlists which you can view and record.” Further tuner types are available through plugins.
• Guide data: XMLTV files, or Schedules Direct, a paid service covering the United States and Canada. UK viewers will normally use their provider’s XMLTV link.
• Mapping: guide data has to be mapped to the right channels after you add a guide provider.

Before you start

• A running Jellyfin server, version up to date, on a machine that stays on.
• Your playlist link (M3U) and guide link (XMLTV). With an Xtream Codes login, build both links first with our Xtream Codes to M3U converter or see Xtream Codes to M3U.
• Enough connections on your subscription. Each Jellyfin client watching a different channel uses one; see too many connections.

Set it up

1. In the Jellyfin dashboard, open Live TV.
2. Add a tuner device, choose M3U, and enter your playlist address (or upload a file).
3. Add a TV guide data provider, choose XMLTV, and enter your guide address.
4. Map channels that the guide doesn’t match automatically.
5. Open Live TV in any Jellyfin app to watch, and schedule recordings from the guide if you like.

Watch on your TVs and phones

Jellyfin publishes official apps for most screens:

Jellyfin’s own downloads page doesn’t list an official Apple TV app, so Apple TV owners usually use a third-party Jellyfin client; check the App Store listing’s publisher before installing.

Guide matching: getting the TV guide right

The guide attaches to a channel when the playlist’s tvg-id matches a channel ID in the XMLTV file. When they don’t match, the channel shows no guide or the wrong programmes. Fix it by mapping the channel in Jellyfin’s Live TV settings, or by correcting IDs in the playlist. See “EPG not available” for some channels and adding an EPG.

Tips

• Running Jellyfin in Docker with an HDHomeRun? The docs say to use host networking, because Jellyfin connects to a changing UDP port. M3U tuners don’t need it.
• Big playlists: remove groups you never watch before adding the playlist, or put a manager such as Dispatcharr or Threadfin in front of Jellyfin to curate channels and guide data.
• Picture stutters on some clients: a client that can’t play the stream’s format directly makes the server transcode it, which needs a capable CPU or hardware acceleration. Testing the same channel in VLC shows whether the stream itself is the problem.

Jellyfin or Plex?

Jellyfin handles IPTV directly and costs nothing; Plex needs a tuner proxy and a Plex Pass for Live TV and DVR. See Plex vs Jellyfin for IPTV and, for the paid alternative Jellyfin was forked from, Emby for IPTV and our Plex IPTV guide.