NeriPlayer

A native Android audio player that combines multi-source streaming, local control, rich lyrics, and self-hosted sync. / ✨ 一个把多源在线播放、本地管理、歌词体验和自建同步做进原生 Android 的音频播放器 🎵

⭐ 3,933 stars on GitHub · 🍴 148 forks · 📜 License: gpl-3.0 · 💻 Language: Kotlin

What is NeriPlayer?

A self-hosted media server — turn your NAS/VPS into a personal cinema. Stream movies & music to your household without subscription dependency.

Main components

• 🎧 多源探索与播放：
• 🏠 首页推荐与继续播放：
• 🗂️ 媒体库分类浏览：
• 🔍 分层搜索能力：
• 🧠 Media3 播放核心：
• YouTube 登录态会保留有效 Cookie，并支持 Cookie 轮换、匿名播放会话、bootstrap/
• ⏩ 可选 BilibiliSponsorBlock 自动跳过：默认关闭。开启后仅向公开接口发送当前
• ⏭️ Bilibili 自定义跳过区间：可从正在播放的更多选项或 Bilibili 收藏夹/合集条目

The biggest strength is offline-first streaming + ad-free + unlimited library scaled by your disk size.

Best for families building home theaters, small hotels streaming internal media, creators archiving work.

Topics: the project is tagged with popular topics:

• 🏷️ android
• 🏷️ equalizer
• 🏷️ exoplayer
• 🏷️ glsl
• 🏷️ jetpack-compose
• 🏷️ karaoke-lyrics
• 🏷️ listen-together
• 🏷️ media3
• 🏷️ music
• 🏷️ native-apps

📸 Screenshots

Quick install

See the README for detailed install instructions. Most projects support Docker — if the repo has a Dockerfile, use:

git clone https://github.com/cwuom/NeriPlayer.git
cd NeriPlayer
docker build -t NeriPlayer .
docker run -d -p 8080:8080 NeriPlayer

Minimum system requirements

⚡ Deploy fast on VSIS

Use the VSIS VPS Mini 1GB RAM / 1 vCPU / 15GB SSD (~70k/tháng) plan from VSIS.NET — high-speed VN-based VPS, 24/7 support, ideal for running NeriPlayer smoothly.

🎯 Benefits:

• One-command docker compose up -d deploy in 2 minutes
• Dedicated IPv4, root access, unmetered domestic bandwidth
• Daily snapshot backup
• Free install assistance from the VSIS team

👉 See matching VPS plans at vsis.net

Resources

• 🔗 GitHub: cwuom/NeriPlayer
• 🌐 Homepage: https://neri.kano.kim
• 📚 Official docs: see README in the repo
• 💬 Community: GitHub Issues + Discussions

Article compiled from GitHub data on 27/10/2026. Star/fork counts may have changed — see live numbers via the GitHub link.