Overview

pytaglib is a full-featured, easy-to-use, cross-platform audio metadata (“tag”) library for Python (all versions supported). It uses the popular, fast and rock-solid TagLib C++ library internally; pytaglib is a very thin wrapper about TagLib (<150 lines of code), meaning that you immediately profit from the underlying library’s speed and stability.

Features include support of more than a dozen file formats, arbitrary tag names, and multiple values per tag.

Usage Example

• Open a file and read its tags:

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

• Read some additional properties of the file:

  >>> song.length
  239
  >>> song.channels
  2

• Change the file’s tags:

  >>> song.tags["ALBUM"] = ["White Album"] # always use lists, even for single values
  >>> del song.tags["DATE"]

• Multiple values per tag:

  >>> song.tags["GENRE"] = ["Vocal", "Classical"]

• Non-standard tags:

  >>> song.tags["PERFORMER:HARPSICHORD"] = ["Ton Koopman"]

• Save your changes:

  >>> returnvalue = song.save()
  >>> returnvalue
  {}

  The dictionary returned by save contains all tags that could not be saved (might happen if the specific format does not support e.g. multi-values).

Installation

The most recommended installation method is

pip install pytaglib

subject to the following notes:

• Ensure that pip points to the correct Python version; you might need to use, e.g., pip-3.5 if you want to install pytaglib for Python 3.5 and your system’s default is Python 2.7.

• You may need administrator rights to install a package, i.e., sudo pip install pytaglib on Unix or running the command on a Admin console on windows

• Alternatively, install locally into your user home with pip install --user pytaglib.

• You need to have taglib installed with development headers (package libtag1-dev for debian-based linux, brew install taglib on OS X).

• If taglib is installed at a non-standard location, you can tell pip where to look for its include (-I) and library (-L) files:

  pip install --global-option=build_ext --global-option="-I/usr/local/include/" --global-option="-L/usr/local/lib" pytaglib

If the above does not work, continue reading for alternative methods of installation.

python setup.py build --include-dirs /usr/local/include --library-dirs /usr/local/lib

pyprinttags

Contact