mutagen，一个神奇的 Python 库！

大家好，我是涛哥，本文内容来自 涛哥聊Python ，转载请标原创。

大家好，今天为大家分享一个神奇的 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都能提供强大的支持，帮助开发者和音频专业人士高效地实现他们的需求。