: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.
6.5k
Stars
840
Forks
208
Open issues
30
Contributors
AI Analysis
IPTVnator is a cross-platform IPTV player application built with Electron and Angular that enables users to stream IPTV playlists (m3u/m3u8 formats) with EPG support, TV archive/catchup, and favorites management. It serves end-users who want to consume IPTV content across desktop and mobile platforms, and is specifically designed for the streaming/media consumption niche—not for general audiences or non-IPTV workflows.
Inferred from signals mentioned in the README (tests, CI, type safety) — not a review of the actual code.
AI's overall editorial judgment — not an average of the bars above, can weigh other factors too.
Open-source cross-platform IPTV player with EPG, Xtream, and Stalker support — actively maintained since 2019
IPTVnator is a desktop and web IPTV player built with Electron and Angular, targeting cord-cutters and IPTV enthusiasts who want a self-contained, open-source client for m3u/m3u8 playlists. It covers the full stack of IPTV consumption: playlist management, EPG/TV guide, catchup/timeshift, Xtream Codes, Stalker portal, external player delegation (MPV, VLC), and a Docker-deployable PWA mode. With 6,354 stars, 813 forks, 16 localizations, and consistent recent pushes, it sits comfortably as one of the most feature-complete open-source IPTV clients available across Windows, macOS, and Linux.
Created in October 2019 as a personal side project, IPTVnator has grown steadily over nearly seven years from a basic m3u viewer into a multi-protocol IPTV client with EPG, catchup, external player support, and a self-hostable web mode.
Growth appears driven by the lack of polished, open-source, cross-platform IPTV clients. Word-of-mouth in IPTV communities, a Telegram channel, and consistent feature additions (Xtream Codes, Stalker, Docker, MPV integration) have attracted a loyal user base. 80 stars in the past 7 days suggests ongoing organic discovery. The project's scope expansion from simple player to multi-protocol client likely drove retention and referral within niche communities.
GitHub download count badge is present but total figure not visible in the excerpt. 813 forks and a Telegram community channel suggest real-world deployment by a non-trivial user base. Adoption not verified at organizational or enterprise scale, but consumer/enthusiast adoption appears substantial based on star velocity and fork count.
Likely an Electron shell wrapping an Angular SPA, with a shared codebase that also supports a standalone PWA/web mode deployable via Docker. Appears to use HLS.js and Video.js for in-browser playback, with IPC bridging to MPV for desktop-native playback. The monorepo structure (apps/website path referenced in README) suggests an Nx or similar workspace setup.
A Codecov badge is present in the README, indicating automated test coverage reporting is set up. Exact coverage percentage is not stated in the README excerpt, but the presence of a CI workflow (build-and-test.yaml) implies a functioning test pipeline.
Last push was 2026-06-22, three days before the evaluation date — actively maintained. The README is detailed, structured, and includes recent features like IINA support notes and context menu actions, indicating ongoing feature development rather than mere bug fixes. A Telegram channel and social presence (Bluesky) suggest the maintainer is engaged with the community.
ADOPT IF: you are an IPTV enthusiast or developer who needs a feature-rich, actively maintained, cross-platform open-source IPTV client that supports m3u playlists, Xtream Codes, Stalker portals, EPG, and catchup — especially on desktop. AVOID IF: you need a polished commercial-grade app with formal support, or require mobile platforms (iOS/Android), or your streams need heavy transcoding rather than direct playback. MONITOR IF: you are building a self-hosted IPTV infrastructure and considering the Docker/PWA mode for team or household use — the feature set is promising but production-scale reliability of the web backend is not well-documented.
Independent dimensions
Mainstream potential
4/10
Technical importance
6/10
Adoption evidence
5/10
- Single-maintainer dependency: the project appears to rely primarily on one developer (4gray), creating a bus-factor risk for long-term sustainability.
- Electron bundle size and resource overhead may deter users on lower-end hardware compared to lighter native alternatives like open-tv.
- IPTV ecosystem fragmentation (provider-specific quirks, DRM, non-standard stream formats) means real-world playback reliability varies significantly by provider and is outside the project's control.
- Legal and platform risk: IPTV consumption tools face increasing scrutiny in some jurisdictions; app distribution via stores may be constrained, though the project is careful to note it provides no content.
- Angular and Electron dependency upgrades can introduce breaking changes; keeping the stack current is an ongoing maintenance burden that could slow feature development over time.
IPTVnator is likely to continue growing at a steady pace within the IPTV enthusiast niche, potentially expanding its Docker/web mode. Unlikely to break into mainstream app stores or achieve mass-market adoption, but appears well-positioned to remain the reference open-source desktop IPTV client for the foreseeable future.
Explore similar
Newsletter
Get analyses like this every Monday
Free weekly digest of the most interesting open-source discoveries.
Languages
Information
- Language
- TypeScript
- License
- MIT
- Last updated
- 3d ago
- Created
- 82mo ago
- Analyzed with
- anthropic/claude-haiku-4-5
Stars over time
Contributors over time
Top 100 contributors only — repos with more will plateau at 100.
Open issues
Similar repos
chrisbenincasa/tunarr
Tunarr is a self-hosted IPTV platform that creates custom live TV channels from...
| Repository | Stars | Week Δ | Language | Score | Updated |
|---|---|---|---|---|---|
|
4gray/iptvnator
this
|
6.5k | +115 | TypeScript | 7/10 | 3d ago |
 iptv-org/iptv
|
132k | — | TypeScript | 7/10 | 12h ago |
 Free-TV/IPTV
|
19.1k | — | Python | 6/10 | 3d ago |
 oxyroid/M3UAndroid
|
1.2k | — | Kotlin | 7/10 | 1w ago |
|
chrisbenincasa/tunarr
|
2.4k | — | TypeScript | 8/10 | 1w ago |
 vbskycn/iptv
|
7.1k | — | HTML | 6/10 | 8h ago |
A newer Rust-based IPTV player with 3,575 stars. Likely lighter and faster due to native Rust, but appears to have fewer features (no Stalker, less mature EPG). IPTVnator is more feature-complete and has a longer track record.
Kodi is a full media center with IPTV via plugins — much heavier and more complex to configure. IPTVnator is purpose-built for IPTV, easier to set up, but lacks Kodi's broader media library and plugin ecosystem.
Not a player — it is a massive curated playlist collection. Complementary to IPTVnator rather than competing; users can load iptv-org playlists into IPTVnator.
VLC can play m3u streams but has no IPTV-specific UX: no EPG, no catchup, no channel grouping, no Xtream support. IPTVnator delegates heavy-duty playback to VLC/MPV while providing the IPTV management layer VLC lacks.
Jellyfin's Live TV requires a tuner/backend and is server-centric. IPTVnator is client-only, far simpler to set up for pure IPTV streams, but lacks Jellyfin's transcoding and multi-user server capabilities.
