Short answer: Linux is one of the best desktop platforms for IPTV, because the strongest players, VLC, Kodi, mpv and Hypnotix, are free, open source and in every major distribution's repositories. The catch is not playback but DRM: many licensed live-TV services rely on browser DRM, so they work in Chrome or Firefox but not in open players.
At a glance
IPTV on Linux
| Quickest start | VLC: open your provider's M3U URL |
| Friendliest player | Hypnotix (Linux Mint) |
| TV-style interface | Kodi with PVR IPTV Simple Client |
| Licensed services | Use Chrome or Firefox for DRM |
| Install via | Distro repositories or Flathub |
Two kinds of IPTV, two kinds of software
It helps to separate what you are trying to watch.
Licensed streaming services such as YouTube TV, Sling TV, BBC iPlayer or DAZN run in a web browser with Widevine DRM. On Linux, Chrome and Firefox both support it, although some services cap resolution on Linux browsers.
Playlists and logins from your provider come as an M3U URL, an Xtream Codes-style login, or both, often with an EPG (programme guide) URL. These need a player app, and Linux has excellent ones.
A player app is just a player. It contains no channels of its own and should only be used with a lawful source.
A third category is broadcast TV. If you have an aerial or satellite dish, a USB or network tuner with Tvheadend or Kodi's own PVR back-ends turns free-to-air broadcasts into a stream you can watch on any device in the house. It is a fully legal form of home IPTV and a popular Linux project in its own right.
The main Linux players compared
| Player | Best for | Playlist | Xtream login | EPG guide |
|---|---|---|---|---|
| VLC | Quick testing, any format | Yes | No | No |
| mpv | Minimal, scriptable playback | Yes | No | No |
| Hypnotix | Simple TV-style browsing | Yes | Yes | Basic |
| Kodi + PVR IPTV Simple | Full-screen, remote-friendly | Yes | Via add-on | Yes, full grid |
All four are free and open source. Hypnotix is Linux Mint's own project and ships preconfigured with Free-TV, a list of publicly available, legally broadcast channels, which is a useful way to test it.
VLC and mpv: the fastest start
VLC. Install from your package manager (apt install vlc, dnf install vlc) or Flathub. Media → Open Network Stream, paste the M3U URL, and the playlist appears in the sidebar. It is the best tool for checking whether a stream works at all.
mpv. Run mpv followed by the playlist URL in a terminal. It starts instantly, uses hardware decoding with the --hwdec=auto option, and is what Hypnotix uses under the hood.
Neither has a guide. For a channel grid with programme names, move up to Hypnotix or Kodi.
Test with a known-good source. Before troubleshooting a provider's playlist, open a public, legal stream such as a broadcaster's own live feed or an entry from the Free-TV list. If that plays and the provider's does not, the problem is on the provider's side.
Hypnotix: the easy option
Hypnotix comes preinstalled on Linux Mint and is packaged for several other distributions.
Add a provider from the menu: choose M3U URL, Xtream API or local M3U file, and enter the details your provider gave you.
Remove the default Free-TV provider if you do not want it, or keep it for free-to-air channels.
It handles live TV, films and series separately when the provider supports those categories through Xtream.
On distributions other than Mint, check your repositories first, then the project's GitHub page for packages.
Favourites and search are built in, and Hypnotix remembers the last channel you watched. For a household with one main provider, it is the least fiddly option on the desktop.
It is not a full guide. Hypnotix shows programme information where the provider supplies it, but not a Kodi-style grid across all channels. If you rely on a guide to plan viewing, Kodi is the better choice.
Kodi: the living-room option
Kodi turns a Linux machine into a full-screen, remote-controlled media centre, which is ideal for a PC connected to the television.
Install Kodi from your distribution or Flathub (tv.kodi.Kodi).
Add the PVR IPTV Simple Client from Add-ons → Install from repository → PVR clients. On some distributions it is a separate package, such as kodi-pvr-iptvsimple.
Configure it with your M3U URL and EPG URL, then restart Kodi. Channels appear under TV with a full programme guide.
Stick to the official Kodi repository. Third-party add-on packs are a common route to unlicensed content and malware, and Kodi's own team does not support them.
Recording is possible with a back-end such as Tvheadend, which can record IPTV streams you are entitled to as well as broadcast channels. It is more setup, but turns a spare Linux machine into a household video recorder.
Use a remote. Kodi works with cheap USB remotes, CEC through your television's own remote on supported hardware, and official Kodi remote apps on phones.
Hardware decoding and smooth playback
Check hardware decoding. On Intel and AMD graphics, VA-API does the work; on NVIDIA, VDPAU or NVDEC. Running vainfo shows whether VA-API is available.
Flatpak versions include codecs that some distributions leave out for licensing reasons, which saves hunting for extra packages.
Use Ethernet for live TV. A desktop PC usually has a port; use it.
Wayland vs X11. Recent versions of all four players work on Wayland. If you see tearing or a black screen, try the X11 session to rule out a compositor issue.
Low-power hardware is fine. A Raspberry Pi 5 or a small mini-PC running LibreELEC, a Kodi-only Linux distribution, handles HD and most 4K live streams comfortably and uses a fraction of a desktop PC's power.
Keeping it legitimate
Linux users tend to know their software, and that matters here. Every player above is legal; what you point it at determines whether you are watching lawfully.
Licensed: services that own or license the channels, your ISP's TV service, broadcasters' own streams, and lists of free-to-air channels such as Free-TV.
Unlicensed: cheap bundles of thousands of premium channels sold without the rights holders' permission. Sellers are prosecuted in the UK, EU and US, and subscribers risk losing prepaid money.
If you are also using Windows or macOS, our Windows guide and Mac guide cover the same players there.
Free-to-air is a good starting point. Many broadcasters publish their own live streams openly, and community-maintained lists collect only those. They are a lawful way to try every player above before paying for anything.
Installing on the main distributions
| Distribution | VLC | Kodi | Hypnotix |
|---|---|---|---|
| Linux Mint | Preinstalled or apt | apt or Flatpak | Preinstalled |
| Ubuntu / Pop!_OS | apt or Snap | apt or Flatpak | Flatpak or GitHub packages |
| Fedora | Flatpak or RPM Fusion | Flatpak or RPM Fusion | Flatpak |
| Arch / Manjaro | pacman | pacman | AUR or Flatpak |
| Debian | apt | apt | Mint's packages or Flatpak |
Flathub is the common denominator. If your distribution lacks a package or has an old one, the Flatpak version is usually current and includes its own codecs.
Fedora users need extra codecs for some streams, because the default repositories leave out patent-encumbered formats. RPM Fusion or the Flatpak versions solve this.
Troubleshooting
No picture, only sound. Usually a codec or hardware decoding problem. Try the Flatpak version, or turn hardware decoding off in the player's settings to confirm.
Stream opens in a browser but not in VLC. Some providers require a specific user agent. VLC lets you set one under Tools → Preferences → Show settings: All → Input/Codecs → Network; the provider's help pages usually say what to use.
Guide is empty in Kodi. Check the EPG URL, then clear the guide data under Settings → PVR & Live TV → Guide → Clear data, and restart.
Stuttering on a laptop. Power-saving profiles throttle the CPU. Switch to a balanced or performance profile while watching.
Firewall blocks. Firewalls such as UFW rarely interfere with outbound streams, but a corporate or university network may block unusual ports.
Quick answers
What is the best IPTV player for Linux? For most people, Hypnotix or Kodi with the PVR IPTV Simple Client. VLC is best for quick testing.
How do I open an M3U playlist in VLC on Linux? Open VLC, choose Media then Open Network Stream, paste the playlist URL and press Play.
Does Hypnotix work on Ubuntu? Yes, though it is developed for Linux Mint. Check your repositories or the project's GitHub page for packages.
Can I watch YouTube TV or Sling on Linux? Yes, in Chrome or Firefox with DRM enabled. Some services limit resolution on Linux browsers.
How do I get an EPG guide on Linux? Use Kodi with the PVR IPTV Simple Client, and add the EPG URL your provider supplies.
Why is IPTV using so much CPU on Linux? Hardware decoding is probably off. Check VA-API with vainfo and enable hardware decoding in the player's settings.
Is using IPTV on Linux legal? The players are legal. Watching licensed services and lawful playlists is legal; unlicensed channel packages are not.
Package names differ between distributions and change over time, and streaming services adjust their Linux browser support. Check your distribution's repositories. Checked September 2026.