cross-platform, Python audio metadata ("tagging") library based on TagLib

These details have not been verified by PyPI

Project links

Project description

pytaglib

pytaglib is a Python audio tagging library. It is cross-platform and very simple to use yet fully featured:

supports more than a dozen file formats including mp3, flac, ogg, wma, and mp4,
support arbitrary, non-standard tag names,
support multiple values per tag.

pytaglib is a very thin wrapper around the fast and rock-solid TagLib C++ library.

News

2025-11-17 pytaglib-3.1.0 has been released.

build wheels for recent Python versions (up to 3.14)
build wheels for PyPy again
bump bundled taglib (in wheels) to v2.1.1

For a full list of changes in this and previous releases, see the Changelog.

Install

Use your favorite Python package manager to install the pytaglib package. Example when using pip:

    pip install pytaglib

In most cases, this should pick a provided binary wheel that bundles the native TagLib library suitable for your platform. If it doesn't, and the installation fails, see below.

Usage

>>> import taglib
>>> with taglib.File("/path/to/my/file.mp3", save_on_exit=True) as song:
>>>     song.tags
{'ARTIST': ['piman', 'jzig'], 'ALBUM': ['Quod Libet Test Data'], 'TITLE': ['Silence'], 'GENRE': ['Silence'], 'TRACKNUMBER': ['02/10'], 'DATE': ['2004']}

>>>     song.length
239
>>>     song.tags["ALBUM"] = ["White Album"] # always use lists, even for single values
>>>     del song.tags["DATE"]
>>>     song.tags["GENRE"] = ["Vocal", "Classical"]
>>>     song.tags["PERFORMER:HARPSICHORD"] = ["Ton Koopman"]
>>> # with save_on_exit=True, file will be saved at the end of the 'with' block

For detailed API documentation, use the docstrings of the taglib.File class or view the source code directly.

`pyprinttags`

This package also installs the pyprinttags script. It takes one or more files as command-line parameters and will display all known metadata of that files on the terminal. If unsupported tags (a.k.a. non-textual information) are found, they can optionally be removed from the file.

Installation Notes

Things are a bit more complicated than usual with Python because pytaglib requires the native (C++) TagLib library.

If there are no binary wheels for your platform, or you want to manually compile pytaglib, you will need to have Taglib installed with development headers, and also development tools for Python.

On Ubuntu, Mint and other Debian-Based distributions, install the libtag1-dev and python-dev packages. On Fedora and friends, these are called taglib-devel and python-devel, respectively. On a Mac, use HomeBrew to install the taglib package. For Windows, see below.

As an alternative, run python build_native_taglib.py in this directory to automatically download and build the latest Taglib version into the lib/taglib-cpp subdirectory (also works on Windows).

This requires Python and a suitable compiler to be installed; specific instructions are beyond the scope of this README.

Linux: Distribution-Specific Packages

Debian- and Ubuntu-based linux flavors have binary packages for the Python 3 version, called python3-taglib. Unfortunatelly, they are heavily outdated, so you should instally the recent version via pip whenever possible.
For Arch users, there is a package in the user repository (AUR).

Manual Compilation: General

To create a binary wheel for your platform, use any PEP-517 compatible build frontend. Example using build:

    python -m build

or with uv:

    uv build

which will place the wheel inside the dist directory.

Compilation: Windows

Install MS Visual Studio Build Tools (or the complete IE) and include the correct compiler version as detailed here. Also enable cmake in the Visual Studio Installer.

Then:

open the VS native tools command prompt
navigate to the pytaglib repository
run python build_native_taglib.py which will download and build the latest official TagLib release
run python setup.py install

Development

To start hacking (contributions welcome!), clone the repository and set up a project environment with your favorite tool. I use uv, where you should need only two commands for most workflows:

# set up virtual environment, run cythonize, compile
$ uv sync --reinstall

# run tests
$ uv run pytest

Contact

For bug reports or feature requests, please use the issue tracker on GitHub. For anything else, contact me by email.

