Levyra-deepsound A modern open-source music pl @codeKK AndroidOpen Source Website

Levyra-deepsound

Introduction: A modern open-source music player for Android & Windows, focused on immersive playback, smart discovery, synced lyrics and rich artwork 🎶

More: Author ReportBugs OfficialWebsite

Tags:

A native music player, stream extractor, and private offline vault for Android & Windows.

✦ Download

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

✦ The Pure Listening Philosophy

🎧 Music should feel like yours.

Not rented. Not profiled. Not trapped.

Levyra is built around a simple promise: the music you save, the way you listen, and the history you create should remain useful beyond a session — and beyond Levyra itself.

💿 01 · Keep the music

Downloads are standard, high-bitrate M4A files saved directly to Music/Levyra, with artwork, artist, album, and lyrics embedded inside the file.

No proprietary vault required. Your music remains usable in the car, on a DAP, through a hi-fi system, or in any compatible media player.

🎚️ 02 · Stay close to the sound

Android uses Media3 / ExoPlayer; Windows uses its own libvlc core. Playback stays native to the platform instead of living inside a web wrapper.

GAPLESS PLAYBACK · VOLUME NORMALIZATION · LOW-OVERHEAD AUDIO

🎙️ 03 · Remove everything between you and the song

Synced LRCLIB lyrics keep the words tied to the music with tap-to-seek karaoke, while SponsorBlock can skip supported intros, silence, dialogue, and other non-musical segments automatically.

The goal is simple: less interface friction, more music.

🛡️ 04 · Keep your listening private

Play counts, listening time, streaks, playlists, and listening insights are computed locally in SQLite.

No analytics profile. No cookies. No mandatory Levyra account.

Keep the file. Keep the history. Keep control.

_{Offline playback is not a fallback in Levyra. It is ownership.}

✦ New in 2.5.7 · Verified High-Quality Audio

🎧 Higher fidelity, without gambling on the wrong song.

_{Levyra can now verify an alternative high-quality audio source before playback, while keeping the original track identity, metadata, queue state, artwork, lyrics, history, and recommendations untouched.}

🎚️ Verified HQ Routing

_{Levyra can resolve a genuine higher-bitrate stream — up to 320 kbps when available and validated — with automatic 160/96 kbps fallback when the requested tier is not actually usable.}

🧬 Identity-First Matching

_{Title, primary and featured artists, album, duration, explicit state, ISRC and version markers are checked before an alternative source is accepted. Remix, live, acoustic, sped-up and ambiguous matches are rejected.}

🛡️ Seamless Fallback

_{If the verified source is unavailable, stale, restricted or not meaningfully better, Levyra keeps the normal playback path. No track identity swap. No forced match. No broken queue.}

OFF · AUTOMATIC · PREFER 320 KBPS

_{High-quality alternative audio uses JioSaavn as an external third-party provider when enabled. Levyra is not affiliated with or endorsed by JioSaavn.}

✦ Interface & Experience Showcase



Immersive Playback & Live Synced Lyrics _{ExoPlayer audio engine · Line-by-line LRCLIB synced lyrics · Song/Video toggle · SponsorBlock}	Smart Orbit Feed & Global Charts _{Dynamic 'Your Orbit' rotation · Live Top 50 international charts · Mood chips · Instant prefetch}

Deep Search & Artist Immersion _{Live search with artist bubbles · Wikipedia biography cards · Complete chronological discography}	Offline M4A Vault & Listening Pulse _{Real tagged M4A files with art · On-device 7-day listening analytics · 100% private SQLite}

Samples Clips & Comment Energy _{Vertical video teaser clips · Live music video feeds · Real-time 73% comment energy resonance}	Editorial Playlists & Genre Matrix _{4-tile dynamic editorial collections · Expansive mood spectrum (Rap, Lo-Fi, Anime, Electronic)}

✦ Browse Complete Screen-by-Screen Gallery (15 High-Res Views)

🎵 Immersive Playback & Lyrics

Now Playing Canvas	Synchronized Lyrics

🪐 Home & Discovery

Home Selection & Orbit	Global Top 50 Charts	Editorial Collections

🔍 Search & Artist Universe

Search Discovery & Recent	Live Artist Results	Artist Profile & Bio	Artist Discography

📊 Offline Vault & Listening Pulse

Library Quick Picks	Listening Pulse Analytics	Playlist Details

🎬 Explore & Video Engine

Vertical Samples Clips	Moods & Subgenre Matrix	Video Feed & Energy

✦ Acoustic Architecture & Features

