iptvnator: Play IPTV Streams Across Devices

Overview

IPTVnator is a cross-platform IPTV player for people who already have playlist or portal details and want one application to browse and play them. It supports M3U/M3U8 playlists and Xtream Codes and Stalker portals, with optional XMLTV guide data.

The project brings live TV, catch-up, radio, and video-on-demand into a desktop app, with an installable PWA and a Docker-based self-hosting option. It does not supply channels, playlists, or subscriptions, so it is useful when you have legitimate sources to connect and want playback and organization tools rather than content discovery from a provider.

Key Features

• Import M3U/M3U8 playlists from local files or remote URLs, with automatic updates on startup.
• Connect Xtream Codes and Stalker / Ministra portals.
• Play streams with built-in HTML5 players or use external MPV, VLC, and IINA players on desktop.
• Browse XMLTV program guides and TV catch-up on desktop.
• Organize channels and content with groups, search, favorites, and recently viewed history.
• Browse movies and series, including resume positions and desktop downloads.
• Run the web app as an installable PWA or self-host it with Docker.

Use Cases

• IPTV viewers who have M3U playlists and want a desktop player with channel search and favorites.
• People using compatible Xtream or Stalker portals who want live TV and VOD in one interface.
• Viewers who have XMLTV data and want a guide or catch-up features in the desktop app.
• Home users who prefer to run the PWA and its web backend themselves with Docker.

Getting Started

Download a desktop release for macOS, Windows, or Linux from the GitHub Releases page, or install with Homebrew:

brew install iptvnator

For Docker setup, platform-specific packages, and development instructions, see the README and project website.

Considerations

• You must provide your own playlists, portal access, and guide data. The project does not provide IPTV content or subscriptions.
• Some features, including the EPG panels, catch-up, downloads, external player integration, and remote control, are desktop-only. The self-hosted PWA does not include several Electron-specific features.
• Embedded MPV is experimental. On Linux it is limited to x64 desktop sessions using X11 or Xwayland, and requires mpv on the system path.
• IPTVnator is MIT-licensed, but the project name and logo are not covered by that license. Forks and redistributions must use a different name and icon.