大家好，今天为大家分享一个神奇的 Python 库 – mutagen。
Github地址：https://github.com/quodlibet/mutagen?tab=readme-ov-file
Mutagen是一个用Python编写的音频元数据处理库，支持多种音频格式，包括MP3, FLAC, OGG, M4A等。它主要用于读取、修改以及操纵音频文件中的元数据信息。由于其强大的功能和简洁的API，Mutagen成为音频应用开发中处理元数据的首选库。
安装
安装Mutagen库非常简单，可以通过Python的包管理器pip进行安装：
pip install mutagen
这条命令将从Python包索引安装Mutagen库及其依赖。
特性
-
广泛的格式支持：支持包括MP3, FLAC, AAC, OGG等多种音频格式。 -
灵活的元数据操作：提供了丰富的API用于访问和修改音频文件的元数据。 -
高效的处理能力：能够快速处理大型音频文件。 -
易于使用的API：简洁明了的API，使得开发者可以轻松地集成和使用。
基本功能
Mutagen库提供了一系列基本功能，使得读取和修改音频文件的元数据变得非常直接和高效。
读取音频文件元数据
使用Mutagen读取音频文件的元数据是其最基本的功能之一，包括获取歌曲的标题、艺术家、专辑名以及其他信息。
from mutagen.mp3 import MP3
from mutagen.easyid3 import EasyID3
# 加载MP3文件
audio = MP3("example.mp3", ID3=EasyID3)
# 显示基本的音频信息
print("Track length (seconds):", audio.info.length)
print("Bitrate (bps):", audio.info.bitrate)
# 显示标签信息（使用EasyID3简化了ID3标签的访问）
print("Title:", audio['title'])
print("Artist:", audio['artist'])
print("Album:", audio['album'])
修改音频文件元数据
Mutagen不仅可以读取，还可以修改音频文件中的元数据。这对于整理和管理音乐库尤为重要。
# 修改MP3文件中的元数据
audio['title'] = "New Title"
audio['artist'] = "New Artist"
audio.save() # 保存修改
添加新的元数据标签
如果需要，还可以向音频文件添加新的元数据标签。
# 添加新的标签
if 'genre' not in audio:
audio['genre'] = "Jazz"
audio.save()
删除元数据标签
同样，Mutagen也允许从文件中删除特定的元数据标签。
# 删除元数据标签
if 'comment' in audio:
del audio['comment']
audio.save()
错误处理
处理读取或修改元数据时可能出现的错误是基本功能的重要部分。
try:
audio = MP3("path/to/invalid/file.mp3")
print(audio['title'])
except IOError:
print("Cannot open file!")
except KeyError:
print("Tag not found!")
高级功能
Mutagen库提供了一些高级功能，允许用户处理更复杂的音频元数据任务，包括处理多标签文件、访问和修改原始帧数据，以及使用高级查询和过滤技术。
处理多标签文件
一些音频文件格式支持多个标签。使用Mutagen，可以访问和管理这些不同的标签集。
from mutagen.flac import FLAC, Picture
# 加载FLAC文件
audio = FLAC("example.flac")
# 添加封面图像
image = Picture()
image.type = 3 # Cover (front)
image.mime = "image/jpeg"
image.width = 500
image.height = 500
image.depth = 24
image.data = open("cover.jpg", "rb").read()
audio.add_picture(image)
audio.save()
访问和修改原始帧数据
Mutagen允许用户直接访问和修改音频文件的帧级数据，这对于需要进行低级文件操作的高级应用非常有用。
from mutagen.mp3 import MP3
from mutagen.id3 import ID3, APIC, error
# 加载MP3文件，并尝试访问ID3标签
audio = MP3("example.mp3", ID3=ID3)
try:
# 添加专辑封面
audio.tags.add(
APIC(
encoding=3, # UTF-8
mime='image/jpeg',
type=3, # 封面图像
desc='Cover',
data=open('cover.jpg', 'rb').read()
)
)
audio.save()
except error as e:
print("Error modifying the file:", e)
使用高级查询和过滤
Mutagen允许进行复杂的查询和过滤操作，使得用户可以基于详细的标准来检索和修改音频文件。
# 假设我们有一个目录包含多个音频文件，我们想找出所有2000年后发布的专辑
from mutagen.easyid3 import EasyID3
import os
directory = "/path/to/music/"
for filename in os.listdir(directory):
if filename.endswith(".mp3"):
path = os.path.join(directory, filename)
audio = EasyID3(path)
try:
if int(audio.get('date', [0])[0]) > 2000:
print(f"Album {audio['album']} from {audio['date']} found.")
except ValueError:
continue
总结
Python的Mutagen库是一个强大且灵活的音频元数据处理工具，支持广泛的音频格式，如MP3、FLAC、AAC和OGG等。它使得读取、修改和管理音频文件中的元数据变得非常简单直接。Mutagen提供了丰富的API，不仅支持基本的元数据操作，如读取、添加和修改标签，还包括更高级的功能，如处理复杂的多标签文件和直接修改音频帧数据。无论是开发音乐播放器、音乐库管理系统还是专业的音频编辑软件，Mutagen都能提供强大的支持，帮助开发者和音频专业人士高效地实现他们的需求。