🎧 Everything in the signal path. Nothing in the way.

_{Playback, discovery, lyrics, offline ownership, recognition, local sync, privacy, and resilient networking — engineered as one native audio system.}

12 CORE SYSTEMS · ANDROID + WINDOWS · LOCAL-FIRST · ZERO TRACKING

🎚️ Playback Core

Fast, native, interruption-free.
_{The listening path is tuned around low overhead, predictable behavior, and direct playback control on both platforms.}

Native Engines: Media3 / ExoPlayer on Android and isolated libvlc on Windows.
Verified HQ Audio: Android can route to a validated alternative source up to 320 kbps while preserving the original Levyra/YouTube track identity and falling back safely when verification fails.
Gapless & Queue: Seamless track transitions, shuffle/repeat, and queue Undo.
Tempo & Timing: Speed/pitch controls plus a built-in sleep timer.
Android Auto: Playback integrates with the car-focused Android media experience.
Volume Normalization: Keeps perceived loudness more consistent between tracks.
SponsorBlock: Automatically skips supported non-musical segments during playback.
Audio / Video Mode: Switch between listening and native-video playback when available.

💾 Offline Vault

Your library stays yours.
_{Portable audio files and versioned local backups without a Levyra account.}

Tagged M4A Files: Cover art, artist, album, and lyrics embedded directly in the file.
Local-First Playback: Existing offline files play instantly from Music/Levyra.
Levyra Vault: Versioned .levyra backups protect settings, favorites, playlists, followed artists, history, and queue without an online account.
Verified Restore: Manifest validation, SHA-256 checksums, compatibility preview, required-section checks, and rollback protection before local data is replaced.
Automatic Protection: Manual, scheduled, and pre-update backups with 3/5/10 retention and optional Android SAF destinations; internal storage remains the safe fallback.

🔍 Discovery & Extraction

Find it, resolve it, start it.
_{Discovery and stream resolution are designed as one continuous path into playback.}

Multi-Source Resolver: Highest-fidelity Opus or AAC on the normal path, plus verified JioSaavn alternative audio when enabled and demonstrably matched to the same recording.
Strict Match Guard: Artist credits, album, duration, explicit state, ISRC and recording/version markers prevent remixes, live cuts, covers and ambiguous candidates from replacing the requested track.
Queue Prefetch: Upcoming tracks buffer quietly before the skip.
Discovery Engine: Global Top 50, Smart Orbit recommendations, and Samples feed.

🎙️ Lyrics & Visual Immersion

Lyrics that move with the music.
_{Synced text, shareable moments, artwork motion, and Canvas live inside the player.}

Synced Lyrics: Millisecond-aligned LRCLIB lyrics with tap-to-seek highlighting.
Lyric Sharing: Select verses, copy, share, or export a 1080×1080 Levyra card.
Living Artwork: Artwork-driven motion fallback when a real Canvas is unavailable.
Canvas & Preview: In-player Canvas control plus full-screen zoomable artwork preview.

📈 Listening Intelligence

Useful insight, computed locally.
_{Your listening patterns become readable without turning into telemetry.}

Accurate Listening: Playback time and counted plays respect pause, seek, skip, and completion.
Listening Pulse: Weekly activity, 24-hour rhythm, and artist distribution.
Your Sound: 7-day, 30-day, 6-month, and All Time analysis stored on device.

🔤 Typography & Readability

Dense when useful. Clear everywhere.
_{Type rhythm and layout rules keep metadata readable across languages and font scales.}

Levyra Type Rhythm: Shared line-height scale for titles, metadata, and multi-line text.
Accessible Layout: Role-aware tracking with safe accents, descenders, and large font scales.
Private by Default: Listening statistics are computed locally and never leave the device.

🎛️ Music Recognition 2.0

Identify what is playing without an account.
_{Recognition works from the microphone or supported internal playback capture.}

Shazam-Compatible: Credential-free acoustic fingerprint matching directly on device.
Dual Audio Capture: Listens via microphone or internal device playback (Android 10+ MediaProjection).
AudD Fallback & History: Optional secondary provider with Keystore token, plus local recognition history.

📻 Levyra Jam

Shared listening, kept on the local network.
_{Sync playback and queues across nearby devices without turning the session into a cloud service.}

Local Network Listening: Synchronized playback and shared queues across devices on the same Wi-Fi.
Host Authority & Permissions: Granular controls for host-only, guest queue additions, or collaborative sessions.
Mutual Auth Security: Cryptographic challenge-response handshake over HMAC-SHA256 with deep link invites.