Project details

These details have not been verified by PyPI

Project links

Release history Release notifications | RSS feed

This version

3.1.0

Nov 19, 2025

3.0.1

Mar 21, 2025

3.0.0

Mar 17, 2024

2.1.0

Nov 17, 2023

2.0.0

Mar 26, 2023

1.5.0

Dec 18, 2021

1.4.6

Feb 26, 2020

1.4.5

Mar 26, 2019

1.4.4

Oct 27, 2018

1.4.3

Feb 25, 2018

1.4.2

Jan 17, 2018

1.4.1

May 12, 2017

1.4.0

Nov 26, 2016

1.3.0

Jul 21, 2016

1.2.1

Jul 17, 2016

1.2.0

Mar 20, 2016

1.1.0

Sep 6, 2015

1.0.3

Mar 16, 2015

1.0.2

Mar 15, 2015

1.0.1

Mar 9, 2015

1.0.0

Jan 3, 2015

0.4.1

Apr 3, 2014

0.4

Mar 29, 2014

0.3.7

Jan 21, 2014

0.3.6

Aug 13, 2013

0.3.5

Apr 3, 2013

0.3.4

Jan 16, 2013

0.3.3

Jan 16, 2013

0.3.2

Jan 12, 2013

0.3.1

Jan 7, 2013

0.3.0

Dec 14, 2012

0.2.5

Dec 5, 2012

0.2.4

Sep 9, 2012

0.2.2

Jul 25, 2012

0.0.0

Jul 25, 2012

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pytaglib-3.1.0.tar.gz (511.3 kB view details)

Uploaded Nov 19, 2025 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

pytaglib-3.1.0-pp311-pypy311_pp73-win_amd64.whl (259.7 kB view details)

Uploaded Nov 19, 2025 PyPyWindows x86-64

pytaglib-3.1.0-pp311-pypy311_pp73-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (1.3 MB view details)

Uploaded Nov 19, 2025 PyPymanylinux: glibc 2.24+ x86-64manylinux: glibc 2.28+ x86-64

pytaglib-3.1.0-pp311-pypy311_pp73-macosx_11_0_arm64.whl (793.8 kB view details)

Uploaded Nov 19, 2025 PyPymacOS 11.0+ ARM64

pytaglib-3.1.0-cp314-cp314t-win_amd64.whl (276.7 kB view details)

Uploaded Nov 19, 2025 CPython 3.14tWindows x86-64

pytaglib-3.1.0-cp314-cp314t-musllinux_1_2_x86_64.whl (2.9 MB view details)

Uploaded Nov 19, 2025 CPython 3.14tmusllinux: musl 1.2+ x86-64

pytaglib-3.1.0-cp314-cp314t-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (1.9 MB view details)

Uploaded Nov 19, 2025 CPython 3.14tmanylinux: glibc 2.24+ x86-64manylinux: glibc 2.28+ x86-64

pytaglib-3.1.0-cp314-cp314t-macosx_11_0_arm64.whl (802.5 kB view details)

Uploaded Nov 19, 2025 CPython 3.14tmacOS 11.0+ ARM64

pytaglib-3.1.0-cp314-cp314-win_amd64.whl (271.0 kB view details)

Uploaded Nov 19, 2025 CPython 3.14Windows x86-64

pytaglib-3.1.0-cp314-cp314-musllinux_1_2_x86_64.whl (2.9 MB view details)

Uploaded Nov 19, 2025 CPython 3.14musllinux: musl 1.2+ x86-64

pytaglib-3.1.0-cp314-cp314-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (1.8 MB view details)

Uploaded Nov 19, 2025 CPython 3.14manylinux: glibc 2.24+ x86-64manylinux: glibc 2.28+ x86-64

pytaglib-3.1.0-cp314-cp314-macosx_11_0_arm64.whl (799.9 kB view details)

Uploaded Nov 19, 2025 CPython 3.14macOS 11.0+ ARM64

