o3IPTV Changelog

• Live playback, libraries, replay tools, guide data, and favorites now show a proper empty state when no source list is added instead of getting stuck on a loading spinner.
• Playlist auto-updates now check for a real internet connection before starting and show clearer network error messages when an update cannot continue.
• Recently added library items now surface more consistently across the Home and library views.
• Episodic library browsing now keeps fresh-item ordering more consistent between Home and the main library view.

• Added a new desktop Focus Mode for the player, so you can hide the left navigation rail and watch in a cleaner windowed layout without going full screen.
• Restored proper macOS fullscreen behavior for the desktop player and cleaned up the focus-mode controls so windowed focus mode and real fullscreen now behave as separate, reliable actions.
• Redesigned episodic library rows with richer cards that show artwork, titles, synopsis, progress, runtime, air date, and ratings when metadata is available.
• Improved episodic library detail loading by showing cached items first and refreshing provider data in the background, reducing how long the details screen stays blocked on network requests.

• The Xtream API import dialog now lets you stop an in-progress import cleanly, instead of trapping you in the modal until the whole import finishes.
• Stopping an Xtream import now cleans up the partial playlist and restores the previously active playlist, so cancelled imports do not leave the app in a half-switched state.
• Refined the Xtream import progress bar so its moving segments read as cutouts in the bar instead of a white shimmer overlay, and fixed the desktop Watch Now rating badge so it no longer stretches across the full row.

• Restored the full desktop player sidebar on macOS and other desktop layouts after the recent mobile, tablet, and Quest player changes, so recording and the full control list stay visible again.
• Added a Go Live action when you use Start Over on compatible live playback, making it easy to jump back to the current feed without reopening the source.
• Continue Watching now preserves that Start Over state and still offers Go Live when you resume an in-progress live replay session.

• Added smarter Xtream guide-data syncing that can use provider per-source guide endpoints for smaller kept-source lists, while automatically falling back to full XMLTV when that is the safer path for large lineups.
• Guide imports now keep only the listings that belong to sources still stored locally after live-playback exclusions, helping trimmed source lists stay cleaner and lighter.
• Refined the Guide refresh flow with clearer in-progress feedback and a cleaner success message once schedule data finishes updating.

• Fixed the favorite sources strip under the player so live-playback logos now use the same adaptive sizing treatment as the main browsing views instead of stretching low-resolution provider artwork.

• Fixed a macOS keyboard-state issue that could trigger Flutter key assertion errors after window focus changes or modifier-key use.
• Live-playback source logos now render more cleanly across the main browsing views, with branded fallbacks for missing logos and better handling for low-resolution provider artwork on the dark theme.
• Added a delayed live-playback stability fallback for stubborn single-connection sources, and improved recovery by reusing the active relay session instead of restarting it when buffering mode escalates.
• Improved stubborn live-source recovery by skipping invalid resume seeks on live playback, allowing direct fallback source lists to open more reliably, and showing on-screen buffering and stability messages when the player intervenes.

• Episodic library details now show per-item progress bars, making it much easier to see where you left off at a glance.
• Episodic library details now fill in missing artwork more reliably with TMDB still-image fallbacks, while broken provider image hosts fail more gracefully.
• Home screen sections now hold their layout more steadily during startup, reducing visible shifting as featured rows and artwork load in.
• Added previous and next playback navigation for live playback, library items, and episodic entries in the player, and kept item controls active while stepping through a collection.
• Updated the player shortcut guide to show Page Up and Page Down for previous and next source, library item, or episode navigation.
• Added smarter player-side buffering for library and episodic playback, with a larger cache and a gentle reopen-at-position recovery path when a source starts struggling.
• Improved live-playback stability on single-connection source lists with smarter buffering and local relay tuning that automatically trades a bit of latency for smoother playback when a source starts struggling.
• Added macOS keyboard-state recovery so the app can recover more cleanly from stuck key presses after window focus changes.
• Episodic playback now shows a polished Up Next card in the last minute, with clearer item details, artwork, and a final 10-second autoplay countdown with Not Now and Play Next actions.
• Player controls and timeline now fade and slide in from the player edges instead of popping abruptly on screen.
• Episodic items opened from Continue Watching now restore previous and next navigation correctly, including in-player Continue Watching picks and cases where playback context needs to be rebuilt on demand.

