How to Use Xtream Codes on Linux (Kodi, VLC, IPTV Smarters)

Linux has no native Xtream Codes application, but the platform is well served by three solid routes: Kodi with the IPTV Simple Client, IPTV Smarters Pro (Linux build), and VLC with an M3U playlist. This guide covers all three.

Route 1 — Kodi with the IPTV Simple Client

Kodi is the most capable option for Linux:

1. Install Kodi from your distro’s package manager or Flatpak.
2. In Kodi, install PVR IPTV Simple Client from the official repository.
3. Configure it with your provider’s M3U playlist URL — see Xtream Codes M3U.
4. Set the XMLTV URL to your provider’s xmltv.php for the guide.

The full walkthrough is in the Kodi + Xtream Codes guide.

Route 2 — IPTV Smarters Pro (Linux build)

1. Download the IPTV Smarters Pro Linux package from the official site (deb, rpm, or AppImage).
2. Install it with your distro’s package manager.
3. Open the app, choose Xtream Codes, and enter your host, username, and password.

Route 3 — VLC with an M3U playlist

1. Install VLC from your package manager.
2. Get your M3U playlist URL from your provider.
3. Press Ctrl+L, paste the URL, and pick a channel from the playlist.

VLC is the lightest option for a quick test, with no guide or categories.

Linux-specific notes

• Flatpak apps and network access: if a Flatpak player can’t reach your provider, grant it network access in Flatseal (or flatpak override --user --socket=network <app>).
• Firewall: allow your player through if you use a local firewall like ufw.
• Package sources: prefer your distro’s official repository or the app’s official download page. Unofficial PPAs and AUR helpers can ship tampered builds.
• Playlist URL security: the M3U URL can embed your username and password. Keep .m3u files in a private directory and don’t share them.

Which Linux route should you pick?

Need	Best choice
Full media-center experience	Kodi + IPTV Simple Client
Simple portal login app	IPTV Smarters Pro (Linux build)
Quick channel test	VLC + M3U URL
Headless / server	None recommended — use a player on a client device

Common Linux problems

• Kodi shows no channels — confirm the IPTV Simple Client is enabled in the PVR settings and Kodi was restarted after adding the playlist.
• Flatpak player can’t connect — grant network access (see note above); Flatpak sandboxes deny it by default.
• VLC won’t open the playlist — the URL may contain characters the shell ate; quote the URL when pasting.
• Audio missing on some channels — try switching the player’s audio output to PCM or ALSA in its settings.
• No guide in Kodi — set the XMLTV URL in the IPTV Simple Client settings and restart Kodi.

Keep it safe

• Use your own authorized account and content only.
• Install only from official sources — unofficial “IPTV” packages are a common Linux malware vector.
• Treat your playlist URL like a password; see Xtream Codes security.

Related reading

• Kodi + Xtream Codes — the full Kodi setup walkthrough.
• Xtream Codes M3U — what the playlist is and how the URL is built.
• Xtream Codes setup — the generic four-step setup.