LyricBridge

把播放器、在线歌词源和本地歌词库连接起来的轻量服务。

聚合搜索、持久缓存、手动管理和元数据写入都在一个 Flask 服务里完成,接口保持简单,部署也足够直接。

播放器
LyricBridge
歌词源
[00:12.320] 静默缓存命中 [00:17.480] 手动歌词优先返回 [00:22.900] JSON / LRC 双接口输出
manual 本地优先
cache 自动持久化
api 聚合检索
01

聚合歌词

按歌名、歌手、专辑从多个来源检索歌词,文本接口和 JSON 接口都可直接接入播放器。

02

本地持久化

手动歌词优先返回,上游结果自动落入 cache,可设置容量、保留时间和清理周期。

03

管理后台

在浏览器中预览、上传、编辑、下载和删除歌词文件,不需要直接进入服务器目录操作。

快速启动

Python 源码和 Docker 都可以运行。启用鉴权后,本地写入、上传和删除接口才会开放。

Docker
docker run -d \
  -p 28883:28883 \
  -v /home/user/music:/music \
  -v ./appdata:/app/appdata \
  -e API_AUTH=your-secret \
  hisatri/lyricbridge:latest
Python
pip install -r requirements.txt
python3 app.py --port 28883 --auth your-secret

接口保持简单

兼容原有路径,部署后即可接入 StreamMusic、Navidrome 周边工具或你自己的播放器。