> For the complete documentation index, see [llms.txt](https://nostalgiatv.gitbook.io/user-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nostalgiatv.gitbook.io/user-guide/getting-started/changelog.md).

# Changelog

{% updates format="full" %}
{% update date="2026-07-22" %}

## v0.9.12

#### 📁 Full Local Files Support

* **Device-Local Media Pipelines:** Construct custom channels directly from local directories on your device with no active media server required.
* **Offline Capabilities:** Complete support for offline playback, mirror folder synchronization, local commercial breaks, automatic channel generation, and local background audio for Tune Choice stations.
* **Expanded Local Metadata:** Integrates OMDb metadata scrapers, local artwork fetching, background folder scanning, and direct local playback prioritization.

#### 🔌 Jellyfin & Emby Integration

* **Full Platform Parity:** Native support for Jellyfin and Emby server pairing, libraries, custom playback handling, music, collections, labels, playlists, Live TV feeds, trailers, and chapter markers.
* **Ecosystem Feature Parity:** Full commercial integration, multi-server management, Docker background processing, and complete web remote parity.

#### 🔗 Docker Pairing Mode

* **Instant Device Onboarding:** Connect TV devices to your central environment instantly via a short pairing code, removing the need to log into media servers on every individual client.
* **Shared Network Architecture:** Paired client devices automatically inherit server connections, direct playback permissions, profile mappings, and first-run configurations.

#### 🎟️ Rent Mode Channels

* **Virtual Video Store Experience:** Converts any movie or TV station into an interactive video rental shop equipped with looping trailers, custom storefronts, and one-click rental actions.
* **Enhanced Visual Features:** Delivers commercial-free playback, seamless cinematic transition overlays, "What's On" integration, and two default storefront channels (*SPARZ* and *CINEMIN*).

#### 🔒 Restricted Content & Stronger Parental Controls

* **Analog Premium Cable Scrambling:** Protects locked channels behind dynamic PIN authentication and authentic 1990s cable channel scrambling visuals with bouncing wordmarks.
* **Flexible Broadcast Rules:** Supports restricted media library isolation, optional commercial insertion, enhanced audio options, and full web/Docker remote management.

#### 📺 Advanced Playback & Display Features

* **Emergency Weather Crawls:** Displays live, scrolling Severe Weather EAS alert banners across the guide grid and active video feeds during active alerts.
* **On Demand Upgrades:** Adds an integrated search engine to On Demand featuring live query results, genre shortcuts, and native voice search support.
* **Input & Mobile Improvements:** Native D-pad and controller support across mobile, handheld, and tablet devices, along with CRT and 4:3 viewports.
* **Stream Quality Indicators:** Displays live status badges flagging Direct Play, Direct Stream, or Transcoding states during active playback.
* **Audio Pipeline Controls:** Adds flexible Audio Passthrough toggles (*Auto*, *On*, or *Off*) with live switching, AVR self-healing, Dolby TrueHD/DTS-HD support, and targeted fixes for NVIDIA Shield devices.

#### 🛠️ Editor & Scheduling Updates

* **Expanded Channel Rules:** Introduced individual schedule refresh controls, default "Start on On Demand" landing toggles, and three new Tune Choice stations (*Gospel*, *Kids*, and *Variety*).
* **Lineup Re-indexing:** Default custom channels now begin sequentially at channel 2001. The *Storm Channel* and *What's On* channels have been relocated directly after the Tune Choice block.
* **IPTV Stream Editing:** Full editable support for external HDHomeRun and custom M3U/XMLTV IPTV link sources.

#### ⚡ Performance & Usability

* **Instant Boot Performance:** Implemented priority schedule generation, allowing Docker and client interfaces to render live guide views instantly while processing 30-day timelines in the background.
* **Dynamic Player Engine:** Seamlessly switch between ExoPlayer and libmpv video engines live during playback without interrupting the active stream or restarting the app.
* **Background Sync Operations:** Local folder scanning and media mirror updates execute silently in the background.
* **System Optimization:** Hundreds of UI adjustments, memory footprint reductions for low-RAM hardware, and bug fixes covering multi-server playback, cloud sync reliability, and transcode retry loops.

<details>

<summary>• Added full Local Files support. Build channels directly from folders on your device with no media server required. Supports offline playback, mirror folders, automatic channel creation, local commercials, Tune Choice music, OMDb metadata, artwork, rescans, and direct local playback.<br>• Added full Jellyfin &#x26; Emby support including servers, libraries, playback, music, collections, labels, playlists, Live TV, trailers, chapters, commercial support, multi-server management, Docker, and web UI parity.<br>• Added Docker pairing mode. Connect devices with a pairing code instead of signing into Plex/Jellyfin/Emby on every device. Devices inherit servers automatically, support direct playback, faster onboarding, profile merging, server management, and improved first-run setup.<br>• Added Rent Mode channels. Transform any movie or TV channel into a premium video-store experience with looping trailers, storefronts, one-click rentals, cinematic transitions, commercial-free playback, What's On integration, and default SPARZ/CINEMIN storefront channels.<br>• Added Restricted Content channels with PIN protection, authentic 1990s premium-cable scrambling, bouncing wordmark, restricted libraries, optional commercials, improved audio, Docker/web support, and much stronger parental controls.<br>• Added severe weather EAS crawls<br>• Added Search to On Demand with live search, genre shortcuts, and voice search.<br>• Added D-pad/controller navigation throughout mobile, handhelds, and tablets.<br>• Added CRT/4:3 display modes on mobile.<br>• Added delivery status badges showing Direct Play, Direct Stream, and Transcoding<br>• Added per-channel Refresh Schedule, OMDb support, Start on On Demand, mirror folders, local commercials/music folders, and new Tune Choice Gospel, Kids, and Variety stations.<br>• Added Audio Passthrough controls (Auto/On/Off) with live switching, AVR self-healing, Dolby TrueHD/DTS-HD passthrough, and NVIDIA Shield improvements.<br>• Added editable HDHR/IPTV sources</summary>

Performance & usability improvements:\
• Much faster startup using priority schedule generation and background loading.\
• Docker now loads guides almost immediately while finishing month-long schedules in the background.\
• Faster trailer loading for What's On and On Demand.\
• Video player can switch instantly between ExoPlayer and libmpv without restarting.\
• Improved transcoding decisions, playback reliability, codec detection, image caching, memory usage, diagnostics, cloud sync, onboarding, and multi-server performance.\
• Local scanning now runs in the background and mirror folders stay synchronized automatically.\
• Hundreds of UI improvements across TV, mobile, web, and Docker.

New channel/editor improvements:\
• New custom channels now begin at channel 2001.\
• Storm Channel and What's On moved after the Tune Choice block.\
• Improved Rent Mode overlays, storefront animations, poster movement, and fullscreen controls.\
• Better program-cell styling, rounded EPG options, guide improvements, WCAG accessibility fixes, redesigned configuration screens, faster search, simplified settings, one-click option cyclers, and improved web guide parity.

Fixes:\
• Fixed cloud sync splitting between servers.\
• Fixed multi-server playback reliability.\
• Fixed transcode retry loops and sticky fallback issues.\
• Fixed memory usage on low-RAM devices.\
• Fixed Docker onboarding, sign-out, pairing, profile handling, weather overlays, and startup flow.\
• Fixed Restricted Content scheduling, playback, commercials, library visibility, and PIN handling.\
• Fixed local playback, library syncing, playlists, collections, commercial sourcing, image caching, guide focus, startup performance, Docker content generation, web UI behavior, and hundreds of additional bugs throughout the app.

</details>
{% endupdate %}

{% update date="2026-05-07" %}

## v0.7.48

#### 📡 New Media Types & Sources

* Live Stream Channels: Added foundational support for integrating internet radio, HLS network streams, and live IPTV streams alongside your standard media libraries.
* Plex Trailers Integration: Introduced Plex Trailers as a brand-new source type inside the Advanced Commercials configuration.
* Smart Content Tracking: Upgraded the system with TMDB/IMDB/TVDB GUID matching for reliable cross-server syncing, alongside content manifests that ensure your custom channels survive Plex database rescans or server migrations.

#### 🎭 Expanded Video Features & Retro Aesthetics

* CRT Static Overlay: Added classic CRT static overlay visual effects with fully adjustable intensity sliders to capture that authentic retro tube-TV look.
* Subtitle Styling Suite: Introduced a comprehensive Subtitle Styling editor, featuring full customization over text fonts, colors, border sizing, and screen positioning.
* Interactive Media Enhancements: Added live airing progress bars, a redesigned "Up Next" credits popup with countdown buttons, and dedicated "We’ll Be Right Back" intermission screens during break sequences.

#### 🍿 On Demand & Guide Logic Upgrades

* Premium Interface Layouts: Added Disney+/Hulu-style On Demand content rows paired with autoplay hero trailers on dashboard views.
* Guide Idle Actions: Introduced automated Guide Idle Action modes, allowing the screen to switch to *Auto Scroll*, jump straight to *Fullscreen* video, or turn *Off* after inactivity.
* Remote Visuals: Integrated channel logos directly across the web remote interface and channel editor screens for faster identification.

#### 🌐 Cross-Server & Sync Enhancements

* Robust Imports: Major cross-server import logic upgrade. The system now preserves unmatched titles on foreign servers instead of wiping them out, keeping your custom channel lineups intact.
* Stability Patches: Squashed catastrophic cross-server bugs that previously corrupted or deleted custom channel profiles during network imports.
* Cloud Sync Fixes: Resolved cloud synchronization failures triggered by server mismatches or corrupted rating keys.

#### 🛠️ Performance & Navigation Patching

* Memory & Crash Protection: Fixed critical stability issues including `CursorWindow` crashes caused by extraordinarily large program schedules, alongside extensive Fire TV memory optimizations for endless long-session streaming.
* D-Pad Flow Restoration: Fixed recurring Android TV focus traps and resolved overlay navigation problems to make sure menus don't capture your remote inputs.
* Trailer Playback Stability: Fixed direct-play failures, silent trailer drops on the Hero Banner, and standby/tuning hangs when switching to dedicated trailer channels.

<details>

<summary>raw changelog</summary>

* Added Live Stream channels for internet radio, HLS streams, and live TV
* Added Plex Trailers as a new Advanced Commercial source type
* Added full Subtitle Styling editor with custom fonts, colors, sizing, and positioning
* Added Auto Sign-Off / “Are You Still Watching?” standby mode
* Added CRT static overlay effects with adjustable intensity
* Added Disney+/Hulu-style OnDemand rows and autoplay hero trailers
* Added live airing progress indicators and “We’ll Be Right Back” break screens
* Added Guide Idle Action modes (Auto Scroll / Fullscreen / Off)
* Added channel logos throughout the web remote and channel editor
* Added improved Up Next credits popup with countdown buttons
* Improved What’s On trailer channel playback and reliability
* Improved Plex direct-play/transcode handling
* Improved trailer playback across Hero Banner, channels, casting, and mobile
* Improved TV navigation, overlays, D-pad focus flow, and player controls
* Improved Fire TV long-session stability and memory handling
* Improved cloud sync and config import/export reliability
* Added TMDB/IMDB/TVDB GUID matching for reliable cross-server syncing
* Added content manifests so channels survive Plex rescans/server changes
* Cross-server imports now preserve unmatched content instead of wiping channels
* Fixed catastrophic cross-server import bugs affecting custom channels
* Fixed multiple Plex authentication and playback bugs
* Fixed CursorWindow crashes caused by huge schedules
* Fixed Fire TV playback stability/memory issues
* Fixed direct-play failures for Plex trailer URLs
* Fixed cloud sync failures from ratingKey/server mismatches
* Fixed Hero Banner trailers silently failing with no logs
* Fixed standby/tuning screen hangs on trailer channels
* Fixed Android TV focus traps and overlay navigation issues
* Fixed advanced commercial scheduling parity issues
* Fixed multiple trailer playback/transcode edge cases
* Fixed numerous schedule generation and sync bugs

</details>
{% endupdate %}

{% update date="2026-04-26" %}

## v0.7.30

#### 🍿 On Demand & Navigation Overhaul

* On Demand Hero Banner: Added a dynamic main banner featuring smooth auto-scrolling, trailer playback support, long-press actions, and direct episode navigation.
* Multi-Library Selection: The Movies and TV tabs now support multi-library selection, letting you toggle and browse multiple server libraries simultaneously.
* Navigation Persistence: Improved the On Demand flow so returning or backing out of a selection drops you back onto the correct screen instead of resetting your position.

#### 🎬 Playback, Timeline & Control Fixes

* Interactive Scrubbing: Completely overhauled timeline interaction. You can now tap/drag the progress bar, use double-tap to skip, and view a live buffering indicator.
* Timeline Sync Patches: Fixed the scrubbing and timeline desync errors that impacted both live linear TV and on-demand playback modes.
* Linear TV Startup: Fixed live TV startup seeking errors and corrected the playback offsets that caused timing drift.
* Long Session Stability: Fixed clock and progress drift during extended viewing sessions, keeping the guide and streams aligned.
* Focus & Controls: Fixed an issue where the player controls would lose remote focus or fail to update the play/pause state correctly.

#### 📂 Channel Curation & Branding

* 3-State Channel Logo: Channel logos are now more flexible with a new three-way toggle: Off / Periodic / Always On.
* Streamlined Channel Editor: Upgraded the editor interface with a new *Add by Library* dropdown, direct source removal, and snappier real-time layout updates.
* Curation Bug Fixes: Fixed the *Add to Channel* and *Plays On* functions missing valid channels, and resolved instances where server libraries or content failed to load in the editor.
* Commercial Polish: Fixed commercial playback bugs, including break alignment issues, unwanted repeating loops, and end-of-file (EOF) freeze states.

#### 🌐 System, Sync & Multi-Server Stability

* Multi-Server Content Routing: Resolved cross-server library, commercial, and content routing conflicts on multi-server setups.
* Cloud Sync Integrity: Squashed cloud sync inconsistencies by patching stale configuration hashes and profile-aware sync data.
* Audio & Subtitle Logic: Fixed user audio and subtitle preferences failing to apply correctly across server streams.

#### 🛠️ Performance & Device Optimization

* Crash Prevention: Patched critical stability bugs, including a Fire OS SQLite incompatibility, a Firebase sync NullPointerException (NPE), and large image Out-Of-Memory (OOM) failures.
* Background Audio: Fixed a bug where theme music would continue playing after backgrounding the app on mobile or TV devices.
* Mobile UX Adjustments: Improved scaling for the *Connect Plex* screen on mobile displays alongside tighter tab spacing and layout fixes.

<details>

<summary>raw changelog</summary>

* Added multi-library selection for Movies/TV tabs (toggle multiple libraries at once)
* Added On Demand hero banner with auto-scroll, trailers, long-press, and episode navigation
* Added improved scrubbing (tap/drag timeline, double-tap seek, buffering indicator)
* Added progressive seek controls (hold to accelerate up to 30 min skips)
* Added 3-state Channel Logo setting (Off / Periodic / Always)
* Improved channel editor (Add by Library dropdown, source removal, real-time updates)
* Improved playlist handling (filters empty playlists + better feedback messages)
* Improved On Demand navigation (resume flow, returns to correct screens)
* Improved UI/UX (mobile Connect Plex scaling, tab spacing, layout fixes)
* Fixed live TV startup seeking + incorrect playback offsets
* Fixed scrubbing/timeline desync for both live and on-demand playback
* Fixed Add to Channel / Plays On missing valid channels
* Fixed audio/subtitle preferences not applying correctly
* Fixed Pro tab button feedback + D-pad focus/navigation issues
* Fixed crashes (Firebase sync NPE, Fire OS SQLite incompatibility, large image OOM)
* Fixed theme music continuing after app backgrounding
* Fixed channel editor bugs (libraries not showing, content not loading)
* Fixed cloud sync inconsistencies and stale config/hash issues
* Fixed multi-server issues (commercials, libraries, incorrect content routing)
* Fixed playback edge cases (on-demand return, completion handling, freeze cases)
* Fixed player controls losing focus + incorrect play/pause state updates
* Fixed idle timeout causing unexpected screen changes
* Fixed commercial playback issues (alignment, repeats, EOF freeze)
* Fixed clock/progress drift during long sessions
* Fixed a bunch of minor issues

</details>
{% endupdate %}

{% update date="2026-04-17" %}

## v0.7.18

#### 🎬 Playback, Video & Audio Upgrades

* Custom Aspect Modes: Added true 4:3 modes (including Zoom) alongside major improvements to widescreen/stretch aspect ratio handling.
* Audio & Surround Sound Control: Added a Preferred Audio Codec + Surround Sound Selector (configured per-profile, affecting both direct playback and server transcoding).
* Progressive Scrubbing: Improved seeking with timeline acceleration that scales smoothly from 10 seconds up to 30 minutes the longer you hold the control.
* Stream Stability: Better overall playback reliability with foundational MPV player fixes, enhanced AV1 support, and a reduction in buffering or temporary black-screen freezes.
* Subtitles & Language Overrides: Upgraded external subtitle support, language selection accuracy, and audio codec fallback logic.

#### 📺 UI, Navigation & Remote Control

* A–Z Quick Navigation: Added an A–Z jump rail for TV layouts and an alphabetical scroller for mobile devices to navigate massive libraries instantly.
* Player Layout Refactor: Redesigned player controls and optimized D-pad response times for snappier seeking and menu navigation.
* Long-Press Shortcuts: Added long-press remote actions to quickly view media details, trigger navigation shortcuts, or swap back to your previous channel.
* Broadcast Rating Overlays: Added an optional, broadcast-style parental rating overlay that pops up at the start of programming (toggled via profile settings).
* Dim & Past Content: Improved guide rendering with a windowed EPG system and faster image loading using seamless crossfading, caching, and optimized asset sizes.

#### 👥 Profile Redesign & Sync

* Avatar Customization: Completely updated the profile manager with a brand-new Avatar System that supports default graphics and custom image uploads.
* Top Bar Profile Indicator: The active profile avatar is now prominently displayed in the top navigation bar.
* Pro Cloud Sync: Enhanced sync reliability across complex multi-device networks using the upgraded Pro backend.

#### 📂 Advanced Channel & Library Curating

* Deep Channel Logic: Added deduplication controls, preferred server designations, and explicit language overrides directly inside the channel editor.
* Flexible Scheduling: Introduced a highly requested “Any Movie” scheduling option alongside playlist order sorting and persistent cyclic tracking.
* Add-to-Channel Shortcut: Streamlined curation with a dedicated "Add-to-Channel" button found right on media asset screens.
* Improved Commercial Handling: Commercial shuffles are now fully persistent across app restarts, with deeper multi-server support and advanced break scheduling fixes.

#### 🍿 On Demand & DVR Library Browsing

* Next-Gen On Demand: Fully overhauled the On Demand dashboard with responsive rows, snappy animations, focus-restore fixes, and smoother browsing performance.
* DVR Integration: Added native DVR/On Demand browsing complete with full, dedicated media detail screens and live broadcast indicators.

#### 🛠️ Performance & Engine Fixes

* Stability & Memory: Massively slashed memory consumption across the app via aggressive lazy loading, EPG caching optimizations, and targeted fixes for out-of-memory (OOM) errors and ANRs during massive library parses.
* Remote Parity: Resolved parity bugs between mobile and TV clients, making sure focus, scrolling, dialog overlays, and directional navigation operate identically across platforms.
* Under-the-Hood Fixes: Patched storage access framework (SAF) picker loops, theme music/UI sound bugs, and stabilized backend Pro billing verification.

<details>

<summary>raw changelog</summary>

* Added preferred audio codec + surround sound selectors (per-profile, affects playback + transcode)
* Added Add-to-Channel button
* Improved image loading (crossfade, memoization, faster posters, reduced asset size)
* Added parental rating overlay (profile toggle, broadcast-style)
* Added A–Z jump rail (TV) + mobile alphabet scroller
* Redesigned profiles (avatar system, custom uploads, top bar display)
* Reworked player controls layout + D-pad behavior (faster seek + navigation)
* Added progressive scrubbing (10s → 30min acceleration)
* Added 4:3 modes incl. Zoom + improved aspect handling
* Added dedup + preferred server + language overrides in channel editor
* Improved multi-server handling + Plex connection stability (concurrency + routing fixes)
* Improved On Demand system (rows, navigation, performance, focus restore, animations)
* Added DVR / On Demand browsing with full detail screens + live indicators
* Added long-press interactions (details, navigation shortcuts, previous channel)
* Improved library browsing (multi-server labels, dropdown fixes, faster loading)
* Added playlist order sorting + cyclic tracking persistence
* Added channel packs + “Any Movie” scheduling option
* Improved subtitle + audio handling (external subs, language selection, codec fallback)
* Improved commercial system (shuffle persistence, advanced break fixes, multi-server support)
* Improved Cloud Sync + Pro sync reliability across devices
* Improved playback stability (MPV fixes, AV1 support, buffering + black screen fixes)
* Improved performance (memory reduction, lazy loading, windowed EPG, caching optimizations)
* Fixed extensive UI/UX issues (focus bugs, navigation, dialogs, overlays, mobile/TV parity)
* Fixed On Demand, guide, and detail screen state bugs (focus, scroll, restore)
* Fixed crashes (OOM, ANR, WebView, SAF picker, large libraries, IPTV parsing)
* Fixed theme/music playback issues + UI sound handling
* Fixed billing + Pro purchase/restore reliability

<br>

</details>
{% endupdate %}

{% update date="2026-04-07" %}

## v0.6.48

#### 🔥 **MAJOR NEW FEATURES**

* **Automatic Cloud Sync** — Enhanced Firebase integration for seamless, automated synchronization across all your devices.
* **Dynamic Server Switching** — The app now automatically detects and switches to the fastest Plex connection (local vs. remote) without interrupting your show.
* **Mid-Program Commercials** — Support for natural break points, including halfway marks and chapter-based triggers.
* **Music as Commercials** — You can now use music tracks as commercial sources, featuring a new quick-picker for rapid setup.
* **New NMP Visualizer** — A brand new music visualizer engine with multiple animated styles.

#### ✨ **INTERFACE & UX**

* **Music Overhaul** — Improved music channel layouts with smoother visuals and real-time track info displays.
* **Smart UI** — Smoother settings navigation, clearer sorting descriptions, and the **CUSTOM** badge for modified default channels.
* **Streamlined Setup** — Support for configuration imports directly from the profile screen with multi-profile support.
* **Control Support** — Full integration for TV remote media buttons (Play/Pause, Skip, Rewind).

#### ⚙️ **SYSTEM & PERFORMANCE**

* **Speed & Size** — Reduced the overall app footprint and significantly improved startup speeds.
* **Firebase Cleanup** — Automated maintenance to prevent old schedules from building up in your database.
* **Stability** — Fixed audio dropouts, playback freezes, and crashes during transitions.
* **Session Recovery** — Added automatic login recovery for expired Plex sessions.

#### 🛠️ **CRITICAL FIXES**

* **Sync & Claims** — Resolved Firebase device claim problems and "Sync Now" inconsistencies.
* **Content Management** — Fixed library refresh bugs where deleted content remained and resolved server-switching leftover data.
* **Logic Fixes** — Corrected episode starting points in cyclic modes and fixed Kid/Adult mode channel behavior.
* **Hardware Support** — Significant performance optimizations for the Nvidia Shield and lower-end devices.

<details>

<summary>raw changelog</summary>

* Automatic cloud sync (Firebase sync features)
* Added dynamic Plex server switching — automatically uses the fastest connection (local or remote) without interrupting playback
* Reduced app size and improved startup speed
* Added mid-program commercial breaks — supports natural break points like halfway or chapters
* Added music as a commercial source + quick picker for easier setup
* Added new NMP music visualizer with multiple animated styles
* Improved settings performance for smoother navigation
* Improved sorting UI with clearer options and descriptions
* Improved music info display — now shows real track details
* Improved music channel layout with smoother visuals
* Added config import from profile screen (multi-profile support)
* Added automatic login recovery when Plex session expires
* Added CUSTOM badge for modified channels
* Added TV remote media controls (play, pause, skip, rewind)
* Fixed Firebase schedule cleanup — old schedules no longer build up over time
* Fixed Firebase sync issues and device claim problems
* Fixed music visualizers not reacting correctly
* Fixed playback stability issues (freezes, crashes, transitions)
* Fixed audio dropouts during playback
* Fixed startup forcing library re-selection
* Fixed library saving/loading issues
* Fixed performance issues on lower-end devices and Shield
* Fixed episode starting points in cyclic modes
* Fixed channel content pulling incorrect items
* Fixed content balancing issues
* Fixed Plex API compatibility issues
* Fixed library refresh not removing deleted content
* Fixed kid/adult mode channel behavior
* Fixed leftover content from removed servers
* Fixed device sync issues after reinstall
* Fixed Sync Now not syncing everything properly
* Fixed various UI bugs and inconsistencies

</details>
{% endupdate %}

{% update date="2026-04-05" %}

## v0.6.45

#### 🔥 **MAJOR NEW FEATURES**

* **Round Robin Modes** — Added **Round Robin Shuffle & Cyclic**. These modes rotate exactly one episode per show before repeating, ensuring your variety channels stay diverse.
* **Guide Scaling** — Added **Guide Block Size scaling (70–150%)**. You can now fully resize the EPG interface in both the app and the Web UI.
* **Music Visuals** — Brand new **Music Visual Modes** for audio-only content, including Default, Slow-Motion, and the retro-styled **NostalgiAmp**.
* **Global Auth Handler** — Improved Plex stability with a global handler that automatically redirects to login if your token expires.

#### ✨ **INTERFACE & UX**

* **Sorting Overhaul** — New dropdown selector for sorting modes with inline descriptions for easier management.
* **Custom Badges** — Default channels now display a **CUSTOM** badge if you have added your own content to them.
* **Remote Support** — Full support for physical remote media buttons (Play/Pause, Skip, Rewind, etc.).
* **Improved Navigation** — Fixed D-pad focus issues in dialogs and the color picker for a smoother TV experience.

#### ⚙️ **SYSTEM & SYNC**

* **Smart Imports** — You can now import configurations directly on the profile screen with support for merging multiple profiles.
* **Marathon Continuity** — Improved marathon scheduling that correctly continues the current show across guide regenerations.
* **Cloud Sync Fixes** — "Satellite" devices now correctly sync both the system configuration and the guide schedule simultaneously.

#### 🛠️ **CRITICAL FIXES**

* **MPV Engine** — Resolved issues with freezing, channel switching, PiP, and 4:3 zoom logic.
* **Subtitles** — Corrected rendering to ensure SRT/VTT text is centered and fixed forced/full subtitle selection logic.
* **Web UI** — Fixed bugs where channel edits wouldn't update and resolved the time indicator opacity glitch.
* **Content Fixes** — Resolved a library selection bug and fixed content sourcing for the P.B.Yes channel.

<details>

<summary>raw changelog</summary>

* Added Round Robin Shuffle & Cyclic — rotates one episode per show before repeating
* Added Guide Block Size scaling (70–150%) for full EPG resizing (app + web)
* Added Music Visual Modes — Default, Slow-Motion, and NostalgiAmp
* Added Import Configuration on profile screen with multi-profile merge support
* Added remote media button support (play/pause, skip, rewind, etc.)
* Added global Plex auth handler — auto-returns to login if token expires
* Added CUSTOM badge for default channels with user-added content
* Improved sorting system UI — dropdown selector with inline descriptions
* Improved library/profile import flow — import into active profile with picker support
* Improved marathon scheduling — continues current show across regenerations
* Improved multi-server support — correct routing for playlists, collections, and web remote requests
* Fixed subtitle rendering + behavior — centered SRT/VTT text and corrected forced/full subtitle selection
* Fixed MPV playback issues — freezing, channel switching, PiP, 4:3 zoom, and subtitle handling
* Fixed web UI issues — channel edits not updating, time indicator opacity bug
* Fixed cloud sync issues — satellite devices now sync both config and guide correctly
* Fixed library selection bug — no longer forces re-selection if Plex is slow on startup
* Fixed channel content issues — P.B.Yes now includes correct adult PBS content
* Fixed D-pad navigation issues — improved focus handling in dialogs and color picker
* Fixed many more issues

</details>
{% endupdate %}

{% update date="2026-03-28" %}

## v0.6.25 (minor update)

#### ✨ **STABILITY & UI FIXES**

* **Multi-Server Reliability** — Fixed several underlying issues with multi-server connectivity and routing.
* **Web UI Content Management** — Resolved a bug where **Collections** were not working correctly on default channels.
* **Persistent Actions** — Fixed the **"Clear Content"** tool in the Web UI to ensure changes are properly saved.
* **Auto-Save Improvements** — Fixed a bug where **Advanced Scheduling** settings in the Web UI would fail to auto-save.
* **Picker Stability** — Fixed the **Genre/Playlist picker** getting stuck on "Loading..." after adding new content to a channel.
* **Channel Sorting** — Resolved false **"Channel number is already in use"** warnings when using A-Z, Pack, or Shuffle sorting modes.

<details>

<summary>Raw changelog</summary>

* Fixed multi-server issues
* Fixed web UI collections not working on default channels
* Fixed web UI "Clear Content" not persisting
* Fixed web UI advanced scheduling settings not auto-saving
* Fixed web UI genre/playlist picker getting stuck on "Loading..." after adding content to a channel
* Fixed false "Channel number is already in use" warnings when sorting channels by A-Z, Pack, or Shuffle

</details>
{% endupdate %}

{% update date="2026-03-26" %}

## v0.6.21

#### 🔥 **MAJOR NEW FEATURES**

* **MPV Player Support** — Integrated the MPV playback engine for superior format compatibility and performance.
* **External Sources (HDHR Emulators)** — Support for **DizqueTV, ErsatzTV, Threadfin, and xTeVe**! Import external channels with full EPG and playback.
* **Binge-Watch Overhaul** — Added **Marathon Shuffle** and **Marathon Cyclic** sorting modes for the ultimate series binging experience.
* **Content Priority Controls** — Per-channel management for **deduplication**, resolution preferences, and preferred server selection.

#### 🎨 **INTERFACE & CUSTOMIZATION**

* **Animated Logos** — New **Animate Channel Logo** toggle with improved layering for overlays, credits, and system notifications.
* **Advanced Sorting** — New **Channel Sort Cycler** with Number, Alphabetical, Channel Pack, and Shuffle modes.
* **Visual Polish** — Added **Program Cell styling** (custom gaps/rounded corners) and **Auto Fullscreen on Startup**.
* **Subtitles** — Added **Forced Only** mode and upgraded multi-line subtitle rendering.

#### ⚙️ **SYSTEM & PERFORMANCE**

* **Incremental Cache Revalidation** — No more full library rebuilds! The app now uses Plex timestamps to update only what's necessary.
* **Smart Scheduling** — Improved freshness tracking and reduced repetition for both content and commercials.
* **Massive Library Support** — Full pagination support for libraries with **over 10,000 items**.
* **Plex Reliability** — Added automatic heartbeat recovery and reconnection logic.

#### 🌐 **WEB UI & UX**

* **Improved Tools** — Added **Bulk Delete**, persistent search states, and better refresh handling.
* **Parity** — Better auto-save behavior and clearer controls to match the app interface.

#### 🛠️ **BUG FIXES**

* **Playback** — Fixed MPEG4/DivX/XviD issues, scratchy audio, and MPV seek crashes.
* **Cloud Sync** — Resolved race conditions, ownership conflicts, and stale state issues.
* **Schedules** — Fixed Marathon/Cyclic jumps and gap-fill inconsistencies.
* **Servers** — Fixed routing errors and crashes when specific servers go offline.

<details>

<summary>Raw changelog</summary>

* Added MPV player support
* Added Marathon Shuffle & Marathon Cyclic sorting
* Added Animate Channel Logo toggle + improved logo layering with overlays, credits, and notifications
* Added Channel Sort cycler — Channel Number, Alphabetical, Channel Pack, and Shuffle modes
* Added Content Priority controls (per-channel) — deduplication, resolution preference, and preferred server selection
* Added Forced Only subtitles mode and improved subtitle rendering (multi-line + forced handling)
* Added Program Cell styling options — gaps and rounded corners per theme
* Added Watch Reminder improvements
* Added Auto Fullscreen on Startup option
* Added External Sources (HDHR emulators) — import channels from DizqueTV, ErsatzTV, Threadfin, xTeVe with EPG + playback
* Added incremental cache revalidation — avoids full library rebuilds using Plex timestamps
* Added automatic Plex reconnection + heartbeat recovery\
  Improved schedule generation — reduced repetition (content + commercials), better freshness tracking, and proper cyclic/marathon continuation
* Improved multi-server reliability — faster connection order and correct routing for all APIs
* Improved channel customization UX — auto-save behavior, clearer controls, and better web UI parity
* Improved web UI tools — bulk delete, better refresh handling, persistent search state, and stable polling
* Improved performance/stability on large libraries — full pagination support (>10K items) and optimized refresh paths
* Fixed video/audio playback issues — MPEG4/DivX/XviD playback, scratchy audio, seek crashes, and MPV track/control issues
* Fixed multi-server bugs — incorrect routing, crashes when servers unavailable, fallback playback issues, and cache corruption
* Fixed schedule bugs — cyclic/marathon jumps, gap-fill issues, advanced scheduling inconsistencies, and content-clearing edge cases
* Fixed cloud sync reliability — ownership handling, race conditions, primary-device conflicts, delete validation, and stale state issues

</details>
{% endupdate %}

{% update date="2026-03-17" %}

## 0.5.37

#### 🌐 Multi-Server & Cross-Server Support

* Full Multi-Plex Server Support: Added the ability to select libraries across multiple servers, with server-qualified playback, artwork routing, and API handling.
* Cross-Server Config Import: Exported configs now include a content manifest. When importing to a different server, the app matches media by title/year/type and strips unmatched content to prevent "phantom" media.
* Server Selection UI: Added a scrollable server dropdown and a library selection summary with multi-server delay warnings.

#### 📅 Advanced Scheduling & Channel Management

* Advanced Scheduling UI: The web UI now features interactive scheduling sections including balance modes, hour restrictions, content weighting, and dedicated time slots.
* Stable Channel Identifiers: Channels now use permanent IDs. Logos, commercials, and preferences now survive renumbering or adding default channels.
* Channel Packs: Group your channels into packs (e.g., Kids, Movies, Streaming) with custom visibility controls.
* Enhanced Editor: The channel editor now shows "added-state" indicators (checkmarks) for collections, genres, and decades.

#### 🎨 Visuals & Themes

* New "Modern" Theme: A sleek Pro dark theme featuring charcoal, blue, and teal accents.
* WeatherStar 4000+ Mode: A new classic display for "The Storm Channel" with configurable locations, scan lines, and international support.
* Dim Ended Programs: Past programs are now visually dimmed in the guide to make current/upcoming content pop.
* Guide Metadata: Added movie release years and audience ratings directly to the guide info panel.
* Logo Preservation: Rectangular custom logos now preserve their aspect ratio and no longer appear squished.

#### ⚙️ Improvements & QoL

* Admin Tab & Primary Device Mode: Designate one device as the "Primary Writer" for Firebase sync while others remain "Receive-Only."
* Hardware Support: Added `CHANNEL_UP` / `CHANNEL_DOWN` support for dedicated remote buttons during fullscreen playback.
* Quick Profile Switching: Cached schedules now allow for near-instant profile changes.
* Import/Export Parity: Shared dialogs and matching options are now consistent across Profile, Design, Channel Customization, and the Web UI.
* Chromecast Enhancements: Improved config transfer reliability, richer notification metadata, and branded backdrop art.

#### 🛠️ Key Bug Fixes

* Navigation: Fixed multiple D-pad focus issues on TV/Chromecast where text fields would "trap" the user.
* Commercials: Fixed the bug where commercial toggles would incorrectly show as OFF after a restart.
* Theme Logic: Fixed the "Retro" theme color coupling (Top Bar vs. Settings text) and the "Reset Theme" function.
* Sync & Reliability: Resolved Firebase config mismatch warnings and fixed multi-profile imports overwriting existing data.
* Playback: Fixed an issue where paused shows were cut off if the wall-clock time passed the original scheduled end time.

<details>

<summary>Raw changelog</summary>

·       Added cross-server config import — exported configs now include a content manifest so media can be matched by title/year/type when importing to a different Plex server; unmatched content is stripped to prevent phantom media counts, and foreign library selections are cleared so users can reselect valid local libraries

·       Added full multi-Plex server support — multi-server library selection, server-qualified rating keys, per-server playback/artwork routing, multi-server content saving/fetching, qualified-key migrations, server-aware API routing, and config/Firebase compatibility for multiple Plex servers

·       Added advanced channel scheduling support in the web UI — all scheduling sections are now interactive with live channel content data, including balance mode, hour restrictions, weighting, time slots, and transition modes

·       Added stable channel identifiers — channels now use permanent IDs instead of depending on channel numbers, so overrides, logos, commercials, hidden channels, packs, and preferences survive renumbering and default-channel additions

·       Added channel packs — group channels into packs like Kids, Movies, and Streaming, with pack-based visibility controls, multi-pack membership, custom pack creation in web UI, and config import/export support

·       Added Modern theme — a new Pro dark theme with a modern charcoal and blue/teal look

·       Added movie year and audience rating to the guide info panel — shows metadata like release year and audience score in the tag row without extra API calls

·       Added Dim Ended Programs toggle — ended programs are visually dimmed in the guide to better distinguish past content from current and upcoming programming

·       Added KEYCODE\_CHANNEL\_UP / CHANNEL\_DOWN support — dedicated CH+/CH- remote buttons now change channels directly in fullscreen

·       Added Admin tab with Primary Device Mode — one device can be designated as the primary Firebase sync writer while other devices remain receive-only

·       Added channel editor added-state indicators — collection, genre, decade, and playlist dropdowns now show what has already been added with a checked state and label

·       Added scrollable server selection dropdown for users with many Plex servers

·       Added library selection summary and multi-server delay notice — screen now shows how many libraries and servers are selected and warns about possible delays when pulling from multiple servers

·       Added WeatherStar 4000+ mode for The Storm Channel — optional full-screen classic WeatherStar-style display with configurable location, screens, speed, units, scan lines, international mode, and extra weather views

·       Added WeatherStar mobile back-button overlay so users can return to the guide directly from the WebView

·       Added import/export parity across Profile Configuration, Design, Channel Customization, and web UI — shared dialogs and matching options including Local Device, Save to File, Share, Copy to/from Profile, and profile-scoped export/import

·       Added Local Device import/export support to Design and Channel Customization — send theme/design settings and channel configs directly to another device on the network using pairing

·       Added Copy from Profile to Library Selection import

·       Added Copy from Profile / Copy to Profile for Channel Customization import/export

·       Added Clear Sync Data buttons for config and schedule sync, available for the current profile or all profiles where applicable

·       Improved config import behavior for cross-server and library selection flows — library selections can be reviewed before continuing, imported configs can stay on or return from the library/profile selection flow as appropriate, and imported profiles/settings are easier to verify immediately

·       Improved Chromecast config transfer reliability — fixed premature server shutdowns during large config transfers and extended timeouts for slower devices

·       Improved Chromecast notification styling — cast notifications now show app branding, backdrop art, and richer metadata

·       Improved admin action visibility — “All Profiles” bulk actions now only appear when multiple profiles actually exist

·       Improved WeatherStar international UX — international placeholders and layout behavior now display correctly

·       Improved quick profile switching — cached schedules allow much faster profile changes without full regeneration

·       Improved channel logo behavior — persistent channel logos now behave correctly during commercials and credit detection overlays when always-on logos are enabled

·       Improved mobile settings parity — Swap D-pad Controls and Auto Change Channel on Navigation are now visible on mobile so transferred configs do not silently lose those settings

·       Improved Rad-Lad/PipBoy default font sizing for readability

·       Fixed library selection counts showing wrong server/library totals — stale entries are now pruned after discovery

·       Fixed Profile Configuration “Reset to Default” not fully resetting everything — now properly clears theme/design settings, channels, sync settings, guide toggles, and profile-aware files/directories

·       Fixed multi-server advisory text visibility on dark themes

·       Fixed profile editor disabled Default/Admin toggles becoming unreachable via D-pad — disabled toggles now remain focusable so navigation chains stay intact

·       Fixed web UI channel editor Save/Cancel buttons disappearing on Advanced tab, and fixed the Create Channel button placement in the new-channel modal

·       Fixed custom channel numbers showing/sorting incorrectly in web UI — custom display numbers now persist and render correctly, including decimalized formats

·       Fixed custom channel logos disappearing or desyncing after save/import in app and web UI — logo paths, overrides, delete behavior, and custom channel logo state now stay in sync across saves/imports

·       Fixed channel export pairing dialog appearing on the wrong tab

·       Fixed web UI import/export buttons using swapped arrow icons

·       Fixed Clear Content not fully clearing default-channel content — built-in genre/studio/curated matches are now suppressed correctly when content is cleared

·       Fixed channel overrides not surviving default-channel renumbering — custom names, logos, content, and similar overrides now migrate automatically when default channel numbers shift

·       Fixed custom theme Channel Column and Time Row colors not applying, and added a proper Focused Channel color role

·       Fixed duplicate-channel imports — channel import now skips case-insensitive duplicates instead of blindly appending copies

·       Fixed rectangular custom logos being squished — logos now preserve their original aspect ratio throughout the app

·       Fixed channel editor search results missing library name labels — library titles now save and display properly

·       Fixed web UI Advanced sub-tab showing “undefined”

·       Fixed config import or sync not applying theme fonts, sizes, and runtime design settings immediately — design/theme state now reloads correctly after import, sync, export-based profile changes, and profile switches

·       Fixed Firebase/cloud sync applying settings incompletely and fixed false config mismatch warnings caused by reading from legacy/default preference storage

·       Fixed Initial Media Indexing note reappearing on profile switch

·       Fixed multi-profile import overwriting existing profiles — imports now merge cleanly without deleting unrelated profiles

·       Fixed guide preview freezing during casting — guide preview now immediately shows the cast overlay

·       Fixed profile list not refreshing until restart after creating a new profile

·       Fixed swapped D-pad channel controls breaking after rewind/fast-forward

·       Fixed partial content fetches on large Plex servers — playlists, collections, and smart collections now load fully

·       Fixed multiple TV/profile editor D-pad issues — text fields no longer trap focus, down-navigation chains work correctly, Cancel/Save remain reachable, and trapped focus cases on TV/Chromecast are resolved

·       Fixed name/PIN field directional navigation by intercepting D-pad events before the text field consumes them

·       Fixed commercial channel toggles showing OFF after restart

·       Fixed Add Custom Channel not auto-scrolling to the new channel form

·       Fixed Reset Theme to Default not fully applying design settings to the guide/EPG

·       Fixed Retro theme settings text color coupling with Top Bar color

·       Fixed group-channel playback crash/ANR caused by reading from the wrong profile directory

·       Fixed web remote Refresh Schedule / Refresh Library & Schedule not triggering regeneration

·       Fixed Commercials tab empty/stuck loading states and related spinner race conditions

·       Fixed guide artwork not loading on quick resume

·       Fixed commercials repeating after profile-based config import

·       Fixed paused shows being cut off when wall-clock time passes the scheduled end time — pause duration now shifts effective playback timing, freezes progress while paused, and keeps overlay timing accurate

·       Fixed clearing all channel content still showing genre/studio-matched items when reopening — clear now fully clears fallback content sources in both app and web UI

·       Fixed Allow Specials not excluding Season 0 episodes properly — specials are now excluded at the content-matching layer when the toggle is off

·       Fixed casting music tracks restarting from the beginning after returning from Settings — cast resume position is now respected

·       Fixed Manage Profiles button being unreachable via D-pad on TV/Chromecast

·       Fixed Library Selection Copy From Profile dialog colors

·       Fixed import dialog D-pad flow so Down lands on the primary Import action

·       Fixed WeatherStar international mobile centering

·       Fixed WeatherStar / Storm theme dropdown text colors in Retro and Classic themes

</details>
{% endupdate %}

{% update date="2026-03-11" %}

## v0.5.16

### Multi-Profile & Cloud Sync

* Added Multi-Profile system (Pro): Supports up to 6 profiles with isolated settings, libraries, channels, and themes; includes adult/kid modes, PIN locks, and auto-login.
* Added Admin profile role: Allows syncing all profiles, exporting/importing full configurations, and managing profile-level actions with UI badges.
* Added per-profile schedules and Firebase sync paths: Profiles maintain independent cloud configurations without overwriting others.
* Added Database Configuration Sync via Firebase: Syncs settings, channels, schedules, commercials, and themes across devices.
* Added cloud sync options: Choose between syncing the active profile only or the full configuration from admin accounts.
* Added device-aware sync indicators: Includes config mismatch detection with cached state and metadata checks.
* Improved cloud sync reliability: Features lightweight metadata checks, exponential backoff retry logic, and connection leak fixes.

### Configuration & Import/Export

* Improved config import/export: Profile-aware imports, merge modes, overwrite warnings, and profile-to-profile copy tools.
* Added channel configuration import/export: Share custom channels, overrides, and logos between devices.
* Added theme export/import: Full Design tab customization tools for colors, fonts, and scaling.
* Added Import Configuration during initial setup.
* Added Share option when exporting configurations.

### UI & Customization

* Added Classic theme: DirecTV-style guide with expanded palette overrides and font selection.
* Improved theme consistency: Palette colors now propagate across all screens and components.
* Added customizable EPG elements: Change the color and opacity of the time indicator.
* Added 24-hour clock option: Available for both the guide and overlays.
* Added channel number formatting: Supports freeform input like leading zeros, decimals, and dashes.
* Added Hide Channel Numbers toggle: Replaces numbers with logos in the guide.
* Added Detailed EPG toggle: Expanded two-line program information.
* Improved navigation: Two-level Settings navigation and improved back-button behavior.
* Improved profile management UI: Mobile-friendly layouts with better focus navigation and selection interfaces.

### Content & Channel Management

* Added Groups feature: Bundle videos into named groups that display as a single program block with guide descriptions.
* Improved channel editor tools: Added "Clear All Content," "Copy From channel," and bulk editing tools in the web UI.
* Added advanced commercial tools: Shuffle-bag playback ensures ads play once before repeating; includes a "Copy From" tool for ad configs.
* Added Storm Channel improvements: Better editor tools and cross-theme weather crawl compatibility.
* Added new channels: BETV, P.B.Yes, C.B.Sea, Faux Kids, and Kids’ DuB.
* Added auto-kids integration: Automated filtering for Kid Mode.
* Added “Watched Only” toggle: For spoiler-free viewing.
* Added previous channel recall: Traditional TV remote functionality.

### Connectivity & Integration

* Added Chromecast support: Includes mobile casting overlay, device picker, and auto-transcoding for compatibility.
* Added Home Assistant / REST API support: Includes tune commands and channel navigation endpoints.
* Added web remote profile selector: Profile-aware remote controls via the web UI.

### Performance & Playback Improvements

* Improved guide scalability: Converted large channel lists to lazy loading for better performance.
* Improved Plex integration: Better handling of large collections, playlists, and smart collections.
* Improved audio compatibility: Mono PCM tracks are upmixed to stereo; replaced normalization with a DynamicsProcessing compressor/limiter.
* Added three-stage playback fallback: Direct play → audio-only transcode → full transcode to preserve quality.
* Improved stability: Memory-safe request handling for the web server and reduced ANRs/GC stalls on low-RAM devices.
* Improved profile security: Kid profiles now require an adult PIN for settings access.

### Fixes

* Fixed cloud sync issues: Resolved incorrect status reporting, metadata caching bugs, and device-specific overwrites.
* Fixed profile bugs: Resolved crashes, navigation issues, and delayed profile updates.
* Fixed playback errors: Resolved groups/collections scheduling errors and commercial repetition bugs.
* Fixed guide issues: Resolved highlighting bugs, preview freezes during casting, and artwork loading race conditions.
* Fixed Web UI bugs: Resolved alignment issues, dropdown styling, and apostrophe handling.
* Fixed logo and asset issues: Resolved scaling bugs and orphaned files after deletion.
* Fixed device-specific bugs: Resolved D-pad navigation issues and Android-specific audio/Surface playback problems.
  {% endupdate %}

{% update date="2026-02-27" %}

## v0.4.14

#### New

* Bulk Editing: Introduced the ability to edit multiple channels simultaneously via the Web UI (currently in beta/testing phase).

#### Improved

* Cyclic Sorting: Movies now mirror the behavior of TV shows by starting in a random order when using the Cyclic sorting method.

#### Fixed

* Playback & Video
  * Resolved an issue where DV playback would trigger unnecessary transcoding when paired with TrueHD audio tracks.
  * Fixed a bug where restarting an episode would cause it to cut off prematurely at the next scheduled program block.
  * Corrected a cropping issue when using the 4:3 CRT Display Mode.
  * Removed the "Tuning" message from appearing when no tuning action was actually occurring.
* Web UI & Navigation
  * Synchronized the Web UI with the app database to ensure channel numbers and data are consistently displayed.
  * Fixed a bug where Channel Logos (including Storm, Weather, and Music channels) were not saving correctly for new or existing stations.
  * Improved Weather Channel scaling and layout for smaller mobile devices.
  * Resolved D-pad navigation issues within the Import/Export configuration popups.
* System & Stability
  * Fixed a crash that occurred when selecting an empty media library for a Music Channel.
  * Resolved a critical failure where Schedule Generation would fail and redirect the user back to the loading screen.

#### 🛠️ Developer Notes

> **Testing in Progress:** We are still monitoring the Schedule Generation fix (verifying stability over 4+ hour sessions) and the Bulk Editing feature. If you encounter issues with these, please report them in the Discord.
> {% endupdate %}

{% update date="2026-02-25" %}

## v0.4.7

#### New

* Virtual Channels & Content
  * Expanded the default lineup with new channels: Bravio, Trip Channel, Sea.N.N., and YESPN.
  * Added a massive library of default movies and shows to various channels (Special thanks to @Anth).
  * Implemented Smart Naming: Leaving a channel name blank will now automatically name the station after its assigned collection.
* User Interface & Experience
  * Added Landscape Guide View for mobile devices.
  * Introduced a Guide Timeline Bar toggle to track progress visually.
  * Added Navigation Toggles to allow the D-pad Up/Down buttons for channel surfing.
  * Added the Advanced Tab to the Web UI (foundation for upcoming scheduling features).
* Playback & Control
  * Added 10s Rewind/Fast-Forward scrubbing controls to the player.
  * Introduced an Auto-Play-Next function that skips to the next item if the current media fails to direct play or transcode.
  * Added a 30min and 1hr sleep timer intervals.
* Specialty Channels
  * Music Channels: Added a dedicated toggle, an individual track selector for albums, and automatic "Tune Choice" logo selection.
  * Weather Channel: Revised the design to mirror the classic "WeatherStar" look.
  * Kid Channel Toggle: Added a filter to restrict content to family-friendly ratings (G, PG, TV-G, TV-Y7, etc.).
* Advanced Controls
  * Commercials: Added a Commercial Interval Cycler with presets for :00, :05, :10, :15, and :30.
  * Branding: Added a cycler for Channel Logo Position and Opacity.
  * Scheduling: Added the Week-Long Schedule toggle and an Allow Specials toggle.
  * Server Setup: Added manual server address entry for non-standard ports/addresses.

#### Improved

* 4:3 CRT Mode: Changed to a "Preview Window" style to strictly force the 4:3 aspect ratio.
* Library Management: Refreshing libraries no longer resets cyclical episodes back to S01E01.
* Search: Improved special character parsing when searching for titles.

#### Fixed

* Stability: Fixed a bug where the same commercial would play on a continuous loop.
* Visuals: Resolved issues with the EPG Guide not showing items on startup and fixed various Weather Channel display bugs.
* Web UI: Fixed an issue where "Excluded Items" were not saving correctly in the Channel Customization tab.
* Playback: Resolved playback issues for non-standard movie/show formats and fixed various general system bugs.

#### 🛠️ Beta Features & Known Issues

> **Mark as Watched:** This toggle is now available but currently buggy; a fix is scheduled for the next update.
>
> **Manual Server Entry:** This feature is live, but users with non-standard setups are encouraged to report any connection issues in Discord.
> {% endupdate %}

{% update date="2026-02-21" %}

## v0.3.17

#### New

* System & Performance
  * Lightweight Caching: Implemented a new caching system to prevent crashes and improve functionality for users with large Plex libraries.
  * Plex Connectivity: Improved library detection to resolve issues where users had to switch server settings from "Required" to "Preferred."
  * Automatic Cleanup: Added an automatic app cleanup function to maintain system health.
* Channel Management
  * Bulk Controls: Added Show All and Hide All buttons to the Channel Customization tab for faster lineup management.
  * Navigation: Added Channel Numbering capabilities and a dedicated Hidden Channels section.
  * Branding: Added an Always Show Channel Logo option and moved the on-screen logo to the top-right of the fullscreen UI.
* Content Sourcing
  * Advanced Adding: Introduced more ways to populate channels, including by Genre, Decade, and Playlists.
  * Smart Naming: Blank channel names now automatically adopt the name of the assigned collection.
* Interface & Controls
  * Guide Navigation: Major D-pad improvements (Back to return to current time, Back again for top channel, Back again for top buttons).
  * Mobile & Handheld: Added controller support for mobile/handheld devices (e.g., Anbernic) and Auto-Landscape when entering fullscreen.
  * On-Screen Display: Fullscreen UI now displays Season/Episode numbers and Episode names.
* Specialty Features
  * Kid Mode: Introduced a dedicated Kid Mode toggle.
  * Weather Channel: Added the initial Weather Channel (currently in beta/buggy).
  * Audio: Added an Audio Normalization toggle to keep volume consistent across different media types.

#### Improved

* Web UI Parity: Refined the web interface to match the customization options available in the app.
* Music Channels: Ongoing refinements to the music station logic (currently in testing).
* App Store: The "Pro" tab now automatically hides after purchase to declutter the menu.

#### Fixed

* Scheduling: Resolved a "Content Bleedover" bug where media not assigned to a channel would appear in its schedule.
* Visuals: Fixed a bug where 4:3 CRT Mode didn't update the guide view, causing display issues.
* Pro Version: Fixed a synchronization issue where the Pro status wouldn't show up on secondary devices.
* Collections: Resolved an issue where Smart Collections weren't appearing in the "Added Content" list.
* General: Squashed various minor bugs across the interface and playback engine.

#### 🛠️ Developer Notes

> Weather & Music Channels: Both features are officially live but in early-access; expect some bugs as we continue to refine the logic.
> {% endupdate %}
> {% endupdates %}
