Profile
Back to NewsBack
GitHub Trending 3 min
Reader Mode
4gray/iptvnator: :tv: Cross-platform IPTV player application with multiple features, such as support of m3u and m3u8 playlists, favorites, TV guide, TV archive/catchup and more.

4gray/iptvnator: :tv: Cross-platform IPTV player application with multiple features, such as support of m3u and m3u8 playlists, favorites, TV guide, TV archive/catchup and more.

IPTVnator

IPTVnator icon

A free, open-source IPTV player for macOS, Windows, Linux and the browser. Bring your M3U playlists, Xtream Codes account or Stalker portal to watch live TV, browse movies and series, and pick up where you left off.

Download · Website · Getting started · Gallery

Release</a> CI</a> Downloads</a>

!IPTVnator dashboard with continue watching and live favorites in light and dark themes

[!IMPORTANT]
IPTVnator is a player: it does not provide or sell subscriptions, channels,
playlists or other media. Screenshots show demonstration content. Download
only from the official website or
GitHub Releases.
Learn about unofficial websites.

Download

Get the latest stable desktop release from the download page or GitHub Releases.

| macOS | Windows | Linux | | --- | --- | --- | | Apple Silicon / Intel | Installer / portable | AppImage, deb, rpm and more |

For package-manager commands, experimental Linux Embedded MPV support and nightly builds, see Installation.

Features

  • Your sources together: local or remote M3U/M3U8 playlists, Xtream Codes,
and Stalker / Ministra portals.
  • Live TV: channel groups, search and favorites; XMLTV guide, multi-channel
EPG and catch-up on desktop.
  • Movies and series: posters, seasons, watch history and resume positions;
optional TMDB metadata with your own API key.
  • Playback options: built-in web players, external MPV/VLC/IINA and
experimental Embedded MPV on desktop.
  • Watch later: desktop downloads for movies and episodes, plus
continue-watching and favorites across sources.
  • Make it yours: light and dark themes, 21 language options, keyboard
shortcuts and a command palette (Ctrl/Cmd+K).
  • Use your screen: desktop apps, a self-hosted PWA and a phone remote for
the desktop player.

Full feature list and platform limits · Keyboard shortcuts · All screenshots

Self-hosted PWA

Run the browser app and its backend together with Docker:

docker compose -f docker/docker-compose.yml up --build -d

Open . No separate backend container is needed. Connected clients can share source definitions; favorites, history and watch progress stay on each device.

The PWA does not include M3U XMLTV, Embedded MPV, managed external-player launching, the download manager or Electron remote-control features. See Docker setup and client connections for configuration, reverse proxies, playback troubleshooting and platform limits.

For the separate experimental webOS TV client, see TV setup and TV architecture and limitations.

Help and development

playback, downloads and updates. Electron/PWA runs and diagnostics. subsystem contracts; AGENTS.md and the agent workflow cover contribution rules. Telegram / Bluesky.

Support the project

Support development through GitHub Sponsors, Ko-fi, or a star on GitHub.

All Contributors</a>

License and trademark

The source code is MIT licensed. The IPTVnator name and logo are unregistered trademarks of the project owner and are not covered by that license. Forks and redistributions, including app-store submissions, must use a different name and their own icon. See TRADEMARK.md.

Chat with me