Levyra 2.5.6

Why 2.5.6 replaces 2.5.5

Levyra 2.5.6 replaces the short-lived 2.5.5 release.

After 2.5.5 shipped, a Home regression was identified in Quick Picks / Scelte rapide. Background seed enrichment and filtering could rebuild the shelf at the wrong moment, while the paging logic could discard a partial second page by rounding 11–19 available tracks down to only 10.

The larger page grouping also caused Compose to materialize more cards than were actually visible, making Home scrolling slightly less fluid than intended.

Levyra 2.5.6 fixes the regression without changing recommendation scoring or the visual language of Home.

Quick Picks now:

• preserves partial pages instead of discarding them;
• keeps the intended two-column ordering and right-edge preview;
• applies artist exclusions immediately;
• renders the dense shelf using smaller lazy 5-row columns;
• performs less unnecessary UI work while scrolling.

A final follow-up also fixes partial seed enrichment and Personal Orbit overlap.

Enriched tracks are now combined with the startup fallback pool, deduplicated and backfilled so Quick Picks consistently reaches 20 distinct tracks instead of stopping at partial results such as 7, 9, 13 or 18 items.

Tracks already present in Personal Orbit remain avoided whenever alternatives are available. They may only be reused as a final fallback when required to keep all 20 Quick Picks slots populated.

The 2.5.5 GitHub release has been withdrawn in favor of 2.5.6.

Users running 2.5.5 should update directly to 2.5.6.

---

Highlights

Levyra 2.5.6 brings together the latest Android work across the parts of the app used most often: Home, playback, lyrics, downloads, library management and playback automation.

Home is faster and more personal, cached playback can reopen with less work, lyrics and motion artwork gain richer rendering paths, and the library gains stronger import and organization tools.

The update also strengthens the infrastructure underneath those features. Preference reads no longer depend on synchronous DataStore access in normal runtime hot paths, YouTube stream recovery gains broader semantic fallback coverage, and offline content is handled more deliberately across Home, exports and backups.

---

✦ A cleaner, faster Home

Home has been refined around a stronger visual hierarchy and lower runtime overhead.

The editorial hero now blends naturally into the surrounding background instead of behaving like a detached card while scrolling.

Personal Orbit uses a cleaner lead-and-satellite composition without decorative ranking numbers, keeping the focus on artists and tracks rather than artificial ordering.

Quick Picks can populate from the first launch without requiring a large listening history. Official artwork enrichment continues asynchronously in the background without blocking the initial shelf.

Artist exclusions now invalidate the Home projection immediately. Selecting Do not recommend this artist removes that artist from Quick Picks without requiring a manual refresh.

Levyra Collections continues targeting six distinct smart cards.

When Android reports that the device is offline, Home can switch to useful local content immediately instead of waiting for failed remote requests. Previously cached remote content is also preserved instead of being replaced by an empty loading state.

---

✦ Faster preferences and playback recovery

The Android preferences layer no longer relies on synchronous DataStore access in normal runtime hot paths.

Regular synchronous reads are now served from an in-memory snapshot while DataStore remains the persistent source of truth.

Writes are persisted in order in the background, initial loading includes bounded recovery for transient I/O failures, and optimistic state is rolled back when persistence fails so the UI does not falsely report a setting as saved.

Playback recovery has also been strengthened.

Levyra can reuse a verified and complete Media3 cache after relaunch when both the recording identity and selected audio quality still match.

The fallback path rejects mismatched recordings, preserves persistent source identity and keeps normal song playback isolated from muxed video sources.

YouTube stream resolution now includes broader semantic player.js analysis with bounded discovery while preserving legacy fallback behavior.

Navigation headers, decoder provenance, visitor identity and failure generations remain scoped correctly so recovery work cannot leak across unrelated playback attempts.

Fresh installations now open the player in Canvas Immersive by default.

Existing installations continue respecting the visual mode already stored by the user.

---

✦ Lyrics 2.0

Lyrics 2.0 improves synchronized playback with a more precise rendering pipeline.

It introduces:

• an interpolated playback clock;
• word-level karaoke progress;
• instrumental-gap handling;
• active-line typography adaptation;
• bounded rendering work to avoid unnecessary UI overhead.

