# 4gray/iptvnator **Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/4gray-iptvnator).** 5,611 stars · 697 forks · TypeScript · mit ## Links - GitHub: https://github.com/4gray/iptvnator - Homepage: https://iptvnator.vercel.app - awesome-repositories: https://awesome-repositories.com/repository/4gray-iptvnator.md ## Topics `chromeos` `electron` `epg` `fair-source` `iptv` `iptv-m3u` `iptv-player` `iptv-player-application` `linux` `m3u` `m3u8` `macos` `player` `player-video` `playlist` `pwa` `snap` `tauri` `tv` `video` ## Description Iptvnator is an Electron-based desktop application for streaming live television and radio. It serves as an IPTV player and playlist manager that supports M3U, Xtream Codes, and Stalker portals, providing a unified interface for organizing and viewing media lists. The application functions as both an internal player and an external player wrapper, allowing users to hand off stream URLs to native third-party media players to bypass browser codec limitations. It includes a dedicated XMLTV program guide that maps external schedule data to live channels for broadcast discovery and catchup features. Additional capabilities include tools for managing channel favorites, recording live streams, and searching across multiple playlists. The interface features a command palette for quick navigation and supports custom network headers to ensure compatibility with various streaming providers. The project is developed using TypeScript. ## Tags ### Graphics & Multimedia - [Cross-Platform Media Players](https://awesome-repositories.com/f/graphics-multimedia/cross-platform-media-players.md) — A cross-platform desktop application that plays IPTV streams from multiple sources and protocols. - [Desktop IPTV Players](https://awesome-repositories.com/f/graphics-multimedia/desktop-iptv-players.md) — A cross-platform desktop application that plays IPTV streams from M3U playlists, Xtream Codes, and Stalker portals using an embedded MPV engine. - [Media Playback Controls](https://awesome-repositories.com/f/graphics-multimedia/media-playback-controls.md) — The IPTV player provides native UI controls for play, pause, seek, volume, fullscreen, audio tracks, subtitles, and live recording. ([source](https://4gray.github.io/iptvnator/blog/embedded-mpv-macos-experiment/)) - [Media Streaming Engines](https://awesome-repositories.com/f/graphics-multimedia/media-processing-analysis/media-manipulation/media-processing/streaming-network-frameworks/media-streaming-engines.md) — Renders IPTV streams inside the app window with low-latency playback using a bundled libmpv native addon. - [M3U Playlist Managers](https://awesome-repositories.com/f/graphics-multimedia/streaming-distribution/streaming-broadcasting/media-streaming/playlist-aggregators/m3u-playlist-managers.md) — Imports, organizes, and searches M3U/M3U8 playlists for live TV and radio channels. - [External Player Launchers](https://awesome-repositories.com/f/graphics-multimedia/external-player-launchers.md) — Launches external media players like VLC or MPV when the embedded engine cannot decode a stream. - [Playlist Searches](https://awesome-repositories.com/f/graphics-multimedia/streaming-distribution/streaming-broadcasting/media-streaming/playlist-aggregators/personal-playlist-managers/audio-playlist-managers/playlist-searches.md) — Provides full-text search across all imported playlists to quickly find specific channels. ([source](https://4gray.github.io/iptvnator/)) - [WebSocket Music Controllers](https://awesome-repositories.com/f/graphics-multimedia/websocket-music-controllers.md) — Exposes a WebSocket endpoint allowing mobile devices to send playback commands to the desktop player. ### Content Management & Publishing - [Electronic Program Guides](https://awesome-repositories.com/f/content-management-publishing/media-management/electronic-program-guides.md) — Displays current and upcoming program schedules from XMLTV data alongside live TV channels. - [IPTV & Live TV](https://awesome-repositories.com/f/content-management-publishing/media-management/iptv-live-tv.md) — The IPTV player plays live TV and radio channels from M3U playlists, Xtream Codes, and Stalker portal sources with embedded or external players. ([source](https://cdn.jsdelivr.net/gh/4gray/iptvnator@master/README.md)) - [XMLTV Parsers](https://awesome-repositories.com/f/content-management-publishing/media-management/electronic-program-guides/epg-data-providers/xmltv-parsers.md) — Parses XMLTV schedule files and displays current and upcoming program schedules alongside the channel list. - [Catch-Up TV Playback](https://awesome-repositories.com/f/content-management-publishing/media-management/iptv-live-tv/catch-up-tv-playback.md) — The IPTV player supports catch-up TV and time-shifted playback for archived programs when the source provides it. ([source](https://cdn.jsdelivr.net/gh/4gray/iptvnator@master/README.md)) ### Development Tools & Productivity - [M3U Playlist Editors](https://awesome-repositories.com/f/development-tools-productivity/playlist-managers/m3u-playlist-editors.md) — Imports M3U and M3U8 playlists from local files or remote URLs to populate channel lists. ([source](https://4gray.github.io/iptvnator/)) - [IPTV Provider API Integrations](https://awesome-repositories.com/f/development-tools-productivity/rest-apis/code-hosting-api-integrations/iptv-provider-api-integrations.md) — The IPTV player connects to Xtream Codes API providers to authenticate and access live TV, video-on-demand, and series content. ([source](https://4gray.github.io/iptvnator/)) - [External Player Launchers](https://awesome-repositories.com/f/development-tools-productivity/open-source-software/open-source-media-players/external-player-launchers.md) — The IPTV player launches streams in external players such as MPV, VLC, or IINA with configurable instance reuse for multiple streams. ### Networking & Communication - [IPTV Portal Integrations](https://awesome-repositories.com/f/networking-communication/iptv-portal-integrations.md) — The IPTV player authenticates with Stalker or Ministra portals to browse and play available live TV and radio streams. ([source](https://4gray.github.io/iptvnator/)) - [IPTV Provider Integrations](https://awesome-repositories.com/f/networking-communication/iptv-provider-integrations.md) — Connects to IPTV services via Xtream Codes, Stalker Portal, or M3U playlists from a single interface. - [Command Bridges](https://awesome-repositories.com/f/networking-communication/connection-management/websocket-connection-managers/command-bridges.md) — Exposes a WebSocket endpoint that allows mobile devices to send playback commands to the desktop player. ### Programming Languages & Runtimes - [Node.js Native Addons](https://awesome-repositories.com/f/programming-languages-runtimes/node-js-native-addons.md) — Embeds a libmpv native addon within Electron for low-latency video playback. ### Software Engineering & Architecture - [IPTV Provider Adapters](https://awesome-repositories.com/f/software-engineering-architecture/provider-abstractions/iptv-provider-adapters.md) — Unifies authentication and channel retrieval across M3U, Xtream Codes, and Stalker portals behind a common interface. ### Web Development - [Embedded MPV](https://awesome-repositories.com/f/web-development/client-side-media-processing/playback-engines/embedded-mpv.md) — The IPTV player embeds a libmpv engine for low-latency playback of IPTV streams directly within the app window. ### Part of an Awesome List - [Multi-Window Stream Players](https://awesome-repositories.com/f/awesome-lists/media/video-playback/multi-window-stream-players.md) — The IPTV player can run multiple streams simultaneously in separate player windows for side-by-side viewing. ([source](https://4gray.github.io/iptvnator/blog/why-external-players-help/)) ### DevOps & Infrastructure - [Docker Container Deployments](https://awesome-repositories.com/f/devops-infrastructure/container-orchestration/container-runtimes/runtime-configuration-interfaces/docker-socket-orchestrators/docker-target-configurators/docker-container-deployments.md) — Available as a Docker container for server-based hosting alongside native desktop support. ### User Interface & Experience - [Multilingual Locale Detection](https://awesome-repositories.com/f/user-interface-experience/link-and-theme-customization/multilingual-locale-detection.md) — The IPTV player supports light and dark themes, 16 languages with automatic locale detection, and custom user-agent headers. ([source](https://cdn.jsdelivr.net/gh/4gray/iptvnator@master/README.md))