LUC4N3X/Levyra-deepsound

Levyra

Open-source music player for Android and Windows.

Play streamed music and your own files in the same app, save tracks for offline listening, and follow synced lyrics. Levyra does not need an account and does not track you.

Download Levyra

More download options

Levyra speaks 41 languages  ·  100% Android translation coverage

100% Kotlin  ·  Jetpack Compose  ·  Compose Multiplatform  ·  AndroidX Media3  ·  libvlc  ·  Zero Tracking

I started Levyra because I wanted one player for the music I stream and the files I already have. I wanted local tracks to feel like part of the same library, with playlists, history and downloads that do not depend on a Levyra account.

On Android, you can also sign in to YouTube Music if you want your playlists, liked songs and saved albums in Levyra, along with a Home feed based on your account. It's completely optional. Levyra works as before without signing in, and anything you've imported stays in your library if you disconnect. Sign-in happens through Google's own pages, and Levyra stores the session encrypted on your device using Android Keystore, not your Google password.

Downloaded tracks are saved as normal audio files in your device storage. Local and streamed music can share the same library, playlists and queues, while listening data stays on the device.

As I kept using Levyra, I added the things I missed in other players: synced lyrics with timing controls, romanization, SponsorBlock, Queue Spaces, AutoEQ, Android Auto, music recognition, live radio, backups and a Windows version. They all use the same library and playback flow.

Some features rely on outside services for music, lyrics, artwork and metadata. Levyra itself stays open source, and your library remains under your control.

Want to dig deeper into how Levyra works? The full documentation covers setup, features, audio, providers, troubleshooting, architecture, and the details that do not fit here.

Open the full Levyra documentation →

When high-quality audio is enabled, Levyra can use JioSaavn as another source for the same track. The track in your library does not change.

Before switching sources, Levyra checks that it found the right recording and that the stream matches the quality it claims to have. It can try the available 320, 160 and 96 kbps versions. If a stream is advertised as 320 kbps but measures below that range, Levyra does not show it as 320 kbps.

The match uses more than the song title. Levyra also checks performers and artist roles, album and release details, duration, explicit status, language, featured artists and version markers. When needed, it compares a search result with JioSaavn's track details so it can tell an original recording from a compilation, reissue or alternate version.

When a match passes those checks, Levyra can play the audio directly from JioSaavn's CDN. If that source is temporarily unavailable, or Levyra cannot verify the recording safely, playback stays on the normal source. Successful matches can be remembered so Levyra does not have to start the lookup from scratch every time. Artwork, lyrics, queue position, listening history and recommendations still belong to the original Levyra track.

JioSaavn's 320 kbps streams already reach about 20 kHz, so little is missing from them and Levyra leaves them as they are. Enhanced Audio is meant for sources that lost more in encoding, such as a 128 kbps fallback where everything above 17 kHz was cut.

When Levyra detects a cut like that, it rebuilds the missing top end from the band just below it, similar to the SBR technique some codecs use. It only does this when the drop is steep and the band above it is empty, and it keeps the rebuilt highs a little quieter than the original recording would have had them. FLAC and other lossless files are never processed.

Enhanced Audio is on by default and can be turned off in Audio Settings. Technical Audio Info shows whether it is active on the current track or why it was skipped. A lossy stream stays lossy with Enhanced Audio on, and Levyra labels it that way.