pytaglib-3.1.0-cp313-cp313-win_amd64.whl (262.8 kB view details)

Uploaded Nov 19, 2025 CPython 3.13Windows x86-64

pytaglib-3.1.0-cp313-cp313-musllinux_1_2_x86_64.whl (2.9 MB view details)

Uploaded Nov 19, 2025 CPython 3.13musllinux: musl 1.2+ x86-64

pytaglib-3.1.0-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (1.8 MB view details)

Uploaded Nov 19, 2025 CPython 3.13manylinux: glibc 2.24+ x86-64manylinux: glibc 2.28+ x86-64

pytaglib-3.1.0-cp313-cp313-macosx_11_0_arm64.whl (799.5 kB view details)

Uploaded Nov 19, 2025 CPython 3.13macOS 11.0+ ARM64

pytaglib-3.1.0-cp312-cp312-win_amd64.whl (263.0 kB view details)

Uploaded Nov 19, 2025 CPython 3.12Windows x86-64

pytaglib-3.1.0-cp312-cp312-musllinux_1_2_x86_64.whl (2.9 MB view details)

Uploaded Nov 19, 2025 CPython 3.12musllinux: musl 1.2+ x86-64

pytaglib-3.1.0-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (1.8 MB view details)

Uploaded Nov 19, 2025 CPython 3.12manylinux: glibc 2.24+ x86-64manylinux: glibc 2.28+ x86-64

pytaglib-3.1.0-cp312-cp312-macosx_11_0_arm64.whl (800.2 kB view details)

Uploaded Nov 19, 2025 CPython 3.12macOS 11.0+ ARM64

pytaglib-3.1.0-cp311-cp311-win_amd64.whl (262.4 kB view details)

Uploaded Nov 19, 2025 CPython 3.11Windows x86-64

pytaglib-3.1.0-cp311-cp311-musllinux_1_2_x86_64.whl (2.9 MB view details)

Uploaded Nov 19, 2025 CPython 3.11musllinux: musl 1.2+ x86-64

pytaglib-3.1.0-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (1.8 MB view details)

Uploaded Nov 19, 2025 CPython 3.11manylinux: glibc 2.24+ x86-64manylinux: glibc 2.28+ x86-64

pytaglib-3.1.0-cp311-cp311-macosx_11_0_arm64.whl (741.0 kB view details)

Uploaded Nov 19, 2025 CPython 3.11macOS 11.0+ ARM64

pytaglib-3.1.0-cp310-cp310-win_amd64.whl (262.3 kB view details)

Uploaded Nov 19, 2025 CPython 3.10Windows x86-64

pytaglib-3.1.0-cp310-cp310-musllinux_1_2_x86_64.whl (2.8 MB view details)

Uploaded Nov 19, 2025 CPython 3.10musllinux: musl 1.2+ x86-64

pytaglib-3.1.0-cp310-cp310-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (1.8 MB view details)

Uploaded Nov 19, 2025 CPython 3.10manylinux: glibc 2.24+ x86-64manylinux: glibc 2.28+ x86-64

pytaglib-3.1.0-cp310-cp310-macosx_11_0_arm64.whl (800.3 kB view details)

Uploaded Nov 19, 2025 CPython 3.10macOS 11.0+ ARM64

pytaglib-3.1.0-cp39-cp39-win_amd64.whl (262.7 kB view details)

Uploaded Nov 19, 2025 CPython 3.9Windows x86-64

pytaglib-3.1.0-cp39-cp39-musllinux_1_2_x86_64.whl (2.8 MB view details)

Uploaded Nov 19, 2025 CPython 3.9musllinux: musl 1.2+ x86-64

pytaglib-3.1.0-cp39-cp39-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (1.8 MB view details)

Uploaded Nov 19, 2025 CPython 3.9manylinux: glibc 2.24+ x86-64manylinux: glibc 2.28+ x86-64

pytaglib-3.1.0-cp39-cp39-macosx_11_0_arm64.whl (800.6 kB view details)