🛡️ Network Resilience

Flexible routing without hidden behavior.
_{DNS, proxy controls, bypasses, and diagnostics stay visible and user-controlled.}

DNS-over-HTTPS: Built-in presets for Cloudflare, Google, AdGuard, and Quad9, plus custom HTTPS resolvers.
HTTP & SOCKS Proxies: Authenticated proxy routing with Keystore-encrypted credentials and anti-loop safety.
Stream Bypass & Diagnostics: Option to bypass proxies for direct audio streams, and an in-app network probe.

🔗 Integrations & Control

Useful connections, never mandatory ones.
_{External services remain optional while core playback stays independent.}

Scrobbling: Last.fm and ListenBrainz integration with bounded deduplication.
Searchable Settings: Instant search across settings, titles, and keywords in 26 languages.
Video Subtitles: Selectable multi-language subtitles during native-video playback.

🌙 Levyra Ambient

A quiet screen for a loud song.
_{An OLED-friendly now-playing surface driven by the existing PlaybackService session — never a second player.}

Same Session: Attaches to the running MediaSession, so entering and leaving Ambient never interrupts audio.
Artwork or Canvas: Shows Levyra Canvas when available, with static artwork as the immediate fallback.
Synced Lyric Line: The current line follows playback, alongside title, artist, and a minimal progress cue.
Burn-in Care: Reduced brightness, auto dimming, periodic pixel shifting, and a minimal layout once idle.
Proximity Blackout: Optional blackout while the sensor is covered, for pocket and nightstand use.
Tile & Screensaver: A Quick Settings tile plus a native Android DreamService for docked playback.

🗂️ Library Organization

Shape the library around how you actually listen.
_{Tags, visibility, and recommendation control — all local, all reversible, all included in Levyra Vault backups.}

Playlist Tags: Create, rename, and remove tags such as Rap, Gym, Relax, or Auto, and assign several to one playlist.
Tag Filtering: Filter the Library by one or more tags without leaving the playlist view.
Hidden Playlists: Hide a playlist from the Library without deleting it, then restore it from a dedicated filter. No track or metadata is lost.
Artist Exclusions: Keep an artist out of the personalized Home, Your Orbit, radio, autoplay, and mixes while still being able to search and open them.
Rediscover: A Home shelf for favorites you have not played in a long time, built only from listening history already on the device.

_{One listening stack — built to stay fast, portable, private, and recoverable online or offline.}

✦ Architecture & Engineering Blueprint

⚙️ Two native runtimes. One engineering language.

_{Android and Windows stay independent where platform behavior matters, while sharing the same discipline for state, playback resilience, and local ownership.}

Layer	📱 Android	💻 Windows
Interface _Surface	`ui/` _{Jetpack Compose screens, gestures, Canvas, and visual presentation.}	`app/` _{Compose Multiplatform UI, windows, application lifecycle, and updater.}
State _{Orchestration}	`viewmodel/` _{Immutable UI state and unidirectional coordination.}	`app/` _{Application lifecycle and desktop UI coordination.}
Playback _{Runtime core}	`player/` _{Media3 / ExoPlayer foreground service, MediaSession, and playback ownership.}	`player/` _{libvlc playback, hardware acceleration, tray controls, and global hotkeys.}
Data _Resolution	`data/` _{Stream resolution, lyrics, prefetch, and persistent local data.}	`core/` _{Stream resolution, downloads, and local application storage.}
Output _{Portable layer}	`player/offline/` _{Offline exports, M4A tagging, artwork, and portable files.}	`packaging/` _{WiX MSI packaging and portable desktop distributions.}
🧠 State ownership · ⚡ Resolver resilience · 💿 Portable data _{Predictable state, resilient playback paths, and data that stays useful beyond the app.}

_{Different runtimes where it matters. The same engineering discipline underneath.}

✦ Building from Source

📱 Android Build

Prerequisites: JDK 17, Android SDK Platform 37, Gradle 9.7.0.

# Clone the repository
git clone https://github.com/LUC4N3X/Levyra-deepsound.git
cd Levyra-deepsound

# Build and install debug APK to a connected device
./gradlew installDebug

# Compile optimized release APK
./gradlew clean assembleRelease

_{Output: app/build/outputs/apk/release/app-release.apk}

💻 Windows Desktop Build

Prerequisites: JDK 21 LTS, Windows x64, VLC 3.0.x / libvlc, and WiX Toolset 3.14.

