Levyra-deepsound

What Levyra does

Levyra is a native music player, stream extractor, and private offline vault for Android and Windows. The project treats music as art to be experienced with acoustic precision and true digital ownership rather than as disposable bandwidth behind subscriptions and telemetry. Downloads are standard high-bitrate M4A audio files saved directly into device storage under a Music folder, with album artwork, artists, and lyrics embedded into the file container so the music plays in a car, a digital audio player, a hi-fi system, or any media player. The Android audio pipeline uses AndroidX Media3 and ExoPlayer in a foreground service for instant buffering, gapless playback, and volume normalization. Windows runs a standalone libvlc engine with global keyboard shortcuts and system tray controls. Live karaoke synced lyrics come from LRCLIB with line-by-line highlighting and tap-to-seek scrubbing. A native SponsorBlock integration detects and skips music video intros, non-musical banter, skit dialogue, and silence. Listening time, daily streaks, play counts, and playlists are calculated locally in a private SQLite database, with zero analytics, zero cookies, and zero user profiling. The app is built entirely in Kotlin with Jetpack Compose and Compose Multiplatform, which lets one codebase span phone and desktop. The embedded artwork and lyrics mean a downloaded track stays useful outside the app, which is the practical point of true ownership that the project argues for.

Discovery and playback features

Levyra combines playback with discovery. The Android side uses a dual stream resolver that queries InnerTube and a dedicated LevyraExtractor with automatic fallback, picking the highest-fidelity Opus or AAC stream while prefetching upcoming queue tracks. Global charts show country-specific Top 50 and global discovery, and a Smart Orbit feed rotates recommendations with listening context. A samples feed offers short-form music clips with live comment-energy signals. The playback engine supports gapless playback, shuffle and repeat, speed and pitch control, and sleep timers, plus Android Auto with library browsing, steering-wheel controls, and voice playback. The offline vault saves tagged M4A files with resilient downloads using HTTP range resume and atomic verification, and it offers portable JSON export and import for playlists, favorites, and history. On the visual side, ambient backdrops react to the album palette, with a waveform and looping motion art. Listening Pulse shows private on-device minutes, artists, completion rates, and peak hours, and rankings use actual listening time instead of accidental starts. The engineering keeps a unidirectional state flow from the ViewModel to the Compose UI, MediaSession, and Android Auto, which avoids the inconsistency bugs that mixed update paths cause in media apps. The Smart Orbit feed and charts keep discovery inside the app while the listening data stays on device, which protects privacy without removing the recommendation features.

Architecture and builds

Levyra is structured as a modular audio suite for Android and Windows. The Android app directory holds Compose and Material 3 screens, immutable UI state in the viewmodel layer, the Media3 and ExoPlayer foreground audio service in the player layer, WorkManager exports and M4A tagging in the offline player layer, and stream resolving with synchronized lyrics and local Room data in the data layer. The Windows desktop directory holds a Compose Multiplatform UI with an updater, a libvlc player with hardware acceleration and global hotkeys, a core for stream resolving and downloads, and WiX packaging for an MSI installer and portable distributions. Building Android needs JDK 17, Android SDK platform 37, and Gradle 9.7.0, with `./gradlew installDebug` to install and `./gradlew clean assembleRelease` for a release APK. Building Windows needs JDK 21, Windows x64, VLC 3.0.x or libvlc, and the WiX Toolset 3.14. The project supports an F-Droid reproducible build flag and a version wiring contract where the version code follows a major times one million plus minor times ten thousand plus patch times one hundred plus build formula. A quality gate script runs before contributions, so submitted code meets the project's checks. The Compose Multiplatform choice lets one UI codebase target phone and desktop, reducing the cost of supporting two platforms with a single team and one design language.

Privacy and licensing

Levyra is built on zero-tracking principles: no advertising identifiers, no user profiling, and no background telemetry. Network use is transparent. Streams connect directly to YouTube and YT Music content delivery networks without proxy tracking. Lyrics come from LRCLIB and YouTube Music queries using song metadata. Artwork and metadata come from public catalog lookups across Deezer, Apple Music, and Tidal. SponsorBlock uses optional queries with truncated video identifier hash prefixes. Update checks hit GitHub releases at startup and are disabled in F-Droid builds. Android permissions are limited to internet and network state for streaming and metadata, a foreground service for media playback, post notifications for lockscreen controls, a wake lock to keep playback active with the screen off, and write external storage on older Android for the M4A export. The project is an independent open-source client with no affiliation with Google, YouTube, Apple, Deezer, Spotify, or Tidal, and it hosts no copyrighted media, operating as a local user-agent that queries public endpoints. It is released under the GNU General Public License v3.0 without warranty, and it is distributed on GitHub releases, F-Droid, and Obtainium, which gives users several install paths. The F-Droid and Obtainium paths give users installs that do not depend on a single app store, which fits the zero-tracking stance the project takes throughout its docs.

Editorial conclusion

Levyra is written in Kotlin, distributed under the GPL-3.0 license, and its repository was last updated on 2026-08-24.