The richer presentation remains attached to the existing playback path rather than introducing a separate lyrics-specific playback system.

---

✦ Downloads Pro

Downloads gain more control and stronger export reliability.

Offline content can now be sorted persistently in both directions by:

• recent activity;
• title;
• artist;
• album;
• duration.

Large offline exports are also more resilient when metadata writing reaches the final stage, reducing cases where an export appears to stall near completion.

---

✦ Motion Artwork Resolver 2.0

Motion Artwork Resolver 2.0 improves both discovery and upgrade behavior.

Candidates can now be resolved progressively while provider priority is arbitrated more carefully.

Successful results are cached immediately, upgrades can be published later, and stale background work is prevented from replacing a better result that has already been found.

Video mode continues suppressing decorative motion artwork when appropriate so native video playback remains visually authoritative.

---

✦ Spotify and CSV playlist import

Levyra can now import Spotify and Exportify-style CSV files through the existing playlist import pipeline.

Entries are parsed tolerantly and matched through Levyra's catalog search.

Rows that cannot be matched safely are reported as unmatched instead of being force-matched to the wrong recording.

The importer prioritizes correctness over artificially high match rates.

---

✦ Sleep Timer 2.0

Sleep Timer has been expanded with both fade-out and scheduling support.

Users can optionally apply an end-of-timer volume fade and configure a bedtime schedule.

Cancelling, replacing or completing a fading timer restores the captured volume baseline correctly.

Scheduled timers also follow local time and timezone changes instead of assuming a fixed clock reference.

---

✦ Playback automations

Levyra now includes additional opt-in playback automations for common listening scenarios.

Available automations include:

• resume playback when an eligible Bluetooth route reconnects;
• pause playback when the Android media stream is muted;
• automatically download a track when it is liked;
• skip a track after the existing recovery stack classifies its failure as unrecoverable.

Automatic skipping remains bounded by queue state and consecutive-failure guards so one broken item cannot trigger uncontrolled queue advancement.

---

✦ Offline and backup reliability

Levyra Vault can now restore offline-track records from backups and reconcile them with media still present on the device.

Restored media deletion follows Android's consent model where required.

Missing or stale offline records are cleaned up instead of silently remaining as permanently broken entries.

The Room database moves from schema 19 to 20 with a new additive recommendation-feedback table.

Existing user data remains preserved through the registered migration.

---

Validation

The 2.5.6 release content was prepared from Android changes merged into main after the 2.5.3 release.

The repository contains focused automated coverage for:

• Home render stability;
• Quick Picks population and filtering;
• artist exclusions;
• preference-store initialization and recovery;
• playback cache identity;
• audio-quality cache isolation;
• semantic player analysis;
• YouTube stream recovery;
• Lyrics 2.0 timing and rendering helpers;
• motion-artwork upgrade behavior;
• library sorting;
• Spotify CSV parsing;
• sleep-timer scheduling;
• backup and offline reconciliation;
• Room migration 19 → 20.

This metadata update does not claim a new physical-device, Android Auto, long-session, notification, Bluetooth, bedtime-alarm or final signed-APK validation run before publication.

The signed release artifact is built and verified through the repository's existing Publish Release APK workflow after the version commit reaches main.

---

Versioning

• Version name: 2.5.6
• Version code: 2050600

gradle.properties, the Android Gradle fallback, README version wiring, architecture metadata, release notes, release badge and Fastlane changelogs are aligned to 2.5.6.

Levyra Desktop remains independently versioned and is not changed by this Android release.

Version 2.5.4 was not published as a GitHub release.

Version 2.5.5 was withdrawn after the Quick Picks and Home-scroll regression was identified.

Levyra 2.5.6 is the current published Android release after 2.5.3.

---

Upgrade notes

No manual migration is required.

Existing installations move from Room schema 19 to 20 through the registered additive migration, preserving existing library, playback and application data while adding recommendation-feedback storage.

Install the update normally over an existing Levyra installation from the same compatible signing channel.

---

Final note

Levyra 2.5.6 makes the app feel more immediate without trading away the local-first architecture underneath it.

Home reacts faster, playback recovery is stronger, preference access is lighter, offline data is handled more carefully, and the new library and automation features continue using the same playback and data owners already present across the app.