Python3使用Mutagen处理音频元数据完整指南

Noah
Noah
发布时间:2026-10-16| 6人浏览过
原创

本文介绍如何在Python 3.9环境下使用Mutagen库处理音频元数据。内容涵盖在线与离线安装方法,以及获取、修改、删除音频标签和提取音频属性(如时长、码率)的基础代码示例,适用于Linux、Windows及macOS系统。

本文基于Python 3.9版本进行演示。

所使用的Mutagen库版本为1.46.0。

Mutagen是一个纯Python编写的音频元数据处理模块,支持多种音频格式。该库仅依赖Python标准库,无需额外第三方依赖,兼容Python 3.7及以上版本,并支持Linux、Windows和macOS操作系统。

项目GitHub仓库地址:https://github.com/quodlibet/mutagen

官方帮助文档地址:https://mutagen.readthedocs.io/en/latest/

PyPI项目页面地址:https://pypi.org/project/mutagen/

一、安装

1、在线安装

可通过pip命令直接进行安装。

pip install mutagen

上述命令默认会安装最新版本的Mutagen。

2、离线安装

2.1 下载离线安装文件

用户可前往PyPI页面下载源代码包或whl文件。

2.2 执行离线安装操作

1) 使用源码进行安装

tar zxf mutagen-1.46.0.tar.gz
cd mutagen-1.46.0
python setup.py install

2)也可通过pip install命令指定whl文件进行离线安装。

pip install mutagen-1.46.0-py3-none-any.whl

二、基础用法

1、获取音频文件元数据

import mutagen
f = mutagen.File(r"d:\tmp\1.mp3")
f.values()
f.pprint().split('\n')
print(f.get('TXXX:Band').text)

运行效果如下所示。

2、添加(修改)音频元数据

若标签不存在则执行添加操作,若已存在则执行修改操作。

具体示例代码如下。

from mutagen.id3 import TALB
f.tags.add(TALB(encoding=0, text=['some_album']))
f.save()

3、删除音频元数据

可通过调用.tags.pop方法实现删除。

import mutagen
f = mutagen.File(r"d:\tmp\1.mp3")
f.tags.values()
f.tags.pop('TXXX:Band')
f.save()
f.tags.values()

运行效果如下所示。

4、获取音频属性

此功能用于获取音频时长、码率、声道信息等属性。

具体示例代码如下。

f.info.pprint()
print(f.info.sample_rate)
print(f.info.channels)
print(f.info.length) # seconds
print(278//60,278%60)

三、资源下载

本文涉及的源代码及安装文件,可通过百度网盘获取。

链接: https://pan.baidu.com/s/1P4dOBdW6fH-iuI-jPyGarQ?pwd=wbkg

提取码: wbkg

至此,关于Python3使用Mutagen进行音频元数据处理的介绍已完成。如需了解更多Python3音频元数据处理相关内容,建议查阅本站往期文章或继续阅读后续文章,感谢支持。

相关标签:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。