项目地址： https://github.com/astralwaveorg/lyra 文档： https://github.com/astralwaveorg/lyra/tree/main/docs 镜像：ghcr.io/astralwaveorg/lyra:1.0.0
Lyra 是一个自托管的音乐库维护工具。它不下载音乐，也不接管播放，只维护你已有的本地文件。
它主要做四件事
- 歌词：从 QQ 音乐、网易云音乐、LRCLIB 抓取，写入内嵌歌词和同名
.lrc；已有有效歌词默认跳过；支持逐行对比、批量采纳和撤销。 - 标签：按 MusicBrainz 补齐缺失字段，逐字段显示本地值、来源值和冲突；冲突不会自动覆盖；缺 MBID 或候选有歧义时可以用 AcoustID 指纹兜底。
- 整理：按
艺人 / 专辑 / 音轨号 - 曲名生成路径；目录可多选，也可以多选排除；所有移动先预览，目标存在不覆盖，移动后为空的目录可以清理，支持批量撤销。 - 重复音频：按“音频完全一致 / 同一录音 / 标题、艺人、时长相近”分类；只检测，不自动删除；删除进入回收站，可以撤销。
为什么做这个
我的曲库在 NAS 上攒了很多年，标签和歌词状态很乱。试过一些工具，最大的顾虑是一键写入之后不知道改了什么，冲突被直接覆盖，出错也退不回去。
所以 Lyra 的原则是：
- 写入前备份，只改目标字段，失败自动回滚；
- 所有移动先给出新旧路径，确认后才执行；
- 删除是移入回收站，不是直接抹掉；
- 重复音频只列出来，删不删由人决定。
- 当然尽可能自动处理，引入 AI 决策能力（我个人使用 MiniMax ）
界面（测试曲库）
http://127.0.0.1:8080。用户名 admin，首次启动的随机密码在 data/initial-password.txt，登录后先改密码。
目前的限制
- 版本是 v1.0.0 ，主要在我自己的曲库上验证，边界情况还需要更多样本。
- 支持 FLAC 、MP3 、OGG Vorbis 、Opus ； OGG / Opus 的封面写入还没做。
- QQ 音乐和网易云的可用性受地区、网络影响； MusicBrainz 公共 API 每秒最多一次请求，大库建议自建镜像。
- 单管理员，没有多用户权限（似乎也不需要）。
- 不会自动整理目录，也不会自动删除重复音频（手动处理，自动风险太高）。
想听听大家的反馈
- 部署有没有卡住或者什么问题
- 歌词或标签匹配有没有明显误判；
- 重复音频的分类是否合理，有没有把不该删的放进待删除；
- 移动端布局、文档和错误提示是否清楚。
回帖或提 Issue 都行。附上版本、部署方式和错误日志即可，记得去掉密码、Token 和私人路径。
项目刚发布，欢迎试用。
觉得有用的话点个 Star 就好。
Select Language