Releaserecommended
Published by hand once a batch of features lands, built for four ABIs: arm64-v8a, armeabi-v7a, x86 and x86_64. It isn't a strictly stable channel and may still hide issues that haven't surfaced yet.
GitHub Releases ↗00NeriPlayer · Music for phones and computers
The songs you love live in different places. NeriPlayer brings NetEase Cloud Music, Bilibili, YouTube Music and local songs into one player, keeping playlists and listening history on your device by default. A familiar way to listen, on your phone or computer.
For Android 9 and later, with desktop previews for Windows, macOS and Linux. Free and open source under GPL-3.0.
Also on your computer: Windows · macOS · Linux desktop app ↘
Signals Multi-source Local first Self-hosted sync
Listening together tonight?
01Download · 下载
Choose your phone or computer, then pick the right download for your device and start listening.
SHA-256
Published by hand once a batch of features lands, built for four ABIs: arm64-v8a, armeabi-v7a, x86 and x86_64. It isn't a strictly stable channel and may still hide issues that haven't surfaced yet.
GitHub Releases ↗Every successful build on master uploads an arm64-v8a APK — grab one here if you want the newest bits first.
# Clone the repo with its submodules
git clone --recursive https://github.com/cwuom/NeriPlayer.git
cd NeriPlayer
# Build a debug APK and install it
./gradlew :app:assembleDebug
adb install -r app/build/outputs/apk/debug/app-debug.apk
The DEBUG build uses the package moe.ouom.neriplayer.debug and an orange icon, so it installs alongside the release.
| arm64-v8a | Nearly every phone and tablet from recent years |
|---|---|
| armeabi-v7a | Older 32-bit ARM devices |
| x86_64 / x86 | Emulators, Intel devices or Chromebooks |
Read the disclaimer and finish onboarding first. Onboarding explains the notification and local music permissions, which are only requested when you tap — skipping them won't stop you from using the app.
SHA-256
Published after each batch of features, with packages for Windows, macOS and Linux, plus SHA256SUMS.txt, macOS install notes and the source and build scripts for the bundled FFmpeg. When reporting an issue, include the build version from Settings → About.
To try changes that haven’t shipped yet, pick a successful run of the Artifacts workflow and download the build for your platform. You need to be signed in to GitHub; unzip the outer archive before installing.
# Clone the repo with the lyrics submodule
git clone --recursive https://github.com/cwuom/NeriPlayer-Desktop.git
cd NeriPlayer-Desktop
pnpm install --frozen-lockfile
# Start Vite and the Tauri dev window
pnpm tauri dev
You also need the Tauri prerequisites and a toolchain to compile the FFmpeg C++ shim.
| Windows | The installer isn’t code-signed yet. If SmartScreen blocks it, choose “More info → Run anyway”; install the WebView2 runtime first if it’s missing |
|---|---|
| macOS | Ad-hoc signed and not notarized: drag it into Applications, open it once, then choose “Open Anyway” in System Settings → Privacy & Security |
| Linux | Make the AppImage executable after extracting; install deb / rpm with your distribution’s package manager |
Connect both to the same GitHub repository or WebDAV folder in Backup & Sync. The first time an old format is found you’ll be asked to upgrade; update your other devices to the latest version before confirming. Audio files are never synced.
02Dual-theme design · Themes
A look for daylight and late nights. Clean keeps things simple and spacious; Material You brings more color. Both offer light and dark modes. Try switching between them and see what feels right.
Clean brings your music forward with neutral surfaces, clear typography and a floating glass navigation bar.
03Now Playing · 正在播放
Play a song and watch its cover colors drift through the background. Try the themes and immersive layout, press play for Startrail, then drag the progress bar or follow the lyrics. Use the mute button below whenever you would rather just look.
Media3 / RuntimeShader
The Now Playing background is drawn by BgEffectPainter, which loads a GLSL / AGSL shader and renders it frame by frame through RuntimeShader. Palette first pulls five color roles from the cover — Base, Accent, Light, Dark and Bridge — then blends them into flowing patches and grain, wired to uMusicLevel / uBeat so it moves with the beat. It is not just a Gaussian-blurred cover.
This background is the app's own shader, ported to WebGL ↗
WaveformSlider
While playing, the progress bar becomes a slowly flowing wave; on pause it settles into a straight line, and while buffering it turns into a beating pulse. Underneath, quality, codec and format show as configured — like RAW · 48 kHz for this FLAC — and dragging gives haptic ticks along the lyric timeline.
Now Playing controls position
Holding the phone in one hand? Move shuffle, previous, play, next and repeat down within thumb reach, and bring the progress bar along if you like. While the controls sit at the bottom, the Dock becomes a regular toolbar so the two never overlap.
SyncedLyricsView
Under the controls sits a strip of synced lyrics: the current line lights up word by word, its translation follows only that line, and the rest fade quietly to the side. Tap a line to jump there, long-press to share. If it feels crowded, the cover-page lyrics and the bottom toolbar can each be turned off.
| No.NP-01 | Version— | PlatformAndroid | Page01 / 14 |
| StatusAndroid 9+ · fluid background & advanced blur need Android 13+ | |||
| Sourcecwuom/NeriPlayer · 3.7k · 131 | Date— | ||
| Demo track“星轨” · Neri Line · NeriPlayer PV | NP | ||
Local FilesRAW·48 kHz
04Lyrics · 歌词
The line being sung lights up, with its translation just below. If the timing is a little off, adjust it by hand. Turn a favorite line into a card to keep or share with a friend.
LRC / YRC / TTML
Line-synced and word-synced LRC (including line-end times and bracketed word timestamps), YRC and TTML are all supported. The lyrics page only shows options the current song can actually use, and after a track change it waits until lyrics are resolved before fading in — no flash of empty space.
Fig. 02b — with romanization (illustration)
星の線路を そっと辿って
hoshi no senro wo sotto tadotte
For Japanese songs that ship with romanization, the secondary line can switch to it: it also sits right beneath the original, taking the translation's place instead of floating above. When a song has no romanization, the option simply isn't there — like “星轨” above, which only has “Trans”.
Fig.Clean · Real device screenshots
This is how it looks on a phone ↓




