Release Notes
Klypp History
A timeline of product and platform milestones.
Relay stale stream health probe
- Added relay health checks to detect stale-but-ready relay streams.
- Improved recovery after router, DNS, or network interruptions without waiting for the long stale-stream fallback.
Settings quota popup sync
- Updated the settings quota popup to use fresh billing and subscription state.
- Tightened quota refresh behavior and added test coverage for the sync flow.
Relay auth recovery fix
- Preserved saved auth state during relay certificate issue failures.
- Improved relay recovery when access tokens expire by retrying refresh before requiring sign-in.
Cross-platform ephemeral key fix
- Fixed ephemeral key behavior for Windows, Linux, and macOS compatibility.
- Closed platform-specific mismatch issues affecting auth/handshake reliability.
File mover quiet-time/sleep behavior
- Added quiet-time behavior so files can queue before processing.
- Helped support overnight/NAS-friendly processing windows.
Plex refresh integration and path guidance
- Added server-triggered Plex refresh functionality.
- Added user guidance for exact path matching expectations between Plex and KlyppServer.
Relay cert/token self-heal and 401 retry
- Added relay token refresh and cert reissue retry on auth failures.
- Improved self-healing around cert lifecycle and silent-close reconnect edge cases.
Android snapshot loading fix
- Fixed Android loading behavior so snapshot items render instead of a blank screen.
- Improved first-load reliability in the app.
iOS direct upload fixes
- Updated iOS configuration to improve direct upload behavior.
- Reduced upload friction on Apple devices.
Startup preflight and offline deferral tuning
- Made destination preflight failures non-fatal at startup where appropriate.
- Capped offline deferral backoff to keep retries bounded and predictable.
Onboarding and account flow rework
- Added onboarding screens and updated account and pro navigation.
- Improved first-run experience and account discoverability.
Theme and palette refresh
- Centralized MAUI theme tokens for the mobile app.
- Applied a more consistent production-ready color system.
MAUI 10 production UI refresh
- Refreshed layout, spacing, pills, flyout styling, and card surfaces.
- Improved overall polish across the app.
Loopback default and LAN opt-in
- Changed default binding to loopback for safer local-first posture.
- Added explicit LAN opt-in setting and UI controls for broader exposure.
API auth lockdown and bearer-only upload auth
- Required authentication across key operational API endpoints.
- Enforced bearer-only auth model for direct upload endpoints.
CORS allowlist hardening
- Added explicit origin allowlist policy handling.
- Tightened cross-origin behavior to reduce accidental exposure.
Cert-only media/auth path hardening
- Enforced cert-based internal billing/media auth flows.
- Removed older fallback auth paths to reduce mixed-mode risk.
Windows installer/signing hardening
- Improved fresh-install behavior requiring proper code-signing flow.
- Hardened installer path for production-style Windows deployments.
Direct vs relay upload gating changes
- Adjusted direct-vs-relay upload gating logic.
- Reduced unnecessary blocking and counting behavior for WebUI server paths.
Auth storage hardening
- Tightened token storage and removed weaker fallback behavior.
- Improved account and session reliability on device.
Custom mover matching
- Added personal matching string support for mover behavior.
- Enabled more user-specific movie and TV routing decisions.
Subscription and quota enforcement
- Added subscription access and quota-aware upload checks.
- Aligned the app with production monetization behavior.
Push notifications added and refined
- Added iOS and Android push notification capabilities.
- Iterated on throttling, naming, and payload clarity to reduce spam and noise.
Push notifications added
- Added push notification support across the mobile app.
- Improved event awareness without requiring the app to stay open.
Windows connectivity/reconnect hardening
- Added reconnect logic to reduce stale stream issues on Windows.
- Improved diagnostics and stability for long-running Windows connectivity.
Cross-platform subscriptions
- Added Apple and Google purchase flow groundwork.
- Hardened entitlement sync and purchase recovery.
.NET 10 update cycle
- Updated project and runtime alignment around .NET 10.
- Included follow-up fixes for disconnect and regression behavior after upgrade.
Snapshot refresh and reconnect hardening
- Improved snapshot refresh responsiveness and error recovery.
- Hardened reconnect behavior when resuming the app.
Docker version/update behavior
- Made update UI resolve Docker version correctly.
- Adjusted update actions where Docker-managed updates should apply instead.
Local update and status notifications
- Added better app awareness around server status and update state.
- Improved visibility when the server needed attention.
Scheduled scans and controls
- Added scheduled scans for ongoing library and upcoming synchronization.
- Added disable toggle and randomized schedule offsets to avoid API spikes.
Processing queue DB persistence
- Persisted queued and deferred items to DB for crash and reboot continuity.
- Added jump-queue behavior to support reprioritization workflows.
Custom scripts and script history
- Added custom script runner and invocation capability for mobile and server workflows.
- Added script history, action tracking, scheduling, and push integration.
Custom scripts and queue integration
- Added support for mobile-driven script execution and queue visibility.
- Expanded advanced control workflows from the app.
Server build visibility in mobile
- Added server build details to the mobile app.
- Made it easier to compare app behavior against the connected server version.
Build/version visibility and artifact naming
- Added server version visibility in WebUI.
- Updated build outputs to include version in artifact naming conventions.
iOS app track introduced
- Started the iOS app track after the Android foundation was already established.
- Brought core Klypp workflows onto Apple devices.
DB maintenance actions
- Added maintenance actions and buttons for clearing operational DB tables.
- Expanded admin controls for queue and data cleanup from UI.
Queue and transfer visibility
- Improved visibility into uploads, queued work, and transfer states.
- Gave mobile better operational feedback from the server.
Pause/resume transfer handling
- Improved pause and resume state handling for transfer lifecycle.
- Fixed behavior around completed items during pause transitions.
TMDB manager removal and relay lookup cleanup
- Removed legacy TMDB manager implementation.
- Renamed and refined lookup logging for clearer relay-based media resolution diagnostics.
WinRAR/unar transfer tagging
- Added unrar-related tags and events so clients can display extraction state.
- Improved transfer visibility for archives that require extraction steps.
Queue status and out-of-space handling
- Added queue status tracking and surfaced deferred reasons.
- Improved behavior and reporting when destination storage is out of space.
Bulk upload support
- Added stronger handling for larger upload batches.
- Improved mobile upload behavior for heavier use.
Hardcoded config moved to configuration
- Moved operational values out of hardcoded code paths.
- Improved environment flexibility and reduced code edits for deploy changes.
Bulk/direct upload route work
- Added bulk upload route capability for higher-throughput ingest scenarios.
- Expanded server API surface for upload workflows used by clients.
Upload routing to avoid watcher conflicts
- Routed specific upload paths and subfolders to avoid NightsWatch interference.
- Prevented captures and uploads from being prematurely processed by scan workflows.
Kestrel/direct-upload stability
- Increased upload robustness for larger files and unstable connections.
- Fixed direct upload connection behavior that previously failed under certain conditions.
DB cleanup and table removal
- Removed unused database tables and related dead methods.
- Reduced schema and code complexity around stale storage paths.
Upload progress and background upload work
- Added upload progress groundwork and better background handling.
- Improved transfer continuity during longer uploads.
Docker build/publish improvements
- Cleaned up Docker build and publish pipeline warnings and behavior.
- Improved consistency for containerized deployment workflows.
Scanner matching and ignore hierarchy
- Improved TV episode matching logic including harder naming cases.
- Implemented and hardened show, season, and episode ignore hierarchy behavior.
Server settings/version UI
- Added server settings surface in WebUI.
- Exposed version information directly in UI for quicker diagnostics.
Windows LAN reachability update
- Switched to LAN-reachable binding behavior for Windows installs.
- Made local network access easier for remote and mobile clients.
Settings and cloud login updates
- Added a stronger settings and configuration flow on mobile.
- Improved how the app connected to the cloud and server setup.
Missing episodes/timezone correctness
- Corrected missing-episode ordering and date interpretation issues.
- Fixed UTC and local-date behavior that caused same-day airing confusion.
Snapshot visuals and browsing refresh
- Added richer visuals and layout improvements to mobile browsing.
- Improved the overall look and feel of the app.
Windows installer introduced
- Added Windows installer support for packaged distribution.
- Enabled packaged install flow rather than manual publish-only setup.
DB-on-launch and token usage fixes
- Added startup database creation and initialization flow.
- Corrected token usage from login so authenticated calls worked reliably.
Drives page added
- Added UI for managing drive and media path configuration.
- Made storage settings editable from the browser instead of file-only setup.
WebUI login working
- Implemented a functional login flow for WebUI access.
- Added initial auth gating so services and actions required authenticated access.
WebUI started
- Introduced the initial WebUI project and early page framework.
- Established the path for browser-based server administration.
NAS failover and .partial copy strategy
- Added deferred queue behavior when NAS or storage is unavailable.
- Introduced .partial handling to prevent incomplete media from being detected as complete.
Search and scrolling improvements
- Improved result paging and scrolling behavior.
- Made larger libraries easier to browse on mobile.
Search screen introduced
- Added the first version of mobile search.
- Expanded the app beyond its earliest snapshot-focused workflow.
Early mobile upload and login flow
- Improved the first mobile login and upload behavior.
- Reduced rough edges in early app-to-server communication.
Connection resilience basics
- Added keep-alive ping support to reduce stale relay and server sessions.
- Explicitly terminated unauthenticated and tokenless connections for safer behavior.
Relay cert retrieval and local reuse
- Server started consuming certificates provided by Relay after auth.
- Certificate reuse was added so reconnects could avoid unnecessary regeneration.
NightsWatch added/integrated
- Added NightsWatch projects into the solution and connected scanning components.
- Brought over enough watcher functionality to be usable while cleanup remained.
Mobile app foundation
- Started the first Klypp mobile app track.
- Established the base app structure and early connection flow.
Project initialized
- Bootstrapped the repository with core project structure and solution files.
- Took the original POC project and used it as the foundation for a new production-ready version.