介绍

Mutagen是处理音频元数据的Python模块。它支持ASF，FLAC，MP4，Monkey's Audio，MP3，Musepack，Ogg Opus，Ogg FLAC，Ogg Speex，Ogg Theora，Ogg Vorbis，True Audio，WavPack，OptimFROG和AIFF音频文件。支持所有版本的ID3v2，并解析所有标准的ID3v2.4帧。它可以读取Xing标头，以准确计算MP3的比特率和长度。无论音频格式如何，都可以编辑ID3和APEv2标签。它还可以在单个数据包/页面级别上处理Ogg流。

Mutagen可在Linux，Windows和macOS上使用Python 3.6+（CPython和PyPy），并且在Python标准库之外没有任何依赖关系。

特点

与大多数处理标签的程序相比，Quod Libet对标签库的要求更高。因此，我们认为有必要自己编写。

Mutagen有一个简单的API，在所有标记格式和版本中都大致相同，并且已集成到Python的内置类型和接口中。

可以轻松添加新的帧类型和文件格式，并且可以通过扩展它们来更改当前格式的行为。

从一开始就考虑了*格式键，多个值，Unicode和其他高级功能，并且完全支持它们。

涵盖了所有ID3v2版本和所有ID3v2.4框架，包括诸如POPM或RVA2之类的稀有版本。

我们非常重视自动化测试。所有错误修复均通过防止重复发生的测试提交，而新功能则通过完整的测试套件提交。

安装

python3 -m pip install mutagen 或者下载mutagen的ZIP源文件包。

实例

该File函数获取任何音频文件，猜测其类型并返回 FileType实例或None。

>>> import mutagen
>>> mutagen.File("11. The Way It Is.ogg")
{'album': [u'Always Outnumbered, Never Outgunned'],
 'title': [u'The Way It Is'], 'artist': [u'The Prodigy'],
 'tracktotal': [u'12'], 'albumartist': [u'The Prodigy'],'date': [u'2004'],
 'tracknumber': [u'11'],
>>> _.info.pprint()
u'Ogg Vorbis, 346.43 seconds, 499821 bps'
>>>

以下代码加载一个FLAC文件，设置其标题，打印所有标签数据，然后保存该文件。

from mutagen.flac import FLAC

audio = FLAC("example.flac")
audio["title"] = u"An example"
audio.pprint()
audio.save()

下面的示例获取MP3文件的长度和比特率。

from mutagen.mp3 import MP3

audio = MP3("example.mp3")
print(audio.info.length)
print(audio.info.bitrate)

以下内容从MP3文件中删除ID3标签。

from mutagen.id3 import ID3

audio = ID3("example.mp3")
audio.delete()

在这里，我们将Vorbis文件解析为FLAC，这导致文件MutagenError被引发。

>>> import mutagen.flac
>>> mutagen.flac.FLAC("11. The Way It Is.ogg")
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "/usr/lib/python2.7/dist-packages/mutagen/_file.py", line 42, in __init__
    self.load(filename, *args, **kwargs)
  File "/usr/lib/python2.7/dist-packages/mutagen/flac.py", line 759, in load
    self.__check_header(fileobj)
  File "/usr/lib/python2.7/dist-packages/mutagen/flac.py", line 867, in __check_header
    "%r is not a valid FLAC file" % fileobj.name)
mutagen.flac.FLACNoHeaderError: '11. The Way It Is.ogg' is not a valid FLAC file