音理音理!

NeriPlayer is a native Android audio player built with Jetpack Compose + Media3. The current implementation focuses not on building public cloud services, but on integrating online content from NetEase Cloud Music, Bilibili, and YouTube Music—assuming the user already has accounts on these third-party platforms—and providing capabilities such as streaming cache, in-app downloads, local import, local playlist management, and optional GitHub private repository sync.

- Account as Capability: Through the user's legitimate authorization on third-party platforms, features such as online playback, search, and playlist access are enabled. - Local Storage by Default: Playback cache, downloaded files, playlists, history, settings, and authorization information are stored locally on the device by default. - Optional Private Repository Sync: Metadata such as playlists, favorites, and history can be synced to the user's own GitHub private repository. - Single Activity + Compose Architecture: MainActivity serves as the sole entry point, with the interface organized via Compose NavHost, Mini Player, and Now Playing overlay. - Disclaimer Screen on First Launch: The app startup flow is Loading → Disclaimer → Main; first-time users must read and accept the disclaimer before proceeding.

Core Features / Key Features

- 🎧 Multi-Source Discovery & Playback: The Explore page currently supports browsing curated playlists from NetEase Cloud Music and YouTube Music, and provides search entry points for NetEase Cloud / Bilibili / YouTube Music. - 🔍 Layered Search Capabilities: Page search and playback metadata enrichment are two separate pipelines. Explore uses NetEase Cloud / Bilibili / YouTube Music; SearchManager uses NetEase Cloud / QQ Music to fetch cover art, lyrics, and track information. - 🧠 Custom Playback Management Based on Media3: PlayerManager handles audio source resolution, playback queue, shuffle/repeat modes, state persistence, failure retry, and recovery. - 💾 Configurable Streaming Cache: The player uses SimpleCache + LRU for audio caching, with a default limit of 1 GB. Cache can be manually cleared in settings. - ⬇️ In-App Downloads & Local Playback: Supports downloading online audio sources to the app's dedicated directory, saving lyrics and cover art simultaneously, and managing download progress and saved songs within the app. - 📁 Local Audio Import & Scanning: Supports system VIEW / SEND / SEND_MULTIPLE intents for audio/*, allowing import from external sharing/opening; also supports scanning local audio files on the device. - ☁️ GitHub Private Repository Sync: Optionally sync local playlists, favorite playlists, recently played tracks, and deletion records. Uses WorkManager for deferred and periodic sync. - 🛠️ Developer Mode & Debugging Tools: Tap the version number 7 times in Settings to reveal a dedicated Debug tab in the bottom navigation, containing API probes for YouTube / Bilibili / NetEase / Search, as well as general log and crash log viewers. - 🌈 Audio-Reactive Dynamic Background: On the Now Playing screen (Android 13+), users can optionally enable audio-reactive background effects based on RuntimeShader. - ♻️ Local Backup & Restore: Supports JSON import/export of local playlists and favorites data for device migration or manual backup. - 🎧 Listen Together: Supports creating or joining rooms for real-time playback state synchronization via WebSocket, with independent room permissions (host/listener) and host offline detection.

License

GNU General Public License v3.0