Auxio：简洁的 Android 本地音乐播放器

项目简介

Auxio 是一款面向 Android 的本地音乐播放器。它只做一件事：播放你设备里的音乐。作者强调「快速、可靠的 UI/UX」，刻意去掉了其他播放器里大量无用的功能。它基于现代媒体播放库构建，因此音乐库支持和听感质量优于仍在依赖过时 Android 接口的应用。

应用完全离线、完全私密，不联网也能正常使用。

主要功能

• 基于 Media3 ExoPlayer 的播放内核
• 遵循最新 Material Design 规范的轻快界面
• 有明确取舍的交互设计，优先保证易用性
• 可自定义的播放行为
• 支持碟片号（disc number）、多位艺术家、发行类型、精确或原始日期、排序标签等元数据
• 统一的艺术家系统，把艺术家与专辑艺术家合并处理
• 感知 SD 卡的文件夹管理
• 可靠的播放列表功能，并支持播放状态持久化
• 支持 Android Auto
• 自动无缝播放（gapless playback）
• 完整的 ReplayGain 支持（适用于 MP3、FLAC、OGG、OPUS、MP4 文件）
• 支持外部均衡器（例如 Wavelet）
• Edge-to-edge 全面屏显示
• 支持内嵌封面
• 搜索功能
• 耳机接入自动播放
• 会随尺寸自动适配的桌面小组件
• 完全私密、完全离线
• 专辑封面可选择不使用圆角

安装与使用

官方分发渠道：

• F-Droid
• Accrescent

应用需要以下权限：

• 存储权限（READ_MEDIA_AUDIO、READ_EXTERNAL_STORAGE）：读取并播放音乐文件
• 服务权限（FOREGROUND_SERVICE、WAKE_LOCK）：保证后台持续播放
• 通知权限（POST_NOTIFICATION）：显示正在播放和音乐加载状态

从源码构建的要点：

1. 需要先安装 cmake 与 ninja-build。
2. 项目使用了 submodule，克隆时需加 --recurse-submodules：

git clone --recurse-submodules

3. 需要 NDK 版本 28.2.13676358，以及 Java 21。
4. 构建与安装：

./gradlew assembleDebug
./gradlew installDebug

通过 USB 调试向设备推送音乐文件（可选）：

cd ~/Android/Sdk/platform-tools
./adb push ~Music/ /sdcard/Music

注意事项

• 仓库默认分支是开发版；需要稳定版请查看 master 分支。
• Auxio 依赖于带有额外播放特性的 Media3 补丁版本，并使用 taglib 解析元数据，因此无法在 Windows 上构建（自定义 Media3 构建会执行仅适用于类 Unix 系统的 shell 脚本）。
• 项目以 GPL-3.0 许可证开源。

---

本作品整理自 GitHub 开源项目 OxygenCobalt/Auxio，原作者 @OxygenCobalt，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。