Gramophone：Android 本地音乐播放器

项目简介

Gramophone 是一款使用 Kotlin 编写的 Android 音乐播放器，基于 media3 与 Material Design 库构建，严格遵循 Android 平台规范。它主打轻量、稳定与极简，界面采用较新的 Material 3 设计语言，并通过 MediaStore 快速读取设备上的本地音乐。

主要功能

• 轻量、稳定、极简的整体体验
• 采用较新的 Material 3 设计与主题
  • 播放器界面支持 Monet 动态取色
  • 支持 Monet 主题图标（Android 12 及以上）
• 音乐库功能
  • 搜索与浏览本地音乐
  • 通过 MediaStore 快速访问设备上的音乐
  • 列表视图与网格视图
  • 可按文件夹与文件系统浏览歌曲
  • 自然排序及多种排序方式
  • 支持播放列表
• 同步歌词
  • 支持 LRC、TTML、SRT 格式
  • 支持逐词/逐音节卡拉 OK 式歌词同步
• 完整支持 ReplayGain 2.0
• 支持系统及第三方均衡器应用

安装与使用

稳定版可从以下渠道下载安装：

• GitHub releases
• F-Droid
• IzzyOnDroid
• Google Play

测试版与预览版可通过 Telegram 频道 或 讨论群 获取。

若要从源码构建，需要最新测试版 Android Studio 与较快的网络：

1. 拉取 git 子模块（media3 等依赖以子模块形式引入）：

git submodule update --init --recursive

2. 在仓库根目录新建 package.properties，写入：

releaseType=SelfBuilt

3. 用 Android Studio 导入项目并配置自己的签名，即可开始构建。

注意事项

• 默认隐藏时长小于 60 秒的歌曲，可在「三个点 > 设置 > 行为」中调整（设为 0 可显示全部歌曲）。
• 若修改后仍有歌曲缺失，请检查「行为 > 文件夹黑名单」是否排除了对应目录，然后重启手机并等待几分钟让系统媒体数据库重新扫描。部分扩展名受系统版本限制，例如 .opus 需 Android 10 及以上才会被扫描（可改名为 .ogg 以在 Android 6 及以上被识别）。
• 应用依赖系统媒体解码器以减小体积：32 位整型 FLAC 需 Android 14 及以上；FLAC 官方支持 Android 8 及以上；xHE-AAC 需 Android 9 及以上；Dolby Digital（AC-3）/ Dolby Digital Plus（E-AC-3）/ AC-4 需要设备具备相应授权解码器。ALAC 例外，应用内置了极轻量的 Java ALAC 解码器。
• 项目使用 GPL-3.0 许可证。

---

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