• Native playback: Media3 and ExoPlayer on Android, libVLC through direct C bindings on Windows (no web wrappers).
• Gapless & audio tuning: uninterrupted album transitions, crossfade, pitch shifting, custom playback speed, 10-band EQ, and AutoEQ headphone profiles.
• SponsorBlock: automatically skips sponsored segments, intros, outros, and non-music chatter.
• Audio & video modes: one-tap switch between audio-only streaming and full video with subtitle tracks.
• Clean offline downloads: saved directly in device storage as standard M4A files with metadata, artwork, and lyrics.
• Unified library: local files and streamed tracks share the same playlists, favorites, and queues.
• Optional YouTube Music sign-in (Android): connect your account to browse your music and import playlists, liked songs and albums. No account needed if you'd rather keep using Levyra as it is.
• Queue Spaces: keep multiple active listening sessions side by side without losing your current queue.
• Synced lyrics: tap-to-seek, manual timing adjustments, dedicated Bluetooth latency offset, and non-Latin romanization.
• Visuals: motion artwork on the Now Playing screen, falling back to animated album covers.
• Theme Studio: sixteen presets, including Midnight, Aurora, Pure Material, Velvet and Editorial. You can also build your own themes: pick background, surface and accent colors from swatches or a HEX code, choose light or dark, set how round the corners are, then save, rename or duplicate them. Levyra Aura stays the default, and one tap brings it back.
• Mini player studio: five alternative mini player designs (Super Expressive, Floating, Liquid Glass, Ultra Compact and Artwork Focus), each with its own size, shape, progress bar and control options, plus a live preview. The original mini player stays the default, so nothing changes until you pick something else.
• Navigation studio: four extra styles for the bottom bar (Super Expressive, Floating Dock, Minimal and Expressive Compact). Drag the buttons into the order you like, hide Explore or Library, choose when labels show, and pick the indicator, icon size, height and background. Home and Search always stay in the bar.
• System integration: Android Auto, lockscreen media controls, persistent notifications, and Quick Settings tile.
• Device integration (Android): Levyra recognizes the phone it runs on and turns on what that system supports. On HyperOS 3 it shows synced lyrics in the Super Island, on OriginOS it shows the current track in the Atomic Island, and OPPO, OnePlus and realme keep their system lyrics panel. Samsung's Now Bar and other phones use the standard media controls. Settings → Integrations shows what was detected and links to the right battery page for background playback.
• Song recognition: on-device music identification through the microphone or internal audio, saved in local history.
• Explore: live radio stations, international charts, and genre or mood browsing.
• Levyra Vault: backup and restore playlists, favorites, history, and preferences in a single local file.
• Private stats: on-device play counts and listening hours, with optional Last.fm and ListenBrainz scrobbling.

For full technical notes, platform architecture, and build details, check the documentation.

I wanted Levyra to share as much logic as possible without forcing either platform into a web view or a sluggish cross-platform container. The architecture is split into a shared Kotlin core and two native runtimes.

The mobile client is pure native Kotlin. The interface is built with Jetpack Compose and Material 3, with database persistence on Room, preferences on DataStore, and local indexing through MediaStore. Audio runs directly on AndroidX Media3 and ExoPlayer, which connects audio focus, Bluetooth playback controls, lockscreen media sessions, Quick Settings, and Android Auto straight to Android system services. Release builds are optimized with R8, ProGuard, and Android Baseline Profiles.

The desktop version runs Compose Multiplatform on modern JVM 21, but leaves audio decoding to libVLC through direct native C bindings (vlcj). That routes playback straight into system audio without bundling Chromium, Electron, or WebView runtimes. Preferences and library data are kept in lightweight local JSON files, so the app starts cleanly and stays light on system memory.

Stream resolution, YouTube extraction, and network retry fallbacks live in a shared Kotlin engine (LevyraExtractor). The engine runs OkHttp with Brotli compression and DNS-over-HTTPS, so network fixes and format updates apply to both Android and Windows from the same codebase.

Many cross-platform music players are essentially web browsers wrapped in an executable. They take seconds to spin up and eat memory just to sit idle in your system tray. Skipping web runtimes keeps startup quick and memory low, so the app behaves like real software built for the machine it runs on.

Levyra is developed in public. Commits, pull requests, issues, and releases are all open, alongside the engineering rules I follow while maintaining the project. I use AI-assisted tools when they help with research, debugging, or review, but I treat generated code like any unverified draft: I review it, adapt it to the architecture, and test the affected parts before anything ships. Read more about how I work on Levyra.

There is no telemetry, analytics, or advertising, and you do not need an account to use the app. Your playback history, listening statistics, playlists, and cached metadata stay on your device. When an online feature needs an external service (for streaming, lyrics, or optional scrobbling), Levyra connects to that provider directly. Microphone access is requested only when you actively trigger song identification, and you can route traffic through a custom proxy or DNS in settings.