05Sources · 多源
From NetEase Cloud Music playlists and Bilibili live performances to YouTube Music and local songs, there is plenty to discover. Search each platform separately, then add the songs you find to one queue and keep listening.
Login · Search · Play · Download · Comments
From daily picks and Personal FM to artist pages, NetEase is the most complete line.
| Login | ✓ | Download | ✓ |
|---|---|---|---|
| Search | ✓ | Lyrics | ✓ |
| Playlists | ✓ | Comments | ✓ |
Favorites · Collections · Multi-part
Listen to video favorites like playlists: multi-part videos play and download as audio, with collection context kept all the way through.
BVID + CID, syncable via GitHub / WebDAVAccount sessions · Playback compatibility
In international mode, the home page puts YouTube Music playlists and song shelves first.
player.js firstImport · Scan · Organize
Songs in a folder move into your library along with the lyrics and covers sitting next to them.
lrc / txt lyrics and cover / folder / front artworkAutomatic fallback
When a song won't play, NeriPlayer looks for another way first instead of just throwing an error.
Bilibili and local fallback are off by default — switch them on yourself
Share text → detail page
“Link recognition” on the Explore page takes a bare link, or an entire share message with a title and a short link.
season_id collection context; types without a detail page get a clear notice06Hi-Fi · 音质
Put on your headphones and give an album your full attention. Connect a compatible external digital-to-analog converter (DAC) to your phone to use USB exclusive output. With suitable hardware and source audio, the sound can bypass the system mixer and go straight to the DAC.
Bit-perfect skips the effects chain ↷
07Native DSP · 音效
No two headphones sound quite alike, and everyone has their own taste. The phone and desktop apps share 29 sound presets, with manual controls for vocals, bass and individual frequency bands. Play a familiar song and take your time finding the sound you like.
Settings · Audio effects & speed
At the top are the master switch and live status: the current output device, processing load and the clipping guard. Below are eight sections, each with its own switch. Turning one off only lets that part play as original, and your values stay put; a small dot lights up next to any section you have changed. Tap a section below and the phone flips to it.
Drag a dot on the curve or switch presets, and the sound really changes ↗

Sound previewWeb Audio approximates the effects. Your browser selects the output; native processing is available in the app.
Effect monitorModeled spectrum · switches to live analysis once you press play
Stereo field100%
OutputGR 0.0 dB
Processing · lit stages are active
08Listen Together · 一起听
Share a chorus, even when your friends are far away. Create a room and send an invite to keep tracks and playback in sync. Wherever you are, there is a melody you can share.



