IPTVnator is a cross-platform IPTV player application designed for streaming IPTV content by supporting m3u and m3u8 playlists.
Key Features:
Supports playback of IPTV playlists (m3u, m3u8) with seamless integration.
Offers favorites management to easily bookmark frequently watched channels.
Includes a TV guide for scheduling and live channel browsing.
Provides TV archive/catch-up functionality to access missed content.
Multi-language support for global accessibility.
Parental controls to restrict access to mature content.
Can be installed via winget for easy setup on supported systems.
Audience & Benefit:
Ideal for IPTV users seeking a reliable, feature-rich application to enjoy live TV and archived content with enhanced customization and control.
IPTVnator is a video player application that provides support for IPTV playlist playback (m3u, m3u8). The application allows users to import playlists using remote URLs or by uploading files from the local file system. Additionally, it supports EPG information in XMLTV format which can be provided via URL.
The application is a cross-platform, open-source project built with Electron and Angular.
⚠️ Note: IPTVnator does not provide any playlists or other digital content. The channels and pictures in the screenshots are for demonstration purposes only.
Features
M3u and M3u8 playlist support 📺
Radio playlist support with dedicated audio player 📻
Xtream Code (XC) and Stalker portal (STB) support
External player support - MPV, VLC
Add playlists from the file system or remote URLs 📂
Older unsigned macOS builds may require removing the quarantine flag from the downloaded application:
xattr -c /Applications/IPTVnator.app
Alternatively, if the app is located in a different directory:
xattr -c ~/Downloads/IPTVnator.app
Linux: chrome-sandbox Issues
If you encounter the following error when launching IPTVnator:
The SUID sandbox helper binary was found, but is not configured correctly.
Rather than run without sandboxing I'm aborting now.
You need to make sure that chrome-sandbox is owned by root and has mode 4755.
Solution 1: Fix chrome-sandbox permissions (Recommended for .deb/.rpm installations)
Navigate to the IPTVnator installation directory and run:
Save the file and relaunch the application from your application menu.
Alternatively, you can launch IPTVnator from the terminal with the flag:
iptvnator --no-sandbox
GNU/Linux: Wayland startup failure
If IPTVnator exits on GNU/Linux with errors about failing to connect to
Wayland or initialize the Ozone platform, force X11/XWayland instead:
iptvnator --ozone-platform=x11
This workaround is mainly for older or problematic Linux graphics stacks. The
Snap package already includes this X11 override by default. For AppImage,
direct binaries, and other Linux package formats, pass the flag manually when
needed.
How to Build and Develop
Requirements:
Node.js with pnpm (via Corepack)
Clone this repository and install project dependencies:
$ corepack enable
$ pnpm install
Start the application:
$ pnpm run serve:backend
This will open the Electron app in a separate window, while the Angular dev server will run at http://localhost:4200.
The equivalent Nx command is:
$ nx serve electron-backend
If you need to debug renderer freezes or GPU/compositor issues in Electron, you
can disable hardware acceleration for a run:
$ IPTVNATOR_DISABLE_HARDWARE_ACCELERATION=1 pnpm run serve:backend
If you need startup diagnostics for a white screen or a frozen route, you can
also turn on opt-in Electron tracing. These logs are written to the Electron
terminal output so they still help when the renderer DevTools never open:
$ IPTVNATOR_TRACE_STARTUP=1 pnpm run serve:backend