Uploaded Nov 19, 2025 CPython 3.9macOS 11.0+ ARM64

File details

Details for the file pytaglib-3.1.0.tar.gz.

File metadata

Download URL: pytaglib-3.1.0.tar.gz
Upload date: Nov 19, 2025
Size: 511.3 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for pytaglib-3.1.0.tar.gz
Algorithm	Hash digest
SHA256	`42447797fc7019d7f007ed4d6ef46650310e382a8920508d56262eb93e0e79d6`
MD5	`ef637be7d563c81da6e2e2293b0f293d`
BLAKE2b-256	`c3478c191b92368d853a63ddda3fb13e4556458a0f22b7bbbbdbc91db59b7206`

Algorithm	Hash digest
SHA256	`4c2d79bb0cb03e538a2d904b71f3b1eb727ce34d606b8daea15faf71e1a74ac2`
MD5	`a16d5c4a59fead2b988683b05aaba568`
BLAKE2b-256	`40825d5476f9dfad232a7b5ad5872de134777bd271faab56ec6da0728f138c70`

Algorithm	Hash digest
SHA256	`26e3b2b55224b3e630bba3aa6958740e6b5f9fe40c0052965a13fbe6a9015c32`
MD5	`5d6cc9331dfa9b01af96262d8696e4b4`
BLAKE2b-256	`bce89d9065ffa13e9bdbd853d54584e526ebb109c98388a5baa439d17a274ff5`

Algorithm	Hash digest
SHA256	`58b3adc0439f3e8e9411ef57b7bd96c8873042174494217717ebda166baf5ab1`
MD5	`d717a8bcd972215bdc64d6a87dbafd87`
BLAKE2b-256	`112edb464ee3d4f57ae51cd34ddc411a89c932d814ffd436003df3a49a9bd87d`

Algorithm	Hash digest
SHA256	`157811dce2523e6f37c1dc3cc2c2606354ace44b90577d266451965ba8f16223`
MD5	`c87742f4a933d2462a6e68d39acba9d0`
BLAKE2b-256	`d4a0150f2191b50a943445858219701c206a993896b6efadbd96aa2347ad2d45`

Algorithm	Hash digest
SHA256	`d28566068a4ee39864e08da6f5b9717d9ee2fe084cd6a3ffa9dd165a99891da2`
MD5	`e5dc60d55025de443453e3c80f681325`
BLAKE2b-256	`33c67999c3f04c0c2147b207e7a962d851a770b96c8080a220915538f8c287c8`

Algorithm	Hash digest
SHA256	`7f261af6c47a8d923bec1329a04d64d94c79f23eb86f8f58eae0c132b311d192`
MD5	`9001e091e0bbf03b6b094a0d704ba8b1`
BLAKE2b-256	`2bba0127f98c7105d5e1290e8a25c9ab1a94fa66db88770216038bebb2cc9442`

Algorithm	Hash digest
SHA256	`1878f4371427f2dc6fc849645bc316ecd3ab13f2aa9d3be2781ad0d57d313440`
MD5	`c5accd67acf939b9661396d98f1ac7bc`
BLAKE2b-256	`236cbd6ce628c027997a6059ff45d01552c1776811282a8452f22281b354a6ad`

Algorithm	Hash digest
SHA256	`f8a312de13b898e91f1a72c585eab996f2614e24352b6eca2807e07ac9811250`
MD5	`610223ec9f0a6dbac2f285e35a1608ef`
BLAKE2b-256	`6ebde9849aa333654a3080262a2046e433d31c870ae0169aae1523a181d99c7e`

Algorithm	Hash digest
SHA256	`202e16709d3c6f67d271c1138034a8d95716853252cc9222ac8b98b6f4e9d243`
MD5	`624dce63c0ca808017bc6366b27dcfe4`
BLAKE2b-256	`c82f4b54fa9e8f0a49512cd4e830db96a2063d67979d03e662839306c9c3b9ff`