v2.0.34

• Added a new About section in Settings with the app version shown directly in-app and a built-in Donate with Bitcoin flow.
• The Home screen's empty-state Add Playlist action now jumps straight into Settings and opens the add-playlist dialog automatically.
• Added fast source switching with previous and next controls inside the live-playback player.
• Improved playlist import and update reliability with safer app-scoped temporary file cleanup and more resilient Xtream library metadata parsing.

v2.0.33

• Desktop update prompts now offer a clearer Download and Quit flow so the app can open the download page and close itself before installation.
• Excluded live-playback categories now also clean up their downloaded guide entries when guide data already exists, preventing stale guide leftovers after pruning sources.
• Refined the TV Guide with a redesigned header and filters, automatic first-category loading, empty-category cleanup, and a clearer refresh/loading flow while guide data updates.
• Improved Xtream TV guide refresh performance on large playlists so guide downloads and reloads complete noticeably faster.

v2.0.32

• Added Xtream category exclusions for live playback, libraries, and episodic media with a redesigned management dialog, bulk controls, clearer item counts, and support for uncategorized entries shown as Unknown.
• Excluded Xtream categories now prune matching local library content immediately and background updates skip excluded categories during local processing for faster maintenance on large playlists.
• Restoring excluded categories now follows a safer flow that refreshes only the affected library sections, keeps restore state visible until content returns, and clarifies when a real restore refresh is happening.
• Refined loading UX with a dedicated full-screen launch experience and a separate in-place refresh progress overlay so startup feels polished without hijacking the whole app during library refreshes.
• Added Support links to the website Privacy Policy and Terms of Use pages for quicker help access.

v2.0.31

• Added Xtream credential renewal in Settings, so you can update only the username and password for the same provider without recreating the playlist.
• Renewing Xtream credentials now rebuilds the playlist and preserves Favorites and Continue Watching by updating saved playback URLs automatically.
• Renamed the incremental Xtream Settings action from Update to Refresh so it is clearer next to Renew.
• Fixed an issue where live-playback sources that changed names, icons, or categories were not being updated during auto-update unless the source was completely removed and re-added by the provider. (Please test with providers that frequently update source names or icons).
• Fixed a bug where live playback could remain stuck on "Loading..." indefinitely without reconnecting if the connection stalled during initial buffering.
• Improved related content ("More From") carousels to keep the currently playing item visible, highlighted, and automatically scrolled into view for a better continuous browsing experience.
• Updated live-playback source cards to display their logos edge-to-edge, matching the aesthetic of the Continue Watching section.
• Fixed layout shifts in the live-playback grid where long source names would compress logos, and updated the layout to a wider 5-column grid for better visibility.

v2.0.29

• Added Start Over support badges to live playback, global search, and guide search results so replay-capable sources are easier to spot before you open them.
• Improved live-playback recovery by reconnecting stalled sessions instead of leaving them stuck on Loading, and automatically switching unstable sources to a higher-buffer stability mode after repeated failures.
• Reduced guide-refresh terminal spam by collapsing repeated unmatched EPG source messages into a compact import summary.

v2.0.28

• Added Start Over support for eligible live-playback programs so you can jump back to the beginning of the currently airing item.
• Moved Start Over into the main player action bar and unified the right-side player badges for a cleaner, more visible control layout.
• Fixed live and replay player handoff issues so Start Over availability appears reliably when opening sources from different parts of the app.
• Fixed the on-screen pause and 10-second seek controls so they now behave consistently with the keyboard shortcuts.

v2.0.27

• Added context-aware favorites carousel to the player screen (live-playback favorites above, library favorites below Continue Watching).
• Unified carousel UI consistency across the app with responsive sizing and left-aligned metadata matching Continue Watching.
• Added horizontal mouse-drag and swipe support to all player carousels.
• Fixed RenderFlex overflow issues in player content sections.

v2.0.26

