discover · compare · collections · requirements · contribute · feed · watching · stats · help with your tokens
4gray/iptvnator · source
Snapshot 0 · 2026-11-04T12:47:26Z · TypeScript · MIT
Content fingerprint
3a7fdfdc8b4dc244fb71a51b9dfbbac0bc55507130f1747512fc60a26837ce7fGitHub description at capture
: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.
README at capture
# IPTVnator <p align="center"> <img src="./apps/web/src/assets/icons/favicon.256x256.png" width="96" height="96" alt="IPTVnator icon" /> </p> **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](https://4gray.github.io/iptvnator/download/)** · [Website](https://4gray.github.io/iptvnator/) · [Getting started](https://4gray.github.io/iptvnator/guides/) · [Gallery](docs/screenshots.md) [](https://github.com/4gray/iptvnator/releases) [](https://github.com/4gray/iptvnator/actions/workflows/ci.yml) [](https://github.com/4gray/iptvnator/releases)  > [!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](https://4gray.github.io/iptvnator/) or > [GitHub Releases](https://github.com/4gray/iptvnator/releases). > [Learn about unofficial websites](https://4gray.github.io/iptvnator/blog/beware-unofficial-iptvnator-websites/). ## Download Get the latest stable desktop release from the [download page](https://4gray.github.io/iptvnator/download/) or [GitHub Releases](https://github.com/4gray/iptvnator/releases). | macOS | Windows | Linux | | --- | --- | --- | | [Apple Silicon / Intel](https://4gray.github.io/iptvnator/download/macos/) | [Installer / portable](https://4gray.github.io/iptvnator/download/windows/) | [AppImage, deb, rpm and more](https://4gray.github.io/iptvnator/download/linux/) | For package-manager commands, experimental Linux Embedded MPV support and nightly builds, see [Installation](docs/installation.md). ## 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](docs/features.md) · [Keyboard shortcuts](docs/keyboard-shortcuts.md) · [All screenshots](docs/screenshots.md) ## Self-hosted PWA Run the browser app and its backend together with Docker: ```bash docker compose -f docker/docker-compose.yml up --build -d ``` Open <http://localhost:4333>. 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](docker/README.md) for configuration, reverse proxies, playback troubleshooting and platform limits. For the separate experimental webOS TV client, see [TV setup](docs/development/tv-development.md) and [TV architecture and limitations](docs/architecture/tv-application.md). ## Help and development - [User guides](https://4gray.github.io/iptvnator/guides/) — sources, EPG, playback, downloads and updates. - [Troubleshooting](docs/troubleshooting.md) — macOS and Linux startup fixes. - [Build and develop](docs/development/README.md) — Node/pnpm setup, local Electron/PWA runs and diagnostics. - [Developer and agent documentation](docs/maintenance/agent-context-map.md) — subsystem contracts; [AGENTS.md](AGENTS.md) and the [agent workflow](docs/development/agent-workflow.md) cover contribution rules. - [Report a bug](https://github.com/4gray/iptvnator/issues) or join [Telegram](https://t.me/iptvnator) / [Bluesky](https://bsky.app/profile/iptvnator.bsky.social). ## Support the project Support development through [GitHub Sponsors](https://github.com/sponsors/4gray), [Ko-fi](https://ko-fi.com/4gray), or a star on GitHub. <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section --> [](https://github.com/4gray/iptvnator/graphs/contributors) <!-- ALL-CONTRIBUTORS-BADGE:END --> ## License and trademark The source code is [MIT licensed](LICENSE.md). 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](TRADEMARK.md).