波尼音乐：Android 开源在线音乐播放器

项目简介

波尼音乐（PonyMusic）是一款用 Kotlin 编写的 Android 在线音乐播放器，界面风格参考网易云音乐。播放能力基于 Media3 + ExoPlayer 构建，既可以作为本地音乐播放器使用，也可以连接自建的网易云 API 服务，实现在线听歌、歌单同步等功能。项目采用 MVVM 架构，使用 Retrofit、Room、Hilt、Glide 等开源技术栈。

作者还写过一系列配套文章，讲解播放器基本功能、黑胶唱片效果、自动滚动歌词、在线列表自动加载更多等实现细节。

主要功能

本地功能

• 基于 Media3 + ExoPlayer 构建播放能力
• 添加和播放本地音乐文件
• 专辑封面显示
• 歌词显示，支持拖动歌词调节播放进度
• 通知栏控制
• 桌面小组件
• 夜间模式
• 定时关闭

在线功能

• 登录网易云（验证码 + 扫码）
• 同步网易云歌单
• 每日推荐
• 歌单广场
• 排行榜
• 搜索歌曲和歌单
• 添加歌曲到歌单
• 喜欢歌曲
• 下载歌曲
• 管理歌单
• 设置在线播放 / 下载音质

安装与使用

环境要求

• Android 手机（系统版本为 Android 6.0 及以上）
• 电脑（非必须）

安装步骤

1. 搭建网易云服务器

   由于使用的是非官方 API，需要自行搭建 API 服务器。打开服务端项目 NeteaseCloudMusicApi（或 NeteaseCloudMusicApiBackup）主页，根据项目说明安装并运行服务，需要确认电脑和手机处于同一局域网。

2. 安装 APP

   下载最新安装包安装。

3. 设置域名

   打开 APP，点击左上角汉堡按钮，打开抽屉，点击「域名设置」，输入步骤 1 中的地址（包含端口）。

4. 设置完成即可体验。

没有电脑，如何体验？

部署后端 API 服务的电脑其实可以用 Android 手机代替：

1. 安装 Termux（Android 平台的开源终端模拟器），GitHub 下载地址。
2. 安装 nodejs：启动 Termux，执行 pkg install nodejs，完成后可通过 node -v 确认是否安装成功。
3. 运行网易云服务器：在 Termux 中执行 npx NeteaseCloudMusicApi@latest 安装并运行服务，看到控制台打印 server running @ http://localhost:3000 即表示运行成功。
4. 设置域名：打开波尼音乐 APP，输入域名 http://localhost:3000/ 并重启即可。

注意事项

• 在线功能依赖自行搭建的网易云 API 服务，未配置可用的服务器域名时在线功能无法使用。
• 本地音乐需要按系统的权限要求授予读取权限后才能扫描到文件。
• 如果发现功能问题或兼容性问题，可以到 GitHub Issue 反馈。
• 项目以 Apache License 2.0 协议开源。

---

本作品整理自 GitHub 开源项目 wangchenyan/ponymusic，原作者 @wangchenyan。中文介绍由 AI 根据项目 README 整理，以原仓库为准。