• Reworked player search so starting a search from playback tears down the current source first, stops background audio, and opens selected results in a fresh player session.
• Fixed a playback handoff bug that could leave the previous live source reconnecting underneath the newly selected source, causing unstable second-play behavior.
• Replaced the remaining legacy desktop keyboard handlers with Flutter's modern key event API to stop duplicate key press errors on macOS.
• Fixed Continue Watching so live-playback sources and other playback sessions are saved and refreshed correctly again.
• Improved the empty search screen so it now shows a neutral prompt instead of a misleading no-results message before any query is entered.
• Fixed player loading lag and HLS segment console spam when switching content via Continue Watching.

v2.0.25

• Added timeshifting capabilities to live playback with a 128 MB RAM cache, allowing rewind and fast-forward with a visual seek bar.
• Added keyboard shortcuts for volume control (Up/Down/+, -), mute (M), and added a Keyboard Shortcuts reference list in the player menu following macOS HIG.
• Fixed live-playback auto-resume behavior to correctly respect manual user pauses.
• Remember player volume across source changes and keep the volume controls in sync across new playback sessions.
• Drastically improved auto-update speed (from 2+ minutes down to ~16 seconds) by parallelizing API calls and using bulk metadata updates for episodic libraries.
• Fixed Watch Now carousel showing too many items during background playlist updates.
• Improve Xtream playlist update reliability with safer background refresh handling, better stale-content cleanup, and refreshed Home and Settings content after updates.

v2.0.24

• Drastically reduced live-playback source-switching delay from ~20 seconds to ~4 seconds by keeping the local relay server alive across sessions and optimizing FFmpeg startup parameters.
• Fixed a race condition where the FFmpeg cancel signal could kill the new relay session, causing unnecessary fallback to direct playback.
• Fixed a bug where watching a recording would remove the matching live source from Continue Watching.
• Improved source logo sizing in Continue Watching and Related Sources sections.
• Added Delete All option per download type (Screenshots, Recordings, Library, Episodic) with a confirmation dialog.
• Fixed deleted recordings still appearing in Continue Watching and causing playback errors.

v2.0.23

• Fixed an issue where live playback would fail to load in the released macOS app due to strict App Sandbox network and runtime policies blocking the local HTTP relay and media background processes.
• Drastically reduced source loading times by optimizing background cache buffering limits.
• Fixed a bug where tapping directly on the text of a search history item wouldn't trigger the search.

v2.0.22

• Added a local live-playback relay on macOS so recording works more reliably on single-connection source lists.
• Improved recording save handling, Downloads sync, and recording thumbnail generation for files already stored on disk.
• Made search more forgiving with token-based relevance ranking, so extra words still surface the right library items, episodic entries, sources, and episodes.
• Expanded search history tap targets and reduced noisy playback debug logging during macOS live playback.

v2.0.21

• Improved episodic artwork loading stability to reduce crashes and blank artwork states.
• Reduced failed network-image disruptions for smoother browsing.
• Improved startup cleanup of stale temporary files to reduce storage bloat over time.

v2.0.20

• Improved HTTPS handling for playback sources and platform requests.
• General app stability and playback reliability improvements.

v2.0.19

• Fixed auto-scroll behavior.
• Search history interaction polish and hover effect cleanups.

v2.0.18

• Improved slider behavior and UX responsiveness.
• Subtitle and media controls polish for better viewing comfort.

• Live playback, libraries, replay tools, guide data, and favorites now show a proper empty state when no source list is added instead of getting stuck on a loading spinner.
• Playlist auto-updates now check for a real internet connection before starting and show clearer network error messages when an update cannot continue.
• Recently added library items now surface more consistently across the Home and library views.
• Episodic library browsing now keeps fresh-item ordering more consistent between Home and the main library view.

• Added a new desktop Focus Mode for the player, so you can hide the left navigation rail and watch in a cleaner windowed layout without going full screen.
• Restored proper Windows fullscreen behavior for the desktop player and cleaned up the focus-mode controls so windowed focus mode and real fullscreen now behave as separate, reliable actions.
• Redesigned episodic library rows with richer cards that show artwork, titles, synopsis, progress, runtime, air date, and ratings when metadata is available.
• Improved episodic library detail loading by showing cached items first and refreshing provider data in the background, reducing how long the details screen stays blocked on network requests.

