使用 eyed3 从 mp3 文件名获取歌曲名设置 ID3 属性

需求

近期有朋友拜托弄一批 mp3 放 U 盘里面以便开车的时候听，于是下载了一批歌曲，都整理成 歌曲名-歌唱者.mp3 这样的文件名。可是有些播放器会优先使用 ID3（即 mp3 文件的一个自带的信息段。顺便吐槽一下，官方网站 https://id3.org 居然打不开，提示 500 错误？！）来罗列歌单，而不是文件名，这些 mp3 本身的 ID3 属性良莠不齐，到时候就乱套了。因此需要逐个将文件名上面的歌曲、歌者信息写入 mp3 文件的 ID3 属性内。

实战

此类日常事务，最方便的自然是 python 了。查了一下，python 下的音频文件处理模块有 eyed3、pydub、pyAudio 等。其中的 eyed3 最为小巧便捷。完整代码如下

import  os
import eyed3def main(path):files= os.listdir(path)counter = 0for mp3 in files:if mp3[-3:] != 'mp3' :continuetitle, artist = get_title_artist_from_filename(mp3)# 调用 eyed3 模块，写入歌曲信息try:audio = eyed3.load(path + '/' + mp3)print(f'[eyed3] load {mp3} success,', end=' ')except:print(f'[error] {mp3} load fail!')continueif(audio.tag == None): # 部分歌曲 ID3 信息缺失audio.tag = eyed3.id3.tag.Tag()audio.tag.title = titleaudio.tag.artist = artistprint(f'ready to write ID3: {title} {artist}')audio.tag.save(version=eyed3.id3.ID3_V2_4, encoding = "utf8") # 指定使用 ID3 V2.4，确保支持中文，ref: ..\lib\site-packages\eyed3\id3counter += 1print(f'共处理了 {counter} 个 mp3 文件')def get_title_artist_from_filename(filename):'''通过文件名获取歌曲信息，文件名样式：歌曲名 - 歌唱人员.mp3'''prefix = filename.split('.')[0]msg = prefix.split('-') title = msg[0].strip()artist = msg[1].strip()return (title, artist)if __name__ == '__main__':mp3 = 'd:/temp/经典老歌'main(mp3)

踩坑

这里最大的坑有两个：

低版本 ID3 不支持 unicode，导致写入的中文会变成一串的 ?
部分歌曲本身不带 ID3 属性，此时需要自行添加之。

下面逐一解释

指定 ID3 版本

有些歌曲自带的 ID3 属性是 v1.0 版本的，只支持英文字母，强行写入中文会导致乱码，或者干脆显示成一串的 ?????。

解决这个问题的办法，就在 eyed3.id3.tag.Tag.save()里面，官方文档说，给 save() 函数加上 version=... 的参数，确保使用高版本的 ID3 就可以支持 unicode。可是文档到这里就没了，也没告诉我这个版本具体要怎么指定。

没办法，只能打开下载的 eyed3 源代码，找到函数定义，发现 ID3 版本号都定义在 site_packages\eyed3\id3\__init__.py 里面，直接取用即可。如下

# Version 1, 1.0 or 1.1
ID3_V1 = (1, None, None)
# Version 1.0, specifically
ID3_V1_0 = (1, 0, 0)
# Version 1.1, specifically
ID3_V1_1 = (1, 1, 0)
# Version 2, 2.2, 2.3 or 2.4
ID3_V2 = (2, None, None)
# Version 2.2, specifically
ID3_V2_2 = (2, 2, 0)
# Version 2.3, specifically
ID3_V2_3 = (2, 3, 0)
# Version 2.4, specifically
ID3_V2_4 = (2, 4, 0)

因此我们使用 tag.save(version=eyed3.id3.ID3_V2_4, encoding = "utf8") 即可确保中文不乱码。

添加 ID3 属性

有些 mp3 文件本身不自带 ID3 属性，此时 eyed3 调用 tag 属性就会出错。

运行一个 python 的交互界面，手动生成一个 eyed3 对象，检查 __dict__ 属性，大致如下：

>>> import eyed3
>>> a = eyed3.load('d:/temp/a/q.mp3')
>>> a.__dict__
{'_tag_version': None, 
'_path': 'd:\\temp\\a\\q.mp3', 
'type': 1, 
'_info': Mp3AudioInfo(time_secs=316.78, size_bytes=5056888), 
'_tag': None}