How to Install IPTV on Linux
Linux doesn't have a single unified app store the way Windows or macOS increasingly do, so IPTV on Linux comes down to one of two practical routes: a general media player you likely already have, or a dedicated IPTV player installed separately.
What you need
- A Linux distribution with a desktop environment and internet access
- A stable connection for your target resolution
- Your FREEGOIPTV4K M3U playlist URL or Xtream Codes login details
Option 1: VLC Media Player
VLC comes preinstalled on many Linux distributions, or is available through your distribution's package manager or software center. It can open an M3U playlist directly and play every channel in the list, though it won't show an EPG or accept an Xtream Codes login.
- Open VLC and go to Media → Open Network Stream
- Paste your M3U playlist URL into the network URL field
- Click Play — VLC will load the playlist as a queue you can browse
Option 2: A dedicated IPTV player
For an Electronic Program Guide, categories and Xtream Codes login support, a dedicated IPTV player app is worth the extra install. Many are distributed for Linux as a Flatpak or AppImage, which install the same way regardless of which distribution you're running.
- Download the player from its official source, matching the Flatpak or AppImage format your distribution supports
- For an AppImage, make the file executable (right-click → Properties → Permissions, or chmod +x from a terminal) before running it
- Open the app and choose to add a playlist or log in
- Enter your M3U URL, or your Xtream Codes username, password and server address
- Wait for the channel list to load, then start watching
Troubleshooting
Playback stutters in VLC
Open Tools → Preferences → Input / Codecs and confirm hardware-accelerated decoding is enabled, then restart VLC. This noticeably reduces stutter on lower-powered hardware.
AppImage won't launch
This is almost always a missing executable permission. Run chmod +x on the file from a terminal, then try launching it again.