# IPTVnator

An open-source IPTV player for M3U/M3U8 playlists, Xtream Codes and Stalker portals, with XMLTV guides, favorites and desktop playback options.

> This is the Markdown version of the IPTVnator page on OpenNavo, with the same facts as the web page: <https://opennavo.com/apps/iptvnator>

- **Latest version**: `0.25.0`
- **Developer**: 4gray
- **Homepage**: <https://github.com/4gray/iptvnator>
- **Categories**: [Audio & Video](https://opennavo.com/categories/media)
- **Install**: `brew install --cask iptvnator`
- **30-day installs**: 320
- **Homebrew**: Available; the app updates itself
- **Download URL**: <https://github.com/4gray/iptvnator/releases/download/v0.25.0/iptvnator-0.25.0-mac-arm64.dmg>
- **SHA-256**: `0afe23b22758b22db9f097932b4f3bc1c353dc6719bd5cb4a14cfface8602270`

SHA-256 only checks that the download is complete; it is not a security certification.

## Installation and removal contents

```json
[
  {
    "declaration": {
      "app": [
        "IPTVnator.app"
      ],
      "target": "/Applications/IPTVnator.app"
    },
    "phase": "install",
    "sources": [
      "IPTVnator.app"
    ],
    "target": "/Applications/IPTVnator.app",
    "type": "app"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/.iptvnator",
            "~/Library/Application Support/com.apple.sharedfilelist/com.apple.LSSharedFileList.ApplicationRecentDocuments/com.fourgray.iptvnator.sfl*",
            "~/Library/Application Support/iptvnator",
            "~/Library/Preferences/com.electron.iptvnator.plist",
            "~/Library/Preferences/com.fourgray.iptvnator.plist",
            "~/Library/Saved Application State/com.electron.iptvnator.savedState"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## 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

## System requirements

- macOS 12 or later · Version: 0.25.0 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/i/iptvnator.rb> · Checked 2026-11-22
  - <https://github.com/4gray/iptvnator/releases/download/v0.25.0/iptvnator-0.25.0-mac-x64.dmg>
  - SHA-256: `9b3a196b47932cc11f3f5b7f811c2e3ba185d71be36bc2555c0346ac3f18d6f0`
- macOS 12 or later · Version: 0.25.0 · Apple silicon · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/i/iptvnator.rb> · Checked 2026-11-22
  - <https://github.com/4gray/iptvnator/releases/download/v0.25.0/iptvnator-0.25.0-mac-arm64.dmg>
  - SHA-256: `0afe23b22758b22db9f097932b4f3bc1c353dc6719bd5cb4a14cfface8602270`

## IPTVnator security facts

Only facts that can be checked, each with its source and date. This is not a safety certification. To check the files you downloaded, scan them on your Mac with OpenNavo.

- <https://github.com/4gray/iptvnator> · Open source: Yes — <https://github.com/4gray/iptvnator> · Checked 2026-11-13

## Uninstall

- `brew uninstall --cask iptvnator`

A 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`.

A regular uninstall removes the app and keeps its settings and caches.

- Files and folders: `~/.iptvnator` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/i/iptvnator.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Application Support/com.apple.sharedfilelist/com.apple.LSSharedFileList.ApplicationRecentDocuments/com.fourgray.iptvnator.sfl*` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/i/iptvnator.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Application Support/iptvnator` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/i/iptvnator.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Preferences/com.electron.iptvnator.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/i/iptvnator.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Preferences/com.fourgray.iptvnator.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/i/iptvnator.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Saved Application State/com.electron.iptvnator.savedState` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/i/iptvnator.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.

## Latest release notes

### 1.0.0-7-prerelease (2025-10-02)

#### 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.

## Facts and sources

- <https://opennavo.com/apps/iptvnator>
- <https://opennavo.com/apps/iptvnator/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/i/iptvnator.rb> · Checked 2026-11-22
- <https://formulae.brew.sh/cask/iptvnator>
- <https://github.com/4gray/iptvnator> · Checked 2026-11-13
