cwuom/NeriPlayer

Public

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

android equalizer exoplayer glsl jetpack-compose karaoke-lyrics listen-together media3 music native-apps player privacy-focused self-hosted shaders usb-exclusive webdav websocket

Star4k Fork151 Watch6 Mở trên GitHub

Bee AI phân tích repositoryBETA

AI đọc README và cây file để tóm tắt, gợi ý cách dùng và đánh giá repository. Mọi con số lấy từ kho Bee, không do AI ước lượng.

Cập nhật lần cuối: 02/10/2026

Đăng nhập để hỏi Bee AI

Tóm tắt bởi Bee AI

NeriPlayer là ứng dụng phát âm thanh Android gốc mã nguồn mở được xây dựng bằng Jetpack Compose và Media3. Ứng dụng tích hợp phát đa nguồn (NetEase, Bilibili, YouTube Music), phát cục bộ, đồng bộ tự host và tối ưu trải nghiệm lời bài hát.

Hỗ trợ phát đa nguồn từ NetEase Cloud Music, Bilibili, YouTube Music cùng thư viện âm thanh cục bộ.
Đồng bộ hóa phi tập trung siêu dữ liệu (danh sách phát, lịch sử, thống kê) qua GitHub cá nhân hoặc WebDAV.
Giao diện Compose mượt mà với hiệu ứng nền RuntimeShader / GLSL và trải nghiệm lời bài hát chi tiết kiểu Apple Music.
Tính năng nghe chung (Listen Together) theo thời gian thực sử dụng Cloudflare Worker Durable Objects và WebSocket.
Hỗ trợ xuất âm thanh USB độc quyền (USB Exclusive) cho các thiết bị DAC ngoài chuẩn UAC1.0 / UAC2.0.

Lưu ý

Dự án chỉ dành cho mục đích nghiên cứu và học tập; không cung cấp nội dung âm nhạc, dịch vụ proxy hay cách thức vượt bản quyền/DRM.
Yêu cầu thiết bị chạy Android 9 (API 28) trở lên; một số hiệu ứng nâng cao như RuntimeShader yêu cầu Android 13+.
Dự án đang trong quá trình phát triển tích cực, các bản release có thể vẫn chứa lỗi chưa được phát hiện hết.

Điểm BeeTính thuần từ số liệu trong kho Bee, không phải AI chấm: bách phân vị sao 30% · độ tươi lần push 25% · fork và watcher 15% · README, giấy phép, mô tả 20% · có bản phát hành 10%.

76/100Điểm tổng thể

Độ phổ biến64
Độ tươi100
Cộng đồng13
Tài liệu100
Phát hành100

Mức độ khóTrung bình
Phù hợp vớiLập trình viên
Loại dự ánỨng dụng
Giấy phépGPL-3.0

Kiến trúc & Công nghệ

Công nghệ AI nhận ra từ README và cây file — chỉ những mục nằm trong danh sách Bee kiểm.

Tech stack

Kotlin
Android
WebSocket
CMake

Kiến trúc tổng quan

Repository → công nghệ chính → các thư mục cấp 1 có thật trong repo; vai trò do AI mô tả.

RepositoryNeriPlayerỨng dụng

Công nghệ chính

Kotlin

app/Chứa mã nguồn ứng dụng Android chính (UI Compose, dịch vụ phát nhạc, cấu hình).
build-logic/Các quy tắc và cấu hình tùy chỉnh cho hệ thống build Gradle.
buildSrc/Logic hỗ trợ quản lý phụ thuộc và tác vụ build.
docs/Tài liệu kỹ thuật và hướng dẫn triển khai.
modules/Các module tính năng tách rời của dự án.
ksp-processor/Bộ xử lý annotation KSP tùy biến.

app/Chứa mã nguồn ứng dụng Android chính (UI Compose, dịch vụ phát nhạc, cấu hình).
build-logic/Các quy tắc và cấu hình tùy chỉnh cho hệ thống build Gradle.
buildSrc/Logic hỗ trợ quản lý phụ thuộc và tác vụ build.
docs/Tài liệu kỹ thuật và hướng dẫn triển khai.
modules/Các module tính năng tách rời của dự án.
ksp-processor/Bộ xử lý annotation KSP tùy biến.

Hướng dẫn nhanh

Các bước để bắt đầu với repository này.

bash

git clone https://github.com/cwuom/NeriPlayer.git
cd NeriPlayer

Các use case chính

Những ứng dụng có thể xây dựng từ repository này.

Phát và tìm kiếm nhạc trực tuyến từ NetEase Music, Bilibili và YouTube Music với các cơ chế tự động chuyển nguồn dự phòng.
Quản lý tệp âm thanh ngoại tuyến, quét thư mục cục bộ và đồng bộ dữ liệu nghe nhạc lên WebDAV hoặc kho GitHub riêng tư.
Tạo phòng nghe nhạc chung cùng bạn bè qua WebSocket và đường dẫn chia sẻ bảo mật.
Thưởng thức âm thanh chất lượng cao xuất trực tiếp qua USB DAC với chế độ USB Exclusive.

Repository tương tự

Cùng chủ đề trong kho Bee.

Nội dung do AI sinh, có thể sai hoặc thiếu — số liệu lấy từ kho Bee, không do AI ước lượng. Cập nhật lần cuối: 02/10/2026.