Jellyfin IPTV Setup Guide 2026, FreeIPTVCheck blog cover

Jellyfin IPTV works through the server’s built-in M3U tuner. No plugin, no proxy, no paid license. Add your playlist URL under Live TV, attach an XMLTV guide, and Jellyfin serves your channels inside the same interface you already use for local media.

📺
Want a reliable IPTV service? Skip the dead streams — try a premium IPTV service free for 24 hours. No card required.
Start Free Trial →

What jellyfin actually does with an M3U playlist

Jellyfin treats your M3U file as a “tuner device.” Each line in the playlist becomes a channel in the Live TV section. Jellyfin reads four tags from each entry automatically:

  • tvg-id, used to match the channel to your EPG source
  • tvg-name, the display name shown in the guide
  • tvg-logo, the channel icon
  • group-title, the category or bouquet name

If your playlist is missing tvg-id values, channel-to-EPG matching will not work automatically. You can still fix it manually after import, but it takes more time per channel.

Jellyfin does not accept Xtream Codes credentials directly. The tuner setup asks for a URL, not a username and password. If your provider gave you an Xtream login, use the M3U to Xtream converter to generate an M3U URL from those credentials, then use that URL in Jellyfin.

How to set up jellyfin IPTV step by step

The menu names below match Jellyfin 10.9. Jellyfin updates its interface regularly, so check the official Jellyfin documentation if a label looks different on your version.

Step 1: Add the M3U tuner

  1. Open the Jellyfin admin dashboard.
  2. Go to Live TV in the left sidebar.
  3. Click the + button next to Tuner Devices.
  4. Select M3U Tuner from the dropdown.
  5. Paste your M3U URL into the File or URL field, or upload a local .m3u file.
  6. Set a Simultaneous Stream Limit. This should match the number of concurrent streams your provider allows. Setting it to 0 means unlimited, which can cause problems if your provider enforces a cap.
  7. Click Save.

Jellyfin will scan the playlist and populate your channel list. Large playlists with thousands of entries can take a minute or two.

Step 2: Add an XMLTV guide source

Without a guide source, Live TV shows channel names but no programme information. You cannot schedule recordings or browse by show.

  1. In the same Live TV section, click + next to TV Guide Data Providers.
  2. Select XMLTV.
  3. Enter your XMLTV URL. Your IPTV provider usually supplies this alongside the M3U link.
  4. Set the refresh interval. Every 24 hours is a common default.
  5. Click Save.

Jellyfin then tries to match each channel in your playlist to a channel in the XMLTV file, using tvg-id as the key.

Step 3: Fix unmatched channels

If tvg-id values in the playlist do not match the channel IDs in the XMLTV file, those channels get no guide data. Fix them one at a time:

  1. Go to Dashboard > Live TV > Channels.
  2. Click an unmatched channel.
  3. Under Edit, find the EPG mapping field and select the correct channel from your guide source.

If a large number of channels are unmatched, the problem is usually that the playlist and the EPG come from different sources using different ID formats. Aligning them at the source is the cleaner fix.

Jellyfin IPTV vs emby: Key differences

Both media servers support M3U tuners and XMLTV guides, and the setup process is similar. The difference that matters most for IPTV users is licensing.

FeatureJellyfinEmby
Live TV / M3U TunerFree, built-inRequires Emby Premiere
XMLTV EPG supportFree, built-inRequires Emby Premiere
DVR recordingFree, built-inRequires Emby Premiere
Client appsFreeMix of free and paid
Self-hostedYesYes
Cloud optionNoYes (Emby Connect)

If you are deciding between the two purely on cost, Jellyfin gives you everything above at no charge. Emby’s paid tier adds things like hardware transcoding support and cloud sync, which Jellyfin either handles differently or leaves to the community.

Common jellyfin IPTV problems and fixes

ProblemLikely CauseFix
Channels import but no video playsStream URL requires a custom User-AgentAdd the User-Agent string in the M3U tuner settings
Guide data missing on all channelsXMLTV URL not saving or unreachableCheck the URL loads in a browser; re-save the guide provider
Guide data missing on some channelstvg-id mismatch between M3U and XMLTVMap channels manually in Dashboard > Live TV > Channels
Streams cut out after a few minutesProvider stream limit reachedLower the simultaneous stream limit in tuner settings
Buffering on HD channelsJellyfin transcoding instead of direct playSet the client to direct play; check that your server CPU is not the bottleneck
Xtream login not acceptedJellyfin only accepts URLs, not credentialsConvert to an M3U URL first with the M3U to Xtream converter

Before assuming Jellyfin is the problem, confirm the stream itself is working. Paste the channel URL directly into VLC or a browser. If it fails there too, the issue is upstream. You can also run a quick check with the IPTV stream checker to see whether a URL responds at all before bringing Jellyfin into the diagnosis.

Checking stream quality before and after setup

Jellyfin adds a layer between your stream source and your screen. That can mask whether a slow stream, a buffering issue, or a dead URL is the real problem. Isolating each layer saves time.

A few checks worth running:

  • Use the IPTV channel viewer to browse your playlist and confirm the channel list looks right before importing it into Jellyfin.
  • Run the IPTV speed test to check whether your connection handles the bitrate of the channels you are trying to watch. A 1080p stream typically needs at least 10 Mbps of stable throughput. If your connection fluctuates, Jellyfin buffering will follow.
  • If a specific channel buffers inside Jellyfin but plays fine in VLC, the culprit is usually transcoding. Force direct play in the client’s playback settings and test again.

Keeping Jellyfin’s transcoding off when the client and stream format are compatible is the single biggest performance improvement most users can make.

DVR and recording with jellyfin IPTV

Once your tuner and guide are set up, DVR recording works without any extra configuration. Find a programme in the guide, click it, and select Record. Jellyfin saves the stream to a folder you specify during server setup.

A few things to plan for:

  • Storage fills up quickly. A single hour of HD content recorded from an IPTV stream can run to several gigabytes depending on the stream’s bitrate.
  • Scheduled recordings only work while your Jellyfin server is running. If the machine sleeps, the recording fails.
  • Recording quality matches the stream quality. Jellyfin does not re-encode by default, so what comes in is what gets saved.

There is no built-in storage management that automatically deletes old recordings to free space. You need to handle that manually or with an external script.

Frequently asked questions

Does Jellyfin support Xtream Codes login directly? No. Jellyfin’s M3U tuner accepts a playlist URL, not an Xtream username and password. Convert your Xtream credentials to an M3U URL first using the M3U to Xtream converter, then paste that URL into the tuner setup.

Do I need a plugin to use IPTV in Jellyfin? No plugin is required. Jellyfin has a built-in M3U tuner under Dashboard > Live TV. Add your playlist URL there and it works without any third-party extension.

Why are some of my channels showing no EPG data? The tvg-id in your M3U playlist must match the channel ID in your XMLTV file exactly. If they do not match, go to Dashboard > Live TV > Channels, click the channel, and set the EPG source manually.

How is Jellyfin different from Emby for IPTV? Both use an M3U tuner and XMLTV guide. The key difference is cost: Jellyfin’s Live TV feature is completely free, while Emby requires an Emby Premiere subscription to access Live TV.

My IPTV streams buffer constantly in Jellyfin. What should I check first? Start by testing whether the stream itself is healthy outside Jellyfin. Use the IPTV speed test to check your connection, then confirm whether Jellyfin is transcoding the stream unnecessarily. Direct play puts far less load on your network and server.