Tagger v1.0.1 — 首个公开版本

Tagger v1.0.1 — 首个公开版本

Tagger 是一个面向个人音乐档案的本地元数据工作台，用于浏览、匹配、审核并安全地修改音乐文件标签。

这是 Tagger 的首个公开发行版本。

核心能力

• 浏览和编辑 MP3、FLAC、WAV 的标签、歌词、封面及技术信息。
• 支持标题、艺术家、专辑、专辑艺术家、音轨号、年份、风格、BPM、ISRC、MusicBrainz ID 等常用字段。
• 管理多个本地音乐库，并通过目录、格式、状态和关键词筛选曲目。
• 使用服务端分页浏览大型曲库，避免一次性将所有曲目载入浏览器。
• 文件变更实时索引，并通过任务中心展示扫描、匹配和写入进度。
• 提供跨页面音频预览、响应式界面、主题和字体设置。

多数据源匹配

Tagger 可以从多个数据源查询标签、歌词和封面候选：

• MusicBrainz
• LRCLIB
• Apple / iTunes
• 网易云音乐
• 酷我音乐
• 酷狗音乐
• 可自行部署的 LrcApi

候选结果不会直接覆盖文件。你可以查看本地值与候选值的差异，逐字段选择需要采用的内容，再创建写入任务。

标签兼容性

首个版本内置针对播放器和媒体服务器的标签兼容性检查：

• 音频标签与文件名、目录推断结果完全分离。
• 文件名推断只作为可选提示，不会自动写入文件。
• 检查缺少标题、艺术家、专辑和专辑艺术家等问题。
• 检测“专辑艺术家疑似写成专辑名”等异常值。
• MP3 写入使用并验证 TIT2、TPE1、TALB、TPE2 等标准 ID3 字段。
• 改善 Navidrome 等媒体服务器对艺术家和专辑信息的识别。

安全写入与历史恢复

• 写入前检查文件 revision，防止覆盖外部修改。
• 在临时副本上写入并重新读取验证。
• 验证通过后再原子替换原文件。
• 保存字段差异、标签快照和封面历史。
• 支持预览并恢复历史版本。
• 批量任务支持取消、失败项重试和服务重启恢复。

下载与运行

Release 发布后将自动生成 Linux x86_64 二进制：

• tagger_1.0.1_linux_amd64.tar.gz
• 对应的 SHA-256 校验文件

同时提供 linux/amd64 和 linux/arm64 Docker 镜像：

docker pull ghcr.io/ericwyn/tagger:1.0.1

也可以使用：

docker pull ghcr.io/ericwyn/tagger:latest

容器支持通过以下环境变量配置：

• TAGGER_MUSIC_DIR
• TAGGER_DATA_DIR
• TAGGER_LISTEN
• TAGGER_AUTH_TOKEN