For independent verification, an Apptizo scan of the F-Droid build confirmed zero third-party tracker SDKs (view the Apptizo report), and the Levyra 2.5.10 APK returned 0/68 detections on VirusTotal.

Levyra is available in 41 languages.

Levyra builds on ideas and work from several open-source projects:

• Metrolist: used as a reference for renderer recovery and BetterLyrics TTML parsing.
• PipePipeExtractor: the starting architecture for LevyraExtractor, later adapted with Levyra's own stream resolution and retry handling.
• NewPipeExtractor: upstream extractor concepts and service foundations.
• zemer-cipher: open-source work used for YouTube cipher deobfuscation and PoToken generation.
• LRCLIB: provides the synchronized lyrics database and API.

Previous Levyra app logo designed by @gauravbhindwar in #525. The current logo and visual identity are by @LUC4N3X.

Contributions and bug reports are welcome. Technical documentation and architecture notes are in the project documentation.

LUC4N3X · Creator & Maintainer

_{I build and maintain Levyra for Android and Windows, review incoming changes, and shape each release.}

GitHub  ·  Website

_{Featured: Kotlin Weekly  ·  Techno360  ·  Australia By Aussie  ·  OSCHINA 开源中国  ·  CSDN  ·  SecurityLab.ru  ·  GeekParadize  ·  OpenSalerno  ·  Techolay  ·  Hysen Labs  ·  PitchHut}

Levyra is client-side software that runs on your device. It does not own or host music catalogs, artwork, lyrics, or video files. When you stream or search, Levyra connects to the external services needed for that feature. Those services can change, rate-limit, or restrict access at any time.

If there is a problem with media hosted by another service, contact that service or the relevant rights holder. If the issue is with something distributed as part of Levyra itself, use the GitHub issue tracker.

Levyra is built for lawful use, research, and interoperability, not for piracy or copyright infringement. Streaming, downloading, format conversion, and offline caching are software features. They do not transfer copyright or ownership of third-party media.

Levyra may cache media temporarily for playback and can save user-requested downloads as standard media files. Neither feature gives you permission to redistribute third-party content. You are responsible for making sure your use of Levyra complies with applicable law and with the terms of any third-party service you choose to access.

Some streaming features depend on third-party services such as YouTube Music. Those services may be unavailable, filtered, or unreliable in some countries, networks, or accounts.

Some Levyra builds include optional experimental network compatibility tools that can change how YouTube requests are resolved, routed, or sent when the normal connection does not work. These are best-effort features. They can fail, slow playback, or stop working after a network or provider change, and Levyra does not guarantee that they will restore access.

Enabling a compatibility option does not grant access rights, unlock paid features, or make an otherwise restricted use authorized. You are responsible for following applicable law and the terms, account rules, and network policies that apply to the services you use.

Local playback and features that do not depend on the affected service continue to work independently.

Levyra does not unlock paid subscriptions or grant access rights offered by third-party providers. If you want an official subscription experience, subscribe directly through the provider, including YouTube Premium, YouTube Music Premium, or Spotify Premium.

You can also support artists directly through licensed streaming services, music purchases, concerts, merchandise, and other official channels.

Levyra does not require a Levyra account and does not include telemetry, analytics, or ads. Network requests go directly to the services used by the features you enable, including optional integrations.

Levyra includes client-side code for compatibility with external services. Depending on the feature, it may resolve streams, process requests and tokens, use alternate DNS or routing, or apply optional experimental connection methods.

Those capabilities do not grant permission to access a service, region, catalog item, account feature, subscription tier, or paid entitlement that you are not otherwise allowed to use. Availability and authorization remain governed by the service, your account, the network you are using, applicable terms, and applicable law. Network compatibility options are provided on a best-effort basis and may stop working at any time.

Levyra is released under the GNU GPL v3.0 and is provided "as is", without warranty of any kind, to the fullest extent permitted by applicable law.

The GNU GPL v3.0 covers Levyra's source code. It does not grant rights to third-party content, trademarks, or service endpoints. Third-party services can change or disappear, so Levyra cannot guarantee that every stream, metadata source, artwork provider, lyrics source, or API will keep working.