quodlibet/mutagen

Python module for handling audio metadata

1,955

stars

1,868

commits

Python

primary language

Aug 20, 2026

updated

mutagen.readthedocs.io
apev2
flac
id3
id3v1
id3v2
mp3
mp4
music
ogg
opus
python
tagging

README

.. image:: https://raw.githubusercontent.com/quodlibet/mutagen/main/docs/images/logo.svg
   :align: center
   :width: 400px

|

Mutagen is a Python module to handle audio metadata. It supports ASF, FLAC,
MP4, Monkey's Audio, MP3, Musepack, Ogg Opus, Ogg FLAC, Ogg Speex, Ogg Theora,
Ogg Vorbis, True Audio, WavPack, OptimFROG, and AIFF audio files. All
versions of ID3v2 are supported, and all standard ID3v2.4 frames are parsed.
It can read Xing headers to accurately calculate the bitrate and length of
MP3s. ID3 and APEv2 tags can be edited regardless of audio format. It can also
manipulate Ogg streams on an individual packet/page level.

Mutagen works with Python 3.10+ (CPython and PyPy) on Linux, Windows and macOS,
and has no dependencies outside the Python standard library. Mutagen is licensed
under `the GPL version 2 or
later <https://spdx.org/licenses/GPL-2.0-or-later.html>`__.

For more information visit https://mutagen.readthedocs.org

.. image:: https://codecov.io/gh/quodlibet/mutagen/branch/main/graph/badge.svg
  :target: https://codecov.io/gh/quodlibet/mutagen

Not written in Markdown, so it's shown here as plain text — view it formatted on GitHub.

Contributors

(top 30 of 49)

lazka

1,025 commits

joewreschnig

515 commits

BenOckmore

69 commits

phw

60 commits

quodlibet/mutagen

Python module for handling audio metadata

1,955

stars

1,868

commits

Python

primary language

Aug 20, 2026

updated

mutagen.readthedocs.io
apev2
flac
id3
id3v1
id3v2
mp3
mp4
music
ogg
opus
python
tagging

README

.. image:: https://raw.githubusercontent.com/quodlibet/mutagen/main/docs/images/logo.svg
   :align: center
   :width: 400px

|

Mutagen is a Python module to handle audio metadata. It supports ASF, FLAC,
MP4, Monkey's Audio, MP3, Musepack, Ogg Opus, Ogg FLAC, Ogg Speex, Ogg Theora,
Ogg Vorbis, True Audio, WavPack, OptimFROG, and AIFF audio files. All
versions of ID3v2 are supported, and all standard ID3v2.4 frames are parsed.
It can read Xing headers to accurately calculate the bitrate and length of
MP3s. ID3 and APEv2 tags can be edited regardless of audio format. It can also
manipulate Ogg streams on an individual packet/page level.

Mutagen works with Python 3.10+ (CPython and PyPy) on Linux, Windows and macOS,
and has no dependencies outside the Python standard library. Mutagen is licensed
under `the GPL version 2 or
later <https://spdx.org/licenses/GPL-2.0-or-later.html>`__.

For more information visit https://mutagen.readthedocs.org

.. image:: https://codecov.io/gh/quodlibet/mutagen/branch/main/graph/badge.svg
  :target: https://codecov.io/gh/quodlibet/mutagen

Not written in Markdown, so it's shown here as plain text — view it formatted on GitHub.

Contributors

(top 30 of 49)

lazka

1,025 commits

joewreschnig

515 commits

BenOckmore

69 commits

phw

60 commits

Languages

Python

99.9%