4gray

IPTVnator is a cross-platform IPTV player supporting M3U/M3U8 playlists, XMLTV EPG, and Xtream/Stalker sources, built with Electron and Angular and available as a desktop app and installable PWA.

v0.25.0
Published at
5d ago
7,634
Stars
373,647
Download
Synced at
5d ago

Latest release

v0.25.0Nov 8, 2026, 03:30 PM
Downloads slow? Switch the source anytime above

README

Project Overview

IPTVnator is a cross-platform, open-source IPTV player built with Electron and Angular. It imports local or remote M3U/M3U8 playlists and supports XMLTV-format electronic program guides (EPG). The project ships both a desktop app and an installable PWA, plus a Docker self-hosting setup.

Key Features

  • Playlists: import M3U/M3U8 from local files or remote URLs, with automatic updates on startup
  • Sources: Xtream Codes and Stalker/Ministra portals, with a custom User-Agent per playlist
  • Playback: built-in HTML5 player (HLS.js / Video.js), plus external players MPV, VLC, IINA, and embedded MPV
  • Live TV & EPG: XMLTV TV guide, multi-channel grid, and catch-up/timeshift
  • VOD: movie and series detail pages, season tabs, resume positions, and an offline download manager
  • Organization: per-playlist and global favorites, watch history, and a command palette
  • Platform: cross-platform desktop (Electron) and PWA, with built-in auto-updater and mobile remote control
  • Languages: 19 languages, light/dark themes, and keyboard shortcuts

Target Audience

  • Users who want to manage IPTV playlists and EPGs in one place
  • Users watching live and on-demand video on desktop and in the browser
  • Users who need to self-host an IPTV frontend

Quick Start

  1. Download the installer for your platform from GitHub Releases or the official website
  2. Alternatively install via Homebrew, Snap, AUR, or the Gentoo overlay
  3. Open the app and import a local or remote M3U/M3U8 playlist
  4. Configure an XMLTV URL in settings if you need an EPG

Core Advantages

  • Fully open source and free; it never sells IPTV subscriptions or channels
  • Desktop and PWA forms, with Docker self-hosting
  • Strong compatibility via external players and embedded MPV
  • Modern UI with multi-language and light/dark theme support

System Requirements

  • OS: Windows, macOS, Linux
  • Additional dependencies: Linux embedded MPV requires mpv on the system; network access for remote playlists and EPG

Notes

  • This project is only a player and bundles no channels or playlists
  • Get installers only from the official website or GitHub Releases; third-party activated builds are unrelated to this project

Release history

Sort