IPTVnator
4gray · An open-source IPTV player for M3U/M3U8 playlists, Xtream Codes and Stalker portals, with XMLTV guides, favorites and desktop playback options.
brew install --cask iptvnator- 30-day installs
- 320
- #527 in App
- 1-year installs
- 3.6K
- Last 365 days
- Latest version
- 0.25.0
- Download size
- 219MB
- dmg
- Release cadence
- Monthly
- 1 release in 30 days
About
IPTVnator is a cross-platform IPTV player built with Electron and Angular. Import an M3U or M3U8 playlist from a local file or remote URL, or connect an Xtream Codes or Stalker/Ministra portal. XMLTV guide information can be supplied by URL. The application does not provide channels, playlists or subscriptions; users must supply content they are authorized to access.
Playback and organization
The official project documents built-in HTML5 playback, external players including MPV, VLC and IINA on macOS, channel search, grouped lists, favorites and watch history. Its desktop workflow includes live TV guides, catch-up support and video-on-demand organization. Some capabilities depend on the playlist provider, release and platform. Experimental features described in the current README are not a guarantee for every recorded build.
Distribution
Official macOS downloads are published on GitHub Releases. The Homebrew cask records version 0.24.0. The project also provides a self-hosted browser PWA, which is distinct from the Electron desktop application and lacks several desktop-only features. Only official project downloads are endorsed: third-party sites selling IPTVnator subscriptions or activated builds are not affiliated with the project.
Sources
- Official project and documentation: https://github.com/4gray/iptvnator
- Official website: https://4gray.github.io/iptvnator/
- Official releases: https://github.com/4gray/iptvnator/releases
- Homebrew: https://formulae.brew.sh/cask/iptvnator
At a glance
- System
- macOS 12 or later
- Chip
- Apple silicon · Intel
- Auto-updates
- Yes
- Repository
- Open source · MIT · Updated 0 days ago★7.8K
- Developer
- 4gray
- Homebrew
- Available; the app updates itself
- Also known as
- iptvnator
- Homepage
- github.com/4gray/iptvnator
- Token
- iptvnator
Checked
What’s new in 1.0.0-7-prerelease
New · From GitHub Releases
v1.0.0-beta.7
What's Changed
-
Reworked Stalker Portal functionality to better align with the Xtream API
-
Improved the Favorites view in both Stalker and Xtream UIs
-
Favorites in M3U playlists now remain saved after refreshing the playlist
-
Added a new video player: ArtPlayer
-
Updated dependencies and applied various small fixes and improvements under the hood
-
feat; add japanese language support i18n by @kiwamizamurai in https://github.com/4gray/iptvnator/pull/519
-
Italian language update by @bovirus in https://github.com/4gray/iptvnator/pull/494
-
Update README.md (add homebrew install by @whitewatercn in https://github.com/4gray/iptvnator/pull/495
-
Update Turkish (tr) translation by @hasanbeder in https://github.com/4gray/iptvnator/pull/516
-
Italian language update by @bovirus in https://github.com/4gray/iptvnator/pull/533
-
feat: add Arabic and Moroccan Arabic language support by @ryanhrh in https://github.com/4gray/iptvnator/pull/535
-
Add Dutch language support by @djrobo1989 in https://github.com/4gray/iptvnator/pull/536
-
Longwaiting AC3 support by @Kif-Fando in https://github.com/4gray/iptvnator/pull/547
-
Adding Belarusian and Polish language. by @Kif-Fando in https://github.com/4gray/iptvnator/pull/545
-
Group sorting logic by @Kif-Fando in https://github.com/4gray/iptvnator/pull/553
-
Add stream format selection by @p20f in https://github.com/4gray/iptvnator/pull/538
New Contributors
- @kiwamizamurai made their first contribution in https://github.com/4gray/iptvnator/pull/519
- @whitewatercn made their first contribution in https://github.com/4gray/iptvnator/pull/495
- @ryanhrh made their first contribution in https://github.com/4gray/iptvnator/pull/535
- @djrobo1989 made their first contribution in https://github.com/4gray/iptvnator/pull/536
- @Kif-Fando made their first contribution in https://github.com/4gray/iptvnator/pull/547
- @p20f made their first contribution in https://github.com/4gray/iptvnator/pull/538
See the assets to download this version and install.
How to install IPTVnator on Mac
Homebrew installs the app in your Applications folder.
Install without Homebrew
Download the file Homebrew uses for your chip: Install Details
Uninstall IPTVnator and optional data cleanup
brew uninstall --cask iptvnatorA regular uninstall removes the app and keeps its settings and caches.
Deep clean (optional)
brew uninstall --zap --cask iptvnator--zap also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out --zap.
Questions about IPTVnator
Is IPTVnator safe?
IPTVnator is in Homebrew’s official catalog and has not been disabled. Since September 2026, Homebrew disables apps that fail macOS Gatekeeper checks. When installing, Homebrew checks the download from github.com against its SHA-256 checksum. It was installed 320 times through Homebrew in the last 30 days.
Is IPTVnator open source?
IPTVnator’s source code is public on GitHub (4gray/iptvnator) under the MIT license.
How do I completely uninstall IPTVnator on a Mac?
Run brew uninstall --cask iptvnator. To delete its settings and caches as well, run brew uninstall --zap --cask iptvnator. --zap also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out --zap. That also deletes 6 files and folders, including ~/.
Does IPTVnator run on Apple silicon (M1 and later) Macs?
Yes. Homebrew downloads separate builds for Apple silicon and Intel Macs. It needs macOS 12 or later.
Where does IPTVnator store its settings and data?
Its settings are in ~/. Its data is in ~/ and ~/. These locations come from Homebrew’s clean-up list.
What is the latest version of IPTVnator?
The latest version is 0.25.0, added to Homebrew on Nov 8, 2026. IPTVnator updates itself; to update it with Homebrew, run brew upgrade --cask --greedy iptvnator.
Similar Apps
- TIDALTIDAL is a macOS desktop app for streaming music, with high-fidelity sound and high-definition video quality.
- Kid3An audio metadata editor for batch tagging, cover art, lyrics, chapters, filename conversion and online album-data imports.
- CogA free, open-source macOS audio player with broad format support, playlists, streaming playback, and audio controls.
- QQ音乐QQ Music is a macOS music application for accessing the QQ Music service.