Harmony Music

Harmony Music 是一款安卓端的开源本地音乐播放器，主打轻量、纯净、无广告的离线听歌方式。它不连接任何在线曲库，把手机里已有的音频文件导入后就能获得接近专业播放器的使用体验。界面采用 Material Design 设计语言，支持动态取色与深色模式，操作路径直接，适合不想被推送和会员体系打扰的用户。通勤路上听本地专辑，或者睡前放一段白噪音，它都能以很低的资源占用稳定运行。

本地曲库管理方式

应用会自动扫描设备里的音频文件，按歌曲、专辑、艺术家、文件夹等维度归类。你也可以手动指定扫描目录，把提示音、录音这类杂项挡在曲库外面。碰到标签混乱的歌曲，内置的标签编辑器能修改标题、艺术家、专辑封面等信息，让本地音乐库保持整齐。

音效调节功能

播放器内置均衡器和低音增强，提供摇滚、流行、古典等预设音效，也支持手动拖动频段滑块做精细调整。用有线耳机时，还能开启交叉淡入淡出，让前后两首歌的衔接更顺，减少切换时的静音突兀感。

歌词与封面显示

支持读取内嵌歌词和外部 LRC 文件，播放时自动滚动显示，歌词时间轴也能手动调整，用来修正不同步的问题。专辑封面可以从本地图片替换，配合播放页的模糊背景效果，整体视觉表现在同类本地播放器里属于上乘水准。

定时与播放控制

睡前听歌可以设置睡眠定时器，到点自动暂停，不用整夜耗电。通知栏和锁屏界面都有完整的播放控制，耳机线控和蓝牙设备按键也能用，切歌、暂停不用解锁手机。

首次使用与问题排查

第一次打开 Harmony Music 会提示授予存储权限，要选择允许访问音频文件，否则曲库会显示为空。Android 13 及以上系统的权限入口叫“音乐和音频”，弹窗里点允许即可，不要选“仅本次允许”，免得每次启动都要重新授权。

建议在设置里手动添加音乐文件夹路径，跳过系统缓存目录和下载临时目录，扫描速度会明显提升。导入歌曲后封面不显示，多半是音频文件本身没有内嵌封面，长按歌曲进入编辑界面手动加图就行。

首次扫描大量文件时应用可能短暂无响应，这是正常现象，等扫描完成即可，不要频繁强制关闭。播放卡顿或闪退时，先检查音频文件是否完整，部分损坏的 MP3 会导致解码失败，可以换其他播放器验证一下。

均衡器调节后没效果，要确认当前输出设备是否支持。部分蓝牙耳机走系统音频通道，应用内的音效设置不会生效。

电脑端想管理曲库，可以用数据线把手机连上电脑，把音乐文件放进 Music 文件夹，再回到应用里刷新媒体库。电脑端无法直接运行这个安卓应用，需要借助模拟器环境，普通用户不建议折腾模拟器，直接在手机上操作最稳妥。

通知栏控制不显示的话，去系统设置里检查应用通知权限是否被关闭，同时确认电池优化没有限制该应用。曲库里出现重复歌曲，可以在设置中开启“忽略短音频”并清理重复文件夹，通常能解决大部分重复条目。需要补充解码组件或遇到特定格式无法播放时，可在站内搜索“音频解码器”查找相关资源。

应用安全性说明

这是一个开源项目，代码公开可查，不包含广告 SDK 和后台推送服务，安装包体积小巧。权限申请只涉及存储读取和通知控制，属于本地工具类应用的正常范围。

歌曲导入方法

1. 用数据线把手机连上电脑，把音乐文件复制到手机内部存储的 Music 文件夹，打开应用后进入设置，点击“重新扫描曲库”。

2. 直接在手机文件管理器里把歌曲移动到任意文件夹，然后在应用设置里手动添加该文件夹路径并刷新。

扫描完成后，歌曲会自动按标签分类显示。

支持的音频格式

MP3、AAC、FLAC、WAV、OGG 等常规格式都能正常播放，覆盖了绝大多数用户手里的音频文件。部分特殊编码的 M4A 或高采样率无损文件如果无法播放，通常是设备解码器限制导致，可以尝试在设置里切换音频输出模式，或者用格式转换工具转成通用格式再导入。

版本更新记录

v1.12.2（2026-01-18）

· 新增按文件夹浏览模式，支持自定义扫描排除目录，减少无关音频干扰。

· 播放页加入左右滑动切换歌曲手势。

· 曲库扫描速度提升约 35%，万首歌曲首次扫描耗时从 48 秒缩短至 31 秒。

· 均衡器预设加载响应加快，切换音效不再出现短暂爆音。

· 修复了上一版本中部分 FLAC 文件播放到结尾处自动跳回开头的 bug。

· 修复通知栏封面在锁屏状态下偶发不刷新的问题。

· 修复深色模式下歌词文字对比度过低导致看不清的缺陷。