没有标签也能识别歌曲：puddletag的AcoustID音频指纹功能完全指南

puddletag 是一款面向 GNU/Linux 的强力且简单的音频标签编辑器。它的 AcoustID 音频指纹功能，能像"听声音认人"一样，通过音频内容本身识别出没有标签的歌曲——即使文件名只有01.mp3、Artist/Title 字段全部为空，也能自动匹配出准确的歌手、专辑和曲目信息。

上图就是典型的"裸文件"场景：文件已导入 puddletag，但 Artist、Title、Album 等列全部为空白。接下来，我们将用 AcoustID 音频指纹识别功能把它们一键"补齐"。

什么是 AcoustID 音频指纹？

AcoustID 是由 AcoustID 社区维护的音乐指纹识别服务。它的原理与其他标签源（如按名称搜索的 MusicBrainz）完全不同：

1. 提取指纹：puddletag 调用 Chromaprint 引擎（即fpcalc二进制工具），从音频的声学特征中计算出一串唯一的"指纹"数据；
2. 匹配数据库：把指纹连同歌曲时长一起提交给 AcoustID 在线数据库，返回最相似的录音记录及匹配得分（Score）；
3. 拉取元数据：puddletag 再根据匹配结果从 MusicBrainz 获取完整资料（专辑、年份、曲序、流派等），进入预览模式等待你确认写入。

整个过程不依赖任何现有标签——这正是它对"无标签歌曲识别"的价值所在。相关实现见 puddlestuff/tagsources/acoust_id.py。

使用前的准备：安装 fpcalc

AcoustID 功能依赖 Chromaprint 项目提供的fpcalc可执行文件。如果系统里没有它，puddletag 在加载该标签源时会直接报错：

fpcalc not found on system

以 Ubuntu/Debian 为例，安装它只需一条命令：

apt install libchromaprint-tools

Python 侧还需要pyacoustid库（项目依赖清单 requirements.txt 中已包含）。安装完成后重启 puddletag，Windows → Tag Sources中就能在下拉框里看到AcoustID了。官方说明参见 docsrc/source/tagsources.txt 与 docsrc/download.txt。

四步完成无标签歌曲识别

第 1 步：打开标签源窗口。菜单选择Windows → Tag Sources。

第 2 步：选择 AcoustID 并选中文件。在 Source 下拉框中选择AcoustID，然后选中需要识别的文件。小技巧：高亮某个文件后按Ctrl+N可一次性选中同目录下的全部音频，适合按专辑批量识别。

第 3 步：点击 Search。puddletag 会逐文件计算指纹（日志提示Calculating ID），再向 AcoustID 发起查询（Retrieving AcoustID data）。若指纹匹配成功，还会继续从 MusicBrainz 拉取专辑资料（Retrieving MB album data）。

第 4 步：确认并写入。结果进入 Preview Mode 预览后，检查无误点击Write写入文件。

写入后，原本空白的 Artist、Title、Album、Track 等列会被自动填充：

AcoustID 关键设置详解

点击标签源窗口右上角的Configure（配置）图标，可以调整两个参数（定义见 puddlestuff/tagsources/acoust_id.py）：

指纹缓存：第二次识别更快

puddletag 会把计算出的指纹写入文件的acoustid_fingerprint标签中。之后再查询时，日志会显示Found AcoustID in file——它直接复用已有指纹，无需重新计算，整个流程明显加快。

提交数据给 AcoustID 社区（可选）

AcoustID 是社区共建的数据库。如果你愿意，可以将自己文件中的指纹和标签信息回馈给 AcoustID：

1. 在配置界面填入自己的AcoustID Key（不填会提示Please enter AcoustID user key in settings）；
2. 选中文件后，标签源窗口会出现Submit按钮（见 puddlestuff/mainwin/tagsources.py）；
3. 点击 Submit，puddletag 会按每批最多 10 条分批上传。

常见问题排查 🛠️

提示 "fpcalc not found on system"系统缺少fpcalc，安装libchromaprint-tools后重启 puddletag。

匹配得分低或查不到结果冷门歌曲、录音质量差（低码率、混音版本）都可能匹配失败。可适当调低 Minimum Score；也可以换用 MusicBrainz 标签源按"艺术家;专辑"文本方式搜索。

出现网络错误（Error retrieving data / connection failed）检查网络连接，稍后重试。puddletag 内置了请求限速，批量识别时请耐心等待，不要频繁重复点击。

AcoustID 和 MusicBrainz 结果不一致？以匹配得分（#score）高的为准，写入前在预览模式里可手动修改任意字段。

小结

现在，打开你的"裸文件"文件夹，让 puddletag 的 AcoustID 音频指纹功能为它们找回真正的身份吧。更多标签源用法可参考 docsrc/source/tut4.txt。