Why some streams need an external player
Why some IPTV streams do not play in IPTVnator's built-in browser players, and when MPV, VLC, or IINA is the right workaround.
Read moreCompare · Players
Built-in players, MPV, or VLC?
A stream that refuses to play is almost always a decoding problem, not a broken subscription. IPTVnator can hand the same stream to a different engine, and each engine trades something for what it gains.
Short answer
Keep the built-in player until a stream refuses to play, then send that stream to MPV or VLC. The built-in players keep every in-app control and are the only ones whose failures the app can react to; MPV and VLC decode almost anything but play in their own window.
The built-in three
Web players, side by side
All three render inside the app and share one control bar. They differ in the extras.
| Capability | HTML5 / hls.js | Video.js | ArtPlayer |
|---|---|---|---|
| HLS and MPEG-TS streams | Yes | Yes | Yes |
| DASH with ClearKey keysA .mpd channel always plays inline; the app switches engine for it when needed. | Yes | Handed to HTML5 | Yes |
| Shared control barOn by default. Turning it off in Settings › Playback returns each player to its own controls. | Yes | Yes | Yes |
| Subtitle file, offset and styling | Yes | No | Yes |
| Quality selectionOffered only when the stream really carries several renditions. | Multi-variant HLS | Multi-variant HLS | Multi-variant HLS |
| Picture-in-picture | Yes | Yes | Yes |
| Playback error diagnostics | Yes | Yes | Yes |
Where video plays
Three ways to decode a stream
| Capability | Built-in web players | Embedded MPV | MPV or VLC |
|---|---|---|---|
| Where the video is drawn | In the app window | In the app window | In a separate window |
| Codec coverage | What the browser engine decodes | What mpv decodes | What mpv or VLC decodes |
| Needs anything installed | No | Bundled, except on some Linux packages | MPV or VLC on your machine |
| App controls, subtitles and quality menu | Yes | Controls and subtitles, no quality menu | No |
| Picture-in-picture | Yes | No | No |
| Live TV recordingRecordings appear beside downloads in the manager. | No | Yes | No |
| Failure reaches the appOnly the built-in players raise a diagnostic, so the alternative-source failover for movies can act on it. | Yes | No | No |
| Status | Default | Experimental, opt-in | Stable |
| Available in the browser version | Yes | No | No |
Choosing
A rule of thumb
01
Start with the default
The built-in players cover ordinary HLS and MPEG-TS streams, keep every in-app control, and are the only engines where a failed stream can trigger the automatic switch to another copy of a movie.
02
Reach for MPV or VLC when a stream refuses
Odd codecs, unusual containers and streams that stutter in a browser engine usually play immediately in MPV or VLC. IPTVnator keeps the library, the guide and the phone remote; only the video moves to another window.
03
Try embedded MPV to keep it in the window
The experimental engine renders mpv inside IPTVnator, so you get mpv decoding without a second window, plus live-TV recording. It is opt-in under Settings › Playback and can be switched off again.
04
Radio and DASH decide for themselves
Radio stations always use the built-in audio player, and DASH channels always play inline, whatever engine you selected. Both ignore the external player setting on purpose.
FAQ
Questions about playback
Which player should I choose?+
Leave the default built-in player until something refuses to play. It keeps the shared controls, subtitles, quality selection and picture-in-picture, and it is the only engine family whose failures the app can react to. Switch a stream to MPV or VLC when it does not decode.
What is the difference between MPV and embedded MPV?+
Both use mpv to decode. MPV opens its own window and is a stable, long-standing option. Embedded MPV renders inside the IPTVnator window, keeps the app controls and can record live TV, but it is experimental and must be enabled in Settings › Playback.
Do I need to install MPV or VLC myself?+
For the external MPV and VLC options, yes: IPTVnator launches the copy on your machine and you can point it at a specific path in the settings. The built-in players need nothing, and embedded MPV ships with the app except on the Linux packages that use your system mpv.
Why do subtitles behave differently between players?+
Loading an external subtitle file with a timing offset and custom styling is offered where the engine can do it: the HTML5 player, ArtPlayer and embedded MPV. Video.js keeps its own subtitle handling, and MPV or VLC use theirs.
Does switching the player lose my progress?+
No. Playback positions, favorites and history belong to the source, not the player, so a movie resumes where you stopped whichever engine plays it.
Can the browser version use MPV or VLC?+
No. Launching another application requires the desktop app. In a browser, copy the stream URL and open it in your player manually.
Keep reading
Guides and background
Experimental embedded MPV support on macOS
A closer look at IPTVnator's experimental embedded MPV player for macOS: why it exists, how it is wired into Electron, and where to share feedback.
Read more
How to Load an M3U Playlist and Add an EPG in IPTVnator
Import an M3U or M3U8 playlist into IPTVnator from a URL, a file or pasted text, keep it updated, and attach an XMLTV program guide. Covers channel groups, catch-up attributes, EPG matching by tvg-id, and the usual reasons a playlist or guide does not load.
Read moreOfficial downloads only
IPTVnator is a player, not a TV service. It is distributed exclusively through GitHub releases and the package managers listed on this page. Websites that sell "IPTVnator subscriptions", channel packages or "activated" copies are not affiliated with the project. How to recognize unofficial sites.
Other comparisons
All comparisonsStill deciding?
M3U vs Xtream Codes vs StalkerYour provider gave you a link, a login or a MAC address. Which one should you use, and what does each give you inside the app?Desktop app vs browser versionThe desktop app and the self-hosted browser version share one codebase. Here is exactly what the browser cannot do.IPTVnator vs VLCVLC opens an M3U playlist too. When is that enough, and what does a player built around IPTV add on top?IPTVnator vs KodiKodi is a whole media center and reaches IPTV through a PVR add-on. When is that the right shape, and when do you want a player that only does IPTV?Computer vs TV boxA set-top box in the living room or a computer at a desk: where should IPTV actually run, and what does each make easy?