How to Watch IPTV in Jellyfin: M3U Tuner, TV Guide and Recording

Jellyfin can turn an M3U playlist and an XMLTV guide file into live TV with a proper programme guide, on every device in your house. You add the playlist as an M3U tuner, add the guide as an XMLTV provider, match up any channels that don't link automatically, and then watch in Jellyfin's apps on Roku, Fire TV, Android TV, Apple TV, phones and the web. It's free, and it's the best way to get a real IPTV guide on a Roku.

The trade-off: Jellyfin runs on a computer at home (a PC, Mac, NAS or mini PC), and that computer needs to be on whenever you watch. Setup takes about 45 minutes the first time.

Why bother with Jellyfin?

• A real guide on Roku. Roku can't install TiviMate or sideload anything. Jellyfin's official Roku app gets around that cleanly. See IPTV on Roku.
• One setup for every screen. Configure the playlist and guide once on the server; every device just signs in.
• Recording for the whole house. Record to the server's storage and watch on any device.
• Your own media too. The same server handles your films, series and music.
• Antenna channels. Jellyfin also supports HDHomeRun network tuners, so local broadcast channels can sit in the same guide.

Step 1: Install the server

Download Jellyfin for your system from jellyfin.org. Windows, macOS and Linux installers are available, as are Docker images and packages for popular NAS systems. Run the first-time setup in a web browser, create your admin account, and add any media libraries you want (you can skip that if you only want live TV).

Use a wired connection for the server if you can. It's serving every stream in the house.

Step 2: Add your playlist as an M3U tuner

Jellyfin's official Live TV setup guide lays out these steps (Jellyfin docs):

1. Open the admin dashboard and go to Live TV.
2. Click the + next to Tuner Devices.
3. Choose M3U Tuner as the tuner type.
4. In File or URL, paste your playlist link (or point it at a playlist file on the server).
5. Leave User agent blank unless your service tells you otherwise.
6. Set Simultaneous stream limit to the number of connections your service allows. Zero means unlimited, which can get you locked out if your service allows only one or two.
7. Only tick Auto-loop live streams if specific channels keep stopping; the docs note some IPTV channels need it.
8. Save.

If your service only gave you Xtream Codes details, look for an M3U link in its customer area, or build one from the server, username and password as explained in M3U vs Xtream Codes.

Step 3: Add the TV guide

1. On the same Live TV page, click the + next to TV Guide Data Providers.
2. Choose XMLTV.
3. Enter your service's guide URL (often ending xmltv.php, .xml or .xml.gz).
4. Save, and let Jellyfin download it. You can trigger a refresh from the scheduled tasks if you don't want to wait.

Step 4: Map channels

Jellyfin matches channels to guide entries automatically where the IDs agree. For the rest, open Map Channels, click the pencil icon next to a channel, and choose its matching guide channel. Do the channels you actually watch; you don't need to map all 5,000. Why mismatches happen is explained in What is EPG?

Step 5: Watch on your devices

Install the Jellyfin app on each device (Roku, Fire TV, Android TV and Android phones; on iPhone, Jellyfin Mobile or Swiftfin), sign in to your server, and open Live TV. On Apple TV, check the App Store for the current Jellyfin client, or use UHF, which can read Jellyfin libraries directly. You'll get a guide grid, channel list and, if you set up recording, a recordings section.

Recording

Jellyfin includes DVR features: pick a programme in the guide and record it, or set series recordings. Recordings save to the server's storage, so make sure the drive has room, and play back on any device. Each recording uses one of your service's connections, just like watching, so the stream limit you set in step 2 matters. The same connection-limit logic is explained in recording in TiviMate.

When things go wrong

• Channels load but won't play: test the playlist in VLC on the server itself (VLC guide). If VLC fails, the playlist or service is the problem.
• Stuttering on some devices: the server may be converting (transcoding) video for that device. A faster server, or enabling hardware acceleration in Jellyfin's playback settings, helps.
• Blank guide: check the XMLTV URL loads in a browser, refresh guide data, then map channels. More in EPG not working.