Algorithm	Hash digest
SHA256	`96c378342fc11976ade773e07d4054ed0e34b10968125a31338544bae799aad7`
MD5	`697868b13c1ecbf2a8f4c434dd15d370`
BLAKE2b-256	`8e94e687af0a228baf7108267a11e4d4cb0662c35fd72244ccb3fb88791ad0bf`

Algorithm	Hash digest
SHA256	`1f3503eef78034c0e9f630637c3f591b58390c41ac55e58a2e1688d8779d5bc7`
MD5	`e3e0269234fd35066167adfe98ef7f93`
BLAKE2b-256	`c0789ba99907289f89bf01099f6e94014446872ba96728ddf1445522e5f34c74`

Algorithm	Hash digest
SHA256	`fe16dd56b5bd7364481fa5b3b989af291f9f6519466843becef7c4649294d7cf`
MD5	`dadd9dbb78078f02304a1e10723c38e0`
BLAKE2b-256	`6e45b9ffb54812b4017de0c627c29d26d7afdbe9327653da11c6883b7cdcb83e`

Algorithm	Hash digest
SHA256	`7e36de34055d27ab6295e1e18321e2c34cd0f110cc788da092da694c88c2f678`
MD5	`8fa5362fb95496484f9e1d3dc0c2d91c`
BLAKE2b-256	`70c3e540c6a6dbf61a1183edfa838f8068ee080b23aa8e7e597a526ece5b3650`

Algorithm	Hash digest
SHA256	`991162647e94c857ff18340e49b75100d52056aadd0cd3583c97da119404cc46`
MD5	`0b6c79ff5e46644b7b936caf9d61abc2`
BLAKE2b-256	`afec34a6e1965bf1ffdb9600a5e0283c2ff6da351f923b506ce8dd52b34edb50`

Algorithm	Hash digest
SHA256	`066d5b4bec56af5421c5b8948104ee4889d040076a7dd3e50ecd7a4ef4c286a0`
MD5	`8dabbd3546462e7cd666dc70a7dff314`
BLAKE2b-256	`e9db833fbbb0c2f9d810ee2bd224b2cefe6a04700dc3d375a0649a30eb852b9a`

Algorithm	Hash digest
SHA256	`d487b85805d34146acedf5cba85f4a021005ce8eeafeba3b78ba14a89ca6e44e`
MD5	`5c35480a0e75d3dd5ba69dae7e4c3162`
BLAKE2b-256	`4d0fdc833b1556e40fe9b6b05ec275519ed5e5470459a2271dbc6d2b73c5fe43`

Algorithm	Hash digest
SHA256	`706dd821a9b1605bad551de01a569e5536bd7016dc6e02b7f3d1481c2bc852ba`
MD5	`277d7067099de87c6b34fb3c6236fb57`
BLAKE2b-256	`074449bd29aab93b3b5c1797461640cef9a72165888d60ec20d136f06556b80c`

Algorithm	Hash digest
SHA256	`1ce55efefb208757d0cdc07664c21e732e7137fb42cf42bb5a763b47a4a413c0`
MD5	`762e976fab993103ab5015e09ce77af8`
BLAKE2b-256	`3f14dd3068d2e284601528ec37a62adceaaacb3e7a6c9ad38b986abbf94f6c9b`

Algorithm	Hash digest
SHA256	`638a45a184d1ebdf92a4f9ec86dae5cde5188d45b1b7510fe5c2d426e6a3eae8`
MD5	`1000263dab4cb4583f0a17c3a1b33557`
BLAKE2b-256	`aeb40076810b778f98cbf57c9c2250d7f5ace67e2dda0178c7af2639767922bd`

Algorithm	Hash digest
SHA256	`4b8037e132d0b69a72559438dec8860e1e979b5703bdc4aae785427be4d1679f`
MD5	`c9413fc91dadb0ba1a0fd0de120b6448`
BLAKE2b-256	`f185b78035f6092c7d9aef0fcb13b8b288653388b4accd315ddb9cc0c66c21ba`