Room NR7K2Q · live sync
09Local & offline · 本地与离线
Even where there is no signal, music can keep you company. Songs on your device and music already cached remain available offline. Playlists, history and settings stay on the device, keeping familiar music close at hand.
NetworkStatusMonitor detects being offline from the system's default network; while offline, remote image requests are blocked and cached covers come first.
No system DownloadManager: plain HTTP appends with Range, chunked transfers resume by offset, and HLS recovers from checkpoints. The queue is persisted and resumes after a restart; canceling by hand cleans up partial files.
Cleanup only touches caches that can be rebuilt — songs you chose to download are never treated as cache. The audio cache is capped at 1 GB by default.
Neri feat. Noir / Karuha、Hanae
NeriNoirKaruhaHanae
Splits on feat., with, 和 / 与, the Chinese list comma, semicolons and slashes; artist pages can play everything, multi-select into a playlist, or batch-download online songs.
Separates playback / download traffic, Wi‑Fi / mobile / roaming and cache hits, and warns before downloading on risky networks.
10Sync & Privacy · 同步与隐私
Changing devices does not mean starting your playlists from scratch. Sync playlists, favorites and listening history through your own GitHub repository or WebDAV storage. You choose where they are kept.
beforeOid; WebDAV uploads immutable objects first, then writes the manifest with a strong ETagNo ad SDKs, third-party analytics or crash-reporting SDKs.
No cloud media distribution, and no personal data gathered into the maintainers' hands.
Audio cache, downloads, cookies and playback tokens are never uploaded.
Local play history is never written back to third-party platforms, so it won't trip risk controls or suspicious-login checks.
Play counts, listening time and daily buckets are recorded against each song's stable identity, and they take part in sync merges too.
Listening time
Week / month / year use rolling 7 / 30 / 365-day windows; the weekly hot list only counts songs with at least 10 minutes of total listening, and the monthly list needs 30. Neither the GitHub repository nor the WebDAV files are end-to-end encrypted, so keep them safe.
11Personalize · 个性
Everyone has their own way of getting around. Choose which page opens first, adjust theme colors, interface and lyric sizes, and arrange the home page to suit your habits.
NeriPlayer
Continue
Local Files10 songs
Neri Line2 songs
NeriPlayer PV10 songsPersonal Radar



Radar Playlists
Radar时光
Radar宝藏
Radar新歌
Radar乐迷
Radar神秘Trending



New Picks