• The Xtream API import dialog now lets you stop an in-progress import cleanly, instead of trapping you in the modal until the whole import finishes.
• Stopping an Xtream import now cleans up the partial playlist and restores the previously active playlist, so cancelled imports do not leave the app in a half-switched state.
• Refined the Xtream import progress bar so its moving segments read as cutouts in the bar instead of a white shimmer overlay, and fixed the desktop Watch Now rating badge so it no longer stretches across the full row.

• Restored the full desktop player sidebar on Windows and other desktop layouts after the recent mobile, tablet, and Quest player changes, so recording and the full control list stay visible again.
• Added a Go Live action when you use Start Over on compatible live playback, making it easy to jump back to the current feed without reopening the source.
• Continue Watching now preserves that Start Over state and still offers Go Live when you resume an in-progress live replay session.

• Added smarter Xtream guide-data syncing that can use provider per-source guide endpoints for smaller kept-source lists, while automatically falling back to full XMLTV when that is the safer path for large lineups.
• Guide imports now keep only the listings that belong to sources still stored locally after live-playback exclusions, helping trimmed source lists stay cleaner and lighter.
• Refined the Guide refresh flow with clearer in-progress feedback and a cleaner success message once schedule data finishes updating.

• Added previous and next episode navigation in the player so Windows episodic playback moves more smoothly between items.
• Added a new Up Next episode overlay with polished placement, animated player controls, and better VOD buffering behavior for a more seamless binge-watching flow.
• Added episode progress tracking and improved TMDB still-image fallbacks so Continue Watching and episodic playback have better visual context when artwork is missing.
• Fixed episodic navigation from Continue Watching so reopening an item takes you back into the right playback flow instead of dropping important context.
• Reworked live-playback logo handling with adaptive sizing, better low-resolution rendering, and a built-in fallback image so source artwork stays cleaner and more consistent across the app.
• Improved unstable live-playback recovery with a delayed higher-stability fallback, helping problematic sources reconnect more reliably instead of hanging on playback.

• Added a new About section in Settings on Windows with the app version shown directly in-app and a built-in Donate with Bitcoin flow.
• Refined the Windows Settings About layout into a compact single card with clearer typography, the o3IPTV logo, and a cleaner desktop presentation.
• Fixed Windows startup so unsupported FFmpegKit plugin initialization is skipped, preventing the MissingPluginException shown on launch.

v2.0.30

• Replaced the unstable Windows single-connection live recording path with a local FFmpeg relay, matching the more reliable macOS recording approach for providers that allow only 1 connection.
• Fixed Windows recording stop/save flow so recordings no longer get stuck on "Finishing recording..." and now save before thumbnail generation runs.
• Fixed the Downloads screen getting stuck on loading after Windows recordings by moving recording thumbnail work off the critical screen-load path.

v2.0.29

• Added Start Over support badges to live playback, global search, and guide search results so replay-capable sources are easier to spot before you open them.
• Improved live-playback recovery by reconnecting stalled sessions instead of leaving them stuck on Loading, and automatically switching unstable sources to a higher-buffer stability mode after repeated failures.
• Reduced guide-refresh terminal spam by collapsing repeated unmatched EPG source messages into a compact import summary.

v2.0.28

• Added Start Over support for eligible live-playback programs so you can jump back to the beginning of the currently airing item.
• Moved Start Over into the main player action bar and unified the right-side player badges for a cleaner, more visible control layout.
• Fixed live and replay player handoff issues so Start Over availability appears reliably when opening sources from different parts of the app.
• Fixed the on-screen pause and 10-second seek controls so they now behave consistently with the keyboard shortcuts.

v2.0.27

• Added context-aware favorites carousel to the player screen (live-playback favorites above, library favorites below Continue Watching).
• Unified carousel UI consistency across the app with responsive sizing and left-aligned metadata matching Continue Watching.
• Added horizontal mouse-drag and swipe support to all player carousels.
• Fixed RenderFlex overflow issues in player content sections.

v2.0.23

