Music Tag Web

Music Tag Web

一款开源的 Web 音乐标签编辑器,能直接编辑服务器或本机上的音频元数据,适用于管理 Navidrome 等音乐服务器的场景,具备批量编辑、音乐指纹识别、歌词与封面管理、格式转换、整轨切割、简繁转换、文本替换、操作记录以及移动端适配等功能。

#Ai工具箱 #Ai开源项目
收藏

Music Tag Web简介

Music Tag Web是什么

Music Tag Web 是一款开源的 Web 音乐标签编辑器,能直接编辑服务器或本机上的音频元数据,适用于管理 Navidrome 等音乐服务器的场景。它支持包括 FLAC、APE、WAV、aiFF、WV、TTA、MP3、M4A、OGG、MPC、OPUS、WMA、DSF、DFF、MP4 等多种格式,具备批量编辑、音乐指纹识别、歌词与封面管理、格式转换、整轨切割、简繁转换、文本替换、操作记录以及移动端适配等功能。该项目后端采用 Python + Django,前端使用 Vue,其镜像托管在 Docker Hub(xhongc/music_tag_web:latest)。

Music Tag Web


Music Tag Web核心功能

  • 标签编辑

  • 基础标签:涵盖歌曲名、歌手、专辑、发行年份、流派、曲目序号、封面图片。

  • 高级标签:包含歌词嵌入、作曲家、编曲、版权信息、唱片公司。

  • 批量处理:支持批量导入多个音频文件,统一修改标签规则,比如批量添加专辑名、统一封面,从而提高效率。

  • 格式兼容性:支持常见的音频格式,如 MP3、FLAC、AAC、WAV、OGG、APE 等。部分工具能够读取和写入不同格式的标签标准,例如 ID3v1、ID3v2、Vorbis Comment。

  • 封面管理:可以上传本地图片作为专辑封面,还能进行裁剪、缩放操作,保证封面与音频匹配。

  • 导出与保存:编辑完成后,能直接下载修改后的音频文件,也可以将标签信息导出为文本(如 CSV)进行备份。

Music Tag Web使用方法

先上传音乐,接着在左侧目录树勾选文件夹。然后在右侧点击“自动刮削”,选择“宽松模式”“全部源”“覆盖旧标签”,最后保存。对于红色显示的失败条目,需要手动修改,输入正确的专辑或歌手,进行搜索,点击匹配结果后保存。还可以一键整理,点击顶部“整理文件”,选择模板 artist/{album}/track{title} 后执行。

快速部署

# 1. 创建目录(音乐库+配置)
mkdir -p /volume1/music /volume1/docker/music-tag
# 2. 启动容器(端口 8002,镜像约 300 MB)
docker run -d --name music-tag-web \
  -p 8002:8002 \
  -v /volume1/music:/app/media:rw \
  -v /volume1/docker/music-tag:/app/data \
  --restart unless-stopped \
  xhongc/music_tag_web:latest

浏览器访问 http://NAS-IP:8002,默认账号/密码 admin/admin 即可开始刮削。

想升级或回滚,直接 docker pull xhongc/music_tag_web:latest 然后重新创建容器即可;配置与音乐文件都在宿主机映射目录,不会丢失。

Music Tag Web应用场景

  • 个人音乐库整理:把零散下载的歌曲统一编辑标签,便于播放器分类检索。

  • 自媒体 / 播客制作:为原创音频添加标题、作者、封面,满足平台上传要求。

  • 音乐爱好者分享:整理无损音乐专辑时,完善标签信息,提升分享体验。

常见问题

  • 端口冲突:修改参数为 -p 8011:8002 即可。

  • 中文乱码:先“清除所有标签”,再重新刮削;或者把 ID3 编码设为 UTF - 8。

  • 整轨无法分轨:确认同目录下有对应的 .cue 文件,上传后点击“分割”按钮。

  • 外网访问:在路由器上做 8002 端口映射,或者采用反向代理、内网穿透的方式。

Music Tag Web相关资源

  • 源码/文档/更新日志:https://github.com/xhongc/music-tag-web

  • 在线 Demo:https://xiers-organization.gitbook.io/music-tag-web-v2

到头啦!

与Music Tag Web相关工具