12Tablet · 平板
A bigger screen gives your music room to breathe. In landscape, cover art and lyrics sit side by side, as do settings lists and details. These four images show the app running in a tablet emulator.
1
2
3
4
1
2
3
4
1
2
3
4
1
2
3
4
Phones stay locked to portrait, and only Now Playing can rotate; tablets held upright get a Now Playing layout of their own.
13Desktop · 桌面
Let familiar songs keep you company while you write or work. The Windows, macOS and Linux previews support desktop lyrics and keyboard shortcuts for changing tracks. They can also sync playlists with your phone and join the same Listen Together room.
Preview simulation, not the final versionThe app you actually run is the reference for its interface and features.
The window holds the real interface structure and styles exported from the desktop front end, wired to this page’s player; the tracks and covers are NeriPlayer PV samples, and no account is signed in. Light and dark follow this page, and the system can be switched at the top right. The desktop app is still in preview and this simulation is a snapshot of one moment — the version you actually run is the reference.
Desktop lyrics · Tray · SMTC
A separate desktop lyrics window lights up word by word, in one line, two alternating lines or three scrolling lines, with the second line showing the translation or the next line. Colors, font, outline, shadow and opacity are all adjustable; once locked, clicks pass through while an unlock button stays on hover. Close the main window and it keeps playing from the tray, with media keys and the system media session still working.
Colors
Layout
Second line
Drag the lyrics bar, then click Neri in the tray at the bottom right ↘
In-app shortcutsClick here, then try your keyboard
Windows · macOS · Linux
One Tauri 2 + Rust core, hooked into each system’s own media session, tray and audio output. The table lists the release workflow’s targets and the platform code in the source; how the tray, lyrics and media keys look still depends on the system and desktop environment.
You’re onWindows
| Feature | Windows | macOS | Linux |
|---|---|---|---|
| Media session | SMTC: lock screen, volume flyout and headset buttons | Now Playing: Control Center and media keys | MPRIS: GNOME / KDE media controls |
| Tray & background | Notification area icon; close to tray and keep playing | Menu bar icon; closing the window doesn’t quit | Status area icon (depends on the desktop environment) |
| Lyrics | Desktop lyrics with click-through when locked | Desktop lyrics + menu bar lyrics | Desktop lyrics with click-through when locked |
| Global shortcuts | Ctrl + Alt combos | Cmd + Option combos | Ctrl + Alt combos |
| Audio output | cpal · WASAPI | cpal · CoreAudio | cpal · ALSA |
| Packages | .exe (NSIS) · .msi | .dmg · Apple Silicon / Intel | .deb · .rpm · AppImage |
| Requires | x64 · WebView2 runtime | Apple Silicon 11.0+ · Intel 10.15+ | x64 · WebKitGTK 4.1 · GTK 3 |
| First launch | Not code-signed yet; choose “Run anyway” in SmartScreen | Ad-hoc signed; choose “Open Anyway” in Privacy & Security | Extract the AppImage and make it executable |
The desktop app has no in-app updater; grab new versions from Releases. USB exclusive, SAF and status bar lyrics are Android features; on desktop the tray, desktop lyrics, media session and shortcuts fill those roles.
14Details · 细节
The little things you use every day deserve care, too. Home screen widgets, long-press shortcuts and mini-player gestures save a few taps. Playback also remembers your place in long recordings.
Material You rounded cards colored from the cover, adapting to light and dark themes, large fonts and both orientations. The wide card adds favorite and desktop-lyrics buttons; even the narrow sizes keep previous, play and next, and elapsed time ticks every second while playing.
Shown: the widget previews bundled with the app.
Long-press the app icon to jump straight in; when there's no queue to restore, you get feedback instead of a silent failure.
Swipe the bottom mini player left or right for the previous / next track; tap to expand and play / pause work as usual.
Floating lyrics let you set color, outline, size, position and alignment; Meizu status-bar lyrics, SuperLyric, Lyricon and Bluetooth lyrics are supported.
Android Auto and devices with AVRCP browsing can browse the queue and playlists and search the library; connecting never starts playback by itself.
JVM crashes, native crashes and system ANRs are all recorded; after an abnormal exit, full initialization is skipped and the app goes straight into safe mode.
Long podcasts and multi-part videos pick up where you left off; an explicitly requested position always wins over the remembered one.
It works the same on a real device: tap the version 7 times in Settings and a Debug tab appears in the nav bar, with per-platform probes and a log viewer.
15Inside · 构造
Code takes care of the details behind playback, lyrics and sync. Below, fourteen Android modules show how the work is divided. It is all on GitHub. If you find the app useful, a Star is a simple way to support the project.
iFAQ · 常见问题
Yes. Select songs in your local library, then choose “Export to Playlist” to add them to a playlist of your own, alongside online tracks.
Connect both devices to the same GitHub or WebDAV sync location to sync playlists, favorites, listening history and statistics. Audio downloads are not uploaded; you will need to transfer or download them separately on the other device.
Usually not: that app’s private cache is isolated by Android. To save data, download songs in NeriPlayer; it will prefer the local copy when the file is available.
Yes. In Settings → Third-party Platform Login → Bilibili, choose QR sign-in. Scan and confirm in the Bilibili app, then return to NeriPlayer. The QR page also offers web sign-in.
First, try the YouTube Music website with the same network and account. Network, region and account restrictions still apply, so signing in alone does not guarantee access to its content.
Yes. NeriPlayer Desktop is available for Windows, macOS and Linux from its GitHub Releases page. It is still a preview; choose the package for your operating system and processor.
Shuffle and repeat are separate controls. Turn shuffle off to play in order. Repeat controls whether the queue starts over or the current track repeats; the icon with “1” means repeat one.
Yes. Open Settings → Now Playing → Now Playing control size to resize the top actions, main controls and bottom toolbar together. The lyrics page has its own control size setting.
Open Now Playing → More → Adjust Lyrics Behavior to control the second lyric line. When a song has both translations and phonetics, turn on “Show lyric translation”, then use “Show phonetics” to switch.
Word-by-word highlighting needs timing data for each word. Try another lyric source or song version under “Get Song Info” to find lyrics with word timing.
Try enabling metadata post-processing and “Standardized lyric embedding” in download settings, then download the song again. The latter converts embedded word-by-word lyrics to more widely supported line-by-line LRC.
With “Bit-perfect output” off, use the volume keys, lock screen or system volume panel. With it on, the keys adjust the DAC’s hardware volume when supported. Otherwise, switch bit-perfect output off to adjust volume on your phone.