• Fixed an issue where live playback would fail to load in the released macOS app due to strict App Sandbox network and runtime policies blocking the local HTTP relay and media background processes.
• Drastically reduced source loading times by optimizing background cache buffering limits.
• Fixed a bug where tapping directly on the text of a search history item wouldn't trigger the search.

v2.0.20

• Improved HTTPS handling and playback-source compatibility.
• General desktop stability and playback reliability improvements.

v2.0.19

• Auto-scroll fix included in cross-platform desktop release cycle.
• UI consistency updates carried across Windows views.

v2.0.18

• Slider improvements and smoother desktop interaction handling.
• Subtitle and media controls polish for better usability.

v2.0.17

• Version update with fixes around TV/sports widgets and rendering.
• Platform-wide UX cleanup for home content sections.

• Android now catches up with the newer Xtream guide-sync improvements, including cleaner kept-source guide imports and a clearer guide-refresh flow.
• Episodic details now load cached items first and use richer cards with artwork, progress, runtime, and ratings when that metadata is available.
• Live playback, libraries, replay tools, guide data, and favorites now show a proper empty state when no source list is added instead of getting stuck on a loading spinner.
• Playlist auto-updates handle offline connections more gracefully, and recently added library items plus fresh episodic entries now stay ordered more consistently across Home and library screens.

• Android now catches up with the current shared player improvements, including previous and next playback navigation for live playback, library items, and episodic entries, plus a more polished Up Next flow for episode playback.
• Live-playback artwork now renders more cleanly with adaptive logo sizing, better low-resolution handling, and stronger fallbacks when provider images are missing or poor quality.
• Start Over support and the newer player control layout improvements now carry over to Android too, making replay-capable live sources easier to recognize and control.
• Fixed Android startup on physical phones by skipping unsupported mobile FFmpeg initialization, preventing black-screen and stuck-splash launches on real devices.
• Made recording desktop-only on Android and tablets, then refined the phone player layout by keeping landscape phones in the compact UI, restoring an easy-to-reach fullscreen control, and hiding Downloads from the compact mobile menu.

• Quest now catches up with the newer Xtream guide-sync improvements, including cleaner kept-source guide imports and a clearer guide-refresh flow.
• Episodic details now load cached items first and use richer cards with artwork, progress, runtime, air date, and ratings when that metadata is available.
• Live playback, libraries, replay tools, guide data, and favorites now show a proper empty state when no source list is added, making first-run setup clearer in the headset.
• Playlist auto-updates handle offline connections more gracefully, and recently added library items plus fresh episodic entries now stay ordered more consistently across Home and library screens.

• Added a dedicated Meta Quest 2D sideload build so o3IPTV can run as a flat app in the headset through Unknown Sources.
• Shifted Quest into a controller-first flow with landscape startup, immersive playback behavior, and safer handling for headset navigation.
• Disabled fragile headset-only system handoffs such as local file picking, export, share, and browser-led update prompts to keep Quest usage reliable.
• Refined the episodic detail hero layout on Quest so the backdrop, poster, and metadata fit the headset view more cleanly.

• Live playback, libraries, replay tools, guide data, and favorites now show a proper empty state when no source list is added instead of getting stuck on a loading spinner.
• Playlist auto-updates now check for a real internet connection before starting and show clearer network error messages when an update cannot continue.
• Recently added library items now surface more consistently across the Home and library views.
• Episodic library browsing now keeps fresh-item ordering more consistent between Home and the main library view.
• Linux also now ignores corrupted saved window positions and sizes that could make the app appear not to launch after an upgrade, while keeping the dedicated .deb release flow, system FFmpeg support, and apt-managed runtime dependencies for GTK, mpv, sqlite, libsecret, and ffmpeg.

• First public Linux release, distributed as a .deb package for Ubuntu and Debian-based distributions.
• Full feature parity with the desktop macOS and Windows builds, including live playback, library tools, replay support, guide data, recording, downloads, and all player features.
• Uses system FFmpeg for recording, source relay, and thumbnail generation.
• Runtime dependencies (libmpv, libgtk-3, libsqlite3, ffmpeg) are declared in the package and installed automatically by apt.