IPTVnator for Linux
A free, open-source IPTV player packaged for every major Linux distribution. Load M3U/M3U8 playlists, sign in to Xtream Codes providers or Stalker portals, and watch live TV, movies and series with a full program guide. Pick the AppImage for a no-install start or a native package for your distribution.
Version 0.23.0 · Released Aug 30, 2026 · Release notes · All files
- x86_64 · arm64 · armv7l
- AppImage · deb · rpm · pacman
- Flatpak & Snap
- Free & open source
Every format, one release
All files below are built from the same commit and published together on GitHub. Choose the one your distribution prefers.
AppImage
Any distribution · x86_64 · 188 MB
No installation, works on any current distribution. Receives in-app update notifications.
Downloadchmod +x iptvnator-*.AppImage && ./iptvnator-*.AppImageDebian / Ubuntu
.deb · amd64 · 127 MB
Ubuntu 24.04+, Debian 12+ and derivatives. Depends on libmpv2 for the embedded MPV engine; on Ubuntu 22.04 use the AppImage.
Downloadsudo apt install ./iptvnator-*-linux-amd64.debFedora / openSUSE
.rpm · x86_64 · 108 MB
Fedora, openSUSE, RHEL-family distributions.
Downloadsudo dnf install ./iptvnator-*-linux-x86_64.rpmArch / Manjaro
.pacman · x64 · 111 MB
Arch Linux, Manjaro and other pacman-based systems. The AUR package iptvnator-bin is an alternative.
Downloadsudo pacman -U ./iptvnator-*-linux-x64.pacmanFlatpak bundle
.flatpak · x86_64 · 122 MB
Sideloadable bundle. Needs the Flathub remote for the org.freedesktop.Platform 24.08 runtime. Embedded MPV is not available inside the sandbox.
Downloadflatpak install --user ./iptvnator-*-linux-x86_64.flatpakSnap
.snap · amd64 · 160 MB
Prefer the Snap Store listing; the file is provided for offline installs. Embedded MPV is not available inside the sandbox.
Downloadsudo snap install iptvnator
AppImage
arm64 (aarch64) · 170 MB
Raspberry Pi 4/5 and other 64-bit ARM boards running a desktop.
Downloadchmod +x iptvnator-*.AppImage && ./iptvnator-*.AppImageDebian / Ubuntu
.deb · arm64 · 120 MB
Debian and Ubuntu on 64-bit ARM.
Downloadsudo apt install ./iptvnator-*-linux-arm64.debAppImage
armv7l (32-bit ARM) · 168 MB
32-bit ARM desktops.
Downloadchmod +x iptvnator-*.AppImage && ./iptvnator-*.AppImageDebian / Ubuntu
.deb · armv7l · 124 MB
Debian and Ubuntu on 32-bit ARM.
Downloadsudo apt install ./iptvnator-*-linux-armv7l.debSnap
.snap · armhf · 143 MB
Snap Store build for 32-bit ARM.
Downloadsudo snap install iptvnator
AppImage in three steps
The fastest way to try IPTVnator on any distribution. Native packages install with the commands listed above.
Run the AppImage
- 1
Download the x86_64 AppImage with the button above.
- 2
Make it executable: right-click › Properties › "Allow executing file as program", or run chmod +x on the file.
- 3
Double-click the AppImage or start it from a terminal. Nothing is installed system-wide; delete the file to remove the app.
- 4
Add your first source: an M3U/M3U8 file or URL, an Xtream Codes login, or a Stalker portal.
sudo snap install iptvnatoryay -S iptvnator-binsudo eselect repository enable gentoo-zh sudo emerge --sync gentoo-zh sudo emerge iptvnator-binLinux specifics
Wayland desktops
Launchers start IPTVnator with --ozone-platform=x11, so Wayland sessions need Xwayland, which GNOME and KDE ship by default. If the app exits with Ozone or Wayland errors, start it with iptvnator --ozone-platform=x11.
Embedded MPV engine
The experimental engine drives your distribution's mpv binary inside the app window on x86_64 under X11 or Xwayland. Install mpv first (for example sudo apt install mpv) and opt in under Settings › Playback. The Flatpak and Snap sandboxes do not expose the host mpv, so the engine stays unavailable there.
chrome-sandbox error on some .deb / .rpm systems
If the app aborts with "The SUID sandbox helper binary was found, but is not configured correctly", run sudo chown root:root chrome-sandbox and sudo chmod 4755 chrome-sandbox in the installation directory once, or start the app with --no-sandbox.
Ubuntu 22.04 and older Debian
The x86_64 .deb depends on libmpv2, which Ubuntu 22.04 does not ship. Use the AppImage there; it bundles everything it needs.
What you get on your desktop
The complete desktop feature set. Everything below works in the native Linux packages.
M3U, Xtream Codes and Stalker
Import M3U/M3U8 playlists from a file or URL, or sign in to Xtream Codes and Stalker/Ministra portals. Live TV, movies and series land in one library with favorites, history and search.
Program guide (EPG)
Attach an XMLTV guide to see what is on now and next, browse the multi-channel timeline under the player, and jump into catch-up where your provider offers it.
MPV and VLC integration
Hand streams that the built-in players cannot decode to the mpv or vlc binary from your distribution. Playback positions and the remote control stay inside IPTVnator.
Embedded MPV engine (experimental)
Drives the system mpv inside the IPTVnator window on x86_64 desktops under X11 or Xwayland. Requires mpv on PATH; not available in the Flatpak and Snap sandboxes.
Offline downloads
Save movies and episodes from Xtream and Stalker sources to disk. The download manager resumes interrupted transfers and keeps a local library.
Movie and series metadata
Optional TMDB enrichment adds posters, plots, cast, ratings and trailers to movie and series details. Off by default, one switch in Settings.
Remote control from your phone
Open the built-in remote-control web app on your phone to switch channels, adjust volume and control playback from the couch.
Self-hosted browser version
Run the web app and its backend from one Docker image on a home server and open it from any browser on your network.
No account, no tracking
There is nothing to sign up for. Playlists and credentials stay in a local database under your home directory, and the app sends no analytics.
What you need
- Distributions
- Any current x86_64 distribution via AppImage; native packages for Debian/Ubuntu, Fedora/openSUSE and Arch/Manjaro; Flatpak and Snap.
- Architectures
- x86_64, arm64 and armv7l (AppImage and .deb); armhf and amd64 (Snap).
- Display server
- X11, or Wayland with Xwayland. Launchers start the app with --ozone-platform=x11.
- .deb dependencies (x86_64)
- libmpv2, libegl1, libgl1, libgbm1. Available on Ubuntu 24.04+ and Debian 12+.
- Account
- None. IPTVnator never asks you to register.
- Content
- Bring your own playlist or provider login. IPTVnator ships without channels.
Questions about IPTVnator on Linux
Which Linux package should I choose?+
Take the AppImage if you want a single file that runs on any distribution without installation and can notify you about updates. Take the .deb, .rpm or pacman package if you want the app in your application menu and managed by your package manager. Flatpak and Snap isolate the app in a sandbox, which also means the embedded MPV engine is unavailable there.
Is IPTVnator on Flathub?+
Not yet. A Flatpak bundle is attached to every release and installs with "flatpak install --user" as long as the Flathub remote is configured, because the bundle needs the org.freedesktop.Platform 24.08 runtime. The Snap Store listing is official and maintained by the project.
The app exits with a chrome-sandbox error. What now?+
Some .deb and .rpm installations need the sandbox helper fixed once: run "sudo chown root:root chrome-sandbox" and "sudo chmod 4755 chrome-sandbox" inside the installation directory. As a fallback, start the app with the --no-sandbox flag.
Does it work on Wayland?+
Yes, through Xwayland. Every launcher starts IPTVnator with --ozone-platform=x11, and GNOME and KDE ship Xwayland by default. If the app exits with Ozone or Wayland errors, start it manually with "iptvnator --ozone-platform=x11".
Does IPTVnator run on a Raspberry Pi or other ARM boards?+
Yes. arm64 and armv7l AppImage and .deb builds are attached to every release, and the Snap Store carries an armhf build. The web players and external MPV/VLC work there; the embedded MPV engine is x86_64 only.
Can I run IPTVnator on a home server instead of installing it?+
Yes. The Docker image builds the browser version and its backend into one container; the README in the docker directory has the compose file. The browser version does not include the desktop-only features such as external players, embedded MPV and the download manager.
Does IPTVnator come with channels or playlists?+
No. IPTVnator is a player. You add your own M3U/M3U8 playlist, Xtream Codes login or Stalker portal from your provider. Any website selling "IPTVnator subscriptions" or channel packages is unrelated to this project.
Guides and background
How to Add an Xtream Codes Account to IPTVnator
Connect an Xtream Codes API provider to IPTVnator step by step. What the server URL, username and password are, how to test the login, how to paste the message from your provider, and what to do when the portal refuses to connect.
Read more
Why some streams need an external player
Why some IPTV streams do not play in IPTVnator's built-in browser players, and when MPV, VLC, or IINA is the right workaround.
Read more
Beware of Unofficial IPTVnator Websites and IPTV Services
IPTVnator is a free, open-source player app. It never sells IPTV subscriptions, channels, or playlists. Here is how to recognize unofficial sites misusing the name, and where to get the real app.
Read moreOfficial downloads only
IPTVnator is a player, not a TV service. It is distributed exclusively through GitHub releases and the package managers listed on this page. Websites that sell "IPTVnator subscriptions", channel packages or "activated" copies are not affiliated with the project. How to recognize unofficial sites.