iptvnator

Highlights

Programme guide, rebuilt

The M3U programme guide now follows your playlist's own channels and order, with groups and favorites one click away. Keep the player above the grid while you browse, click a channel to switch, or double-click to switch and close. Open the guide with G, hide channels without EPG and choose compact or comfortable rows. (#1560, closes #171)

Browse channels and episodes without leaving fullscreen

Press C or use the left edge of the video to open a searchable channel list. Series get season tabs and an episode list with artwork and watch progress too. With the default shared controls, switching channels, episodes or alternative movie sources keeps the player fullscreen. (#1519, #1620, #1509, closes #48)

See what is playing while it plays

The stream-info overlay shows resolution, frame rates, bitrates, audio details, buffer and dropped frames when the player can report them. Available in the built-in web players and experimental frame-copy Embedded MPV; unavailable values stay hidden. (#1578)

Nightly channel

Get builds from each merge through Settings → About → Update channel, or download them from the nightly repository. Stable remains the default.

---

27 features · 54 fixes · 1 performance improvement — including local XMLTV files, Xtream catch-up downloads, automatic reconnects for embedded MPV, season artwork and recovery for sources missing after an older upgrade.

Read the 📝 release story on the blog, the full CHANGELOG, or the changes since v0.23.0.

Before updating, back up your playlists and important data. Desktop startup applies database updates and clears outdated metadata matches; allow the preparation screen to finish and avoid downgrading an upgraded profile.

Thanks

Thank you to @Bpl5966 for MPV reconnects and extra options (#1515), @mark-jardine for the EPG time offset (#1489), and @larsemig for stream information (#1578).

Thank you also to @thejdubb02 for the original zoom-persistence, Turkish-search and Xtream EPG-refresh fixes (#1613, #1612, #1610). This work was incorporated and extended in #1617, #1640 and #1647, with his co-authorship preserved.

A warm thank-you to everyone who reported issues, tested builds, helped in the Telegram community, or supported development. 💙

❤️ If IPTVnator is useful to you, you can help keep it moving through GitHub Sponsors or Ko-fi

Features

• collections — A live channel you watch from Fav

Highlights

Download manager with offline library

Downloads now separate active transfers from a grouped offline library, move missing files to Needs attention with Download again, and open movies and series in focused offline details with saved metadata. Series show only local episodes; View in portal returns to provider playback when the source can be recovered. Completed-file checks stay responsive on slow or unavailable storage. (#1313)

New player controls by default

The new player controls are now the default for the built-in web players — one consistent bar with quality selection, external subtitles, subtitle delay and styling, speed, and picture-in-picture. They are touch-friendly too: tapping the video shows or hides the controls instead of pausing, and narrow players get a two-row layout. Prefer the old look? Switch back in Settings > Playback. (#1485, closes #1408)

Alternative sources for movies

Movies that exist in several of your playlists now show a "Sources" chip on the detail page. Switch playlist mid-film and playback continues from the same timecode, pin a preferred source per movie, and when a stream dies the error screen offers the alternatives instead of a dead end. Optional auto-switching is off by default. (#1286)

Catalogs scroll without pages

Xtream movie, series, and live catalogs now load continuously as you scroll instead of flipping through pages — more items appear automatically as you near the bottom, and taller windows fill themselves on open. Opening a title and going back returns you to the exact spot in the list. In-category search and the in-portal search results follow the same continuous style. (#1392)

---

46 features · 76 fixes · 4 performance wins in this release — the full story is in the 📝 release notes on the blog and in the CHANGELOG.

• dashboard — Continue Watching cards on the dashboard now open the detail page on click, just like movie cards — no more accidental episode playback. Resuming the saved episode moved to a new ⋮ menu on each card, next to "Mark as Watched" and "Remove from history". (#1469, closes #1441)
• dashboard — Dashboard source cards now warn when a portal subscription is about to lapse: an amber "Expires in N d" chip appears within a week of the expiry date, and an "Expired" chip once it has passed. Xtream expirations come from the same cached status check the playlist switcher uses; Stalker portals reuse the account info saved at import. (#1342)
• dashboard — The dashboard gains a "Because you watched" rail: TMDB recommendations seeded from your recently watched movies and series, showing only titles that actually exist in your imported libraries. It appears once at least five matches are found, can be turned off under Settings → Dashboard, and requires the TMDB metadata opt-in (desktop app only). (#1419)
• deps — Linux desktops with client-side decoration support now show native rounded corners on the IPTVnator window. Desktop builds now run on Electron 43. (#1414)
• downloads — The download manager got a visual cleanup: "Ready to w

v0.22 is one of the biggest IPTVnator releases so far. The embedded MPV player expands from macOS to Windows and Linux, detail pages for movies and series got a full redesign, and the app can now enrich your VOD & series content with TMDB metadata — posters, cast, trailers and more. On top of that: a built-in desktop updater, global search across all your sources, and a reworked live EPG timeline.

---

✨ Highlights

• Embedded MPV player now available on Windows and Linux (experimental)
• TMDB metadata enrichment (opt-in): plots, cast, trailers, similar titles, actor pages
• Redesigned VOD & series detail pages with a browse ↔ watch layout and season tabs
• Desktop auto-updater — the app now updates itself from GitHub releases
• Global search across all sources, including M3U playlists
• Live EPG panel reworked into a timeline with an optional vertical list view
• Catch-up/archive playback improvements for Xtream
• Custom title bar with window controls on Windows and Linux
• Extensive Electron security hardening

---

🎬 Embedded MPV Player — now on Windows & Linux (Experimental)

The embedded MPV player introduced for macOS in v0.21 is now available on all three platforms:

• Windows: libmpv rendering directly inside the app window (bundled, no extra install)
• Linux: playback via the system mpv player embedded into the app window (X11/XWayland; requires mpv on PATH)
• Series navigation (next/previous episode) inside the embedded player
• Switch to embedded MPV directly from the command palette
• Stability hardening across the board: EOF detection, safer polling, better error visibility, and the display no longer goes to sleep during playback

The macOS embedded player also received a round of fixes and polish based on v0.21 feedback.

---

🎞️ TMDB Metadata Enrichment (opt-in)

Movie and series detail pages for Xtream and Stalker portals can now be enriched with TMDB data:

• Plot, genres, ratings, director and cast with photos, artwork and YouTube trailers
• "Similar" rail: TMDB recommendations matched against your catalog — across all your portals
• Trending on the dashboard: a TMDB-powered trending rail with enriched hero artwork
• Real episode names, descriptions and stills for each season
• Actor pages: click any cast member to see their bio and filmography, linked back to your catalog or portal search
• Localized to your app language (falls back to the original language when a translation is missing), cached locally

Enrichment is off by default and requires a personal TMDB API key (free registration at themoviedb.org). Enter your key and enable the feature under Settings → Metadata (TMDB) — titles are sent to TMDB for matching.

---

📺 Redesigned Movie & Series Detail Pages

Detail pages now have two states:

• Browse: hero section with poster, metadata and actions, episodes below
• Watch: the hero collapses, the inline player takes the full content width, and details move below the episodes
• Season tabs with smart auto-selection (jumps to the season you're watching or resuming)
• Grid/list toggle for episodes, remembered across sessions
• Esc or "Close player" returns to browse without losing your place

---

🔄 Desktop Auto-Updater

• IPTVnator now checks GitHub releases and can update itself — no more manual downloads
• Release notes for the current version are shown in the settings
• Fixed a crash in the packaged updater (#1103)

---

🔎 Global Search

• New workspace-wide search across all your sources — Xtream, Stalker and M3U playlists
• Fixed live search (Ctrl+F) opening the wrong channel or category

---

🗓️ EPG & Catch-up

• Live EPG panel reworked into a horizontal **t

v0.21 focuses on quality-of-life improvements, performance, and playback experience improvements across the app.
This release also introduces one of the most requested features for macOS users: an experimental embedded MPV player built directly into the app — no additional installation required.

---

✨ Highlights

• Experimental embedded MPV player for macOS
• Toggleable Live TV sidebar and EPG panel
• Improved command palette
• Better Recently Viewed & Favorites experience
• Performance and loading time improvements
• Multiple Xtream, Stalker, and M3U fixes

---

🍎 macOS Embedded MPV Player (Experimental)

[macOS only]

IPTVnator now includes an experimental embedded MPV player directly inside the app.

No additional software required — just install and use IPTVnator.

This is an early experimental version and feedback is very welcome.

---

🧭 Layout & Navigation

• Toggleable sidebar panel for Live TV channels for a more focused viewing experience
• Toggle/collapse EPG panel

---

⚡ Command Palette Improvements

• Change player directly from command palette
• Added section with 5 recently used actions

---

⭐ Favorites & Recently Viewed

• Fixed issue where Live TV items appeared favorited by default
• Channels can now be favorited directly from Recently Viewed
• Remove individual channels from Recently Viewed via context menu
• Renamed "GLOBAL Favorites" to simply "Favorites"

---

📺 Playback & Playlist Management

• Fixed MPV/VLC custom path fallback handling
• Added manual refresh for playlists added from filesystem
• Fixed playlist refresh handling for file-based playlists

---

📦 Module Improvements

M3U

• Cover size setting (XL / L / M)
• Sorting for “All Channels”:
  • by name
  • by original playlist order
• Improved channel drag & drop ghost styling

Xtream

• Better unavailable portal handling
• Added clear button to playlist form
• Fixed search when no category is selected

Stalker

• Fixed “14 items” issue

---

🎨 UI & UX Improvements

• Improved category count badge styling
• Improved “No results found” screen styling

---

🚀 Performance & Internal Improvements

• Performance improvements to reduce loading times
• Database WAL improvements
• Favorites lookup optimizations
• Refactored settings component
• Additional facade/internal refactors

---

🌍 Localization

• Added missing translation strings for all supported languages

---

🛠 Other Fixes & Improvements

• Fixed loading screen issues in download manager
• Fixed reset Recently Viewed for M3U module

---

⬇️ Download

GitHub Releases:
https://github.com/4gray/iptvnator/releases

---

💙 Support the project

If you like IPTVnator and want to support further development:

• GitHub Sponsors: https://github.com/sponsors/4gray
• Ko-fi: https://ko-fi.com/4gray

---

🙏 Huge thanks to everyone who donated and supported the project,
as well as contributors and all the people who tested the app,
provided feedback, reported issues, and shared ideas on how to improve it.

Full Changelog: https://github.com/4gray/iptvnator/compare/v0.20.0...v0.21.0