pytaglib 3.1.0

Navigation

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Project description

pytaglib

News

Install

Usage

pyprinttags

Installation Notes

Linux: Distribution-Specific Packages

Manual Compilation: General

Compilation: Windows

Development

Contact

Project details

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Release history Release notifications | RSS feed

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

`pyprinttags`

Algorithm	Hash digest
SHA256	`12587361eeaa0a463d2d51951b997e035a39631f0536663c1124531618d0931e`
MD5	`6c66e87d76339880017129536f39f911`
BLAKE2b-256	`f4b2a5cc5630b7f9a80622cef7aa48a606d8d0f92d455c988b53b67a5bc58e0d`

Algorithm	Hash digest
SHA256	`d84ed18e3c5ee136a0162cb89ea48575a9fd986b37ab42bb79e6fd0580d484a7`
MD5	`fde8daad3dce461615c4a43c15b61db4`
BLAKE2b-256	`2f32b6bbd8a08cd38d64e8926e41743325af8c659693944898342ad0c9590097`

Algorithm	Hash digest
SHA256	`359f428c956d0c1585ceeaea464f8affb56f4fb142fce8a184a76b7fb6b03706`
MD5	`d0e4a4a1f672dd6697df6adc979f6de6`
BLAKE2b-256	`60d7ff7596e919e36c1349b820becefbaafa94c6942491e02714930597390add`

Algorithm	Hash digest
SHA256	`701653bbdea2a5bf4e8fe49ba4138477eee21a096a8adf49faa536faeff2d4de`
MD5	`20b6c473008cf820bd862b965144a0b0`
BLAKE2b-256	`a3db060450446a474ddddecc58634b162c704d3eef47b05673ac063a16cebb44`

Algorithm	Hash digest
SHA256	`0a2527aca436bc31eb0c28b32e41310b67daac5467071680f2c80bfc8c563dd5`
MD5	`dd189f203cfe390000fc66887f57e253`
BLAKE2b-256	`6c02681a96d1e483dabf1906f66c4d24d59c9976f5e1ed45ffc064a396e193ee`

Algorithm	Hash digest
SHA256	`ad9f2aee7021f0ed915f5f0fdc08b25adfd451ea7e59338b1f7cad0e4aea2396`
MD5	`6d6e2d7eb269a5e4ca36eb57911e2f1d`
BLAKE2b-256	`433cf55465b4699f5351993757afdc275bc46eaadd9944745b842e701814f4f1`

Algorithm	Hash digest
SHA256	`176f34fc49d526f41b2a0aec338d95769df944d7328902a1ee67a47f143aff0f`
MD5	`8592ebdb9dda96c3e1e20f3a787879fd`
BLAKE2b-256	`e8985b15e2ab399f0b9c4c02ee0d7046154e6a22f988f3e609ffc32350512207`

Algorithm	Hash digest
SHA256	`da00e730d6de490c3ed7549244f464e93a0cdfde17c70916f328440816715086`
MD5	`61874e95f1872f5b13558833c6f92dd0`
BLAKE2b-256	`61c2faff4f5bb022c203d205b92bccf94421cb564add6c4b8f8033c4aa7b2472`

Algorithm	Hash digest
SHA256	`5123b7e3ee2dd901da01443b53033f37671344a09e904589fea6c9451e326398`
MD5	`efb85d24ebd41a28d479e4ac5cf5e7e8`
BLAKE2b-256	`406c02ef464f4cd427707e11259cdd57669b9a364a1cf2685c6346b4051d1487`

Algorithm	Hash digest
SHA256	`40327186ee675bfde7a82d8c6b0b3a2163db45bdf2147410d13d9446b1f8dbc6`
MD5	`dfb4e00e30134991a793a4a79ab96363`
BLAKE2b-256	`395b666896733205167494803a5526b5f36a96df6053e1fe211cd823d6dc1dd2`