cd desktop
.\gradlew.bat check
.\gradlew.bat createReleaseDistributable
.\gradlew.bat packageReleaseMsi packageReleaseExe

_{Output: desktop/app/build/compose/binaries/main-release/}

✦ F-Droid Reproducible Build & Versioning Contract

F-Droid Reproducible Verification:

./gradlew --no-daemon -PlevyraFdroidBuild=true :app:assembleRelease

Version Wiring Contract:

# Android: gradle.properties
levyraVersionName=2.5.7
levyraVersionCode=2050700

# Windows: desktop/version.properties
levyraDesktopVersion=1.2.0

_{Version code formula: major * 1_000_000 + minor * 10_000 + patch * 100 + build.}

✦ Privacy Blueprint & Permissions

🛡️ Private by default. Transparent by design.

NO ADS · NO ANALYTICS · LOCAL LISTENING DATA · DIRECT CONNECTIONS

🌐 Network Transparency

Only what playback needs.
_{Connections go directly to the services Levyra uses—never through a Levyra tracking proxy.}

🎵 Streams: Direct YouTube / YT Music CDN connections.
📝 Lyrics: LRCLIB and YouTube Music metadata queries.
🖼️ Artwork: Public Deezer, Apple Music, and Tidal catalog lookups.
✂️ SponsorBlock: Optional truncated video-ID hash requests.
🚀 Updates: GitHub release checks; disabled in F-Droid builds.

🔐 Permission Surface

Access stays narrow.
_{Android permissions are limited to playback, notifications, optional recognition, and offline export.}

INTERNET / ACCESS_NETWORK_STATE
_{Streaming and metadata.}
FOREGROUND_SERVICE_MEDIA_PLAYBACK
_{Background playback and media controls.}
POST_NOTIFICATIONS
_{Lockscreen controls and download updates.}
RECORD_AUDIO
_{Optional music recognition only.}
WAKE_LOCK
_{Keeps playback active with the screen off.}
WRITE_EXTERNAL_STORAGE _{Android ≤ 9}
_{Tagged M4A export to Music/Levyra.}

✦ Contributing

We welcome community contributions, bug fixes, localization, and performance enhancements.

For build and contributor docs, see the Levyra Documentation.

Engineering Workflow

Fork & Branch: Create a focused topic branch from main:
```
git checkout -b feature/your-feature-name
```
Architecture Contract: Preserve unidirectional data flow (UDF), immutable Compose state, and low-latency audio pipelines.
Quality Gate: Run repository validation before submitting:
```
python scripts/ai_quality_gate.py --profile fast
```
Pull Request: Open a PR with a concise description of changes and test verification evidence.

[!TIP] Scope & Guidelines: Keep pull requests focused on a single concern. For major architectural changes or new feature proposals, please open an Issue first to coordinate the implementation approach.

✦ Author & Credits

LUC4N3X · `Lead Systems Architect & Creator`

Creator and lead systems architect of Levyra. Engineering low-latency Android audio pipelines (Media3 & ExoPlayer), standalone libvlc desktop cores, zero-telemetry SQLite vaults, and synchronized LRCLIB karaoke engines.

_{Branding credit · Special thanks to @gauravbhindwar for designing and contributing Levyra's new app logo through #525.}

Built With & Inspired By

Metrolist — Reference for Levyra's renderer-recovery backoff policy and BetterLyrics TTML parsing behavior, reimplemented for Levyra.
PipePipeExtractor — LevyraExtractor is maintained as a Levyra-specific fork of this project, with additional stream-resolution, playback-reliability, diagnostics, and fallback work.
NewPipe & PipePipe Communities — Foundational extractor architecture, service implementations, parser protocols, and downstream ecosystem work retained in LevyraExtractor.
LRCLIB — Community synchronized lyric database and open API powering real-time karaoke synchronization.

✦ Legal Notice & License

[!IMPORTANT] Independent open-source software — lawful use only. Levyra is client-side software and does not operate a centralized media-hosting or content-distribution service. Users are responsible for ensuring that their use of third-party services and content is lawful and authorized.

Levyra is provided "AS IS" under the GNU GPL v3.0, to the maximum extent permitted by applicable law. Third-party trademarks, services, APIs, media, metadata, and copyrighted works remain subject to their respective owners, licences, terms, and applicable law.

Read the complete Legal Notice for no-affiliation terms, third-party rights, user responsibility, warranty and liability limitations, rights-holder notices, and mandatory-law provisions.

_{Crafted for sovereign sound. If you enjoy Levyra, consider starring the repository on GitHub. ⭐}

Levyra Acoustic Waves