Skip to main content

Read metdata (tags) of mp3, mp4, wma, ogg, flac and aiff files.

Project description

This is a Python 3 package. The Python 2 package is at .

hsaudiotag is a pure Python library that lets you read metadata (bitrate, sample rate, duration and tags) from mp3, mp4, wma, ogg, flac and aiff files. It can only read tags, not write to them, but unlike more complete libraries (like Mutagen), it is BSD licensed, making it suitable for most projects. It is also backed by a nifty test suite.

The documentation has to be built with Sphinx. You can get Sphinx at

Once you installed it, you can build the documentation with:

sphinx-build docs docs_html

The documentation is also available online at


Version 1.1.3 – 2012/08/10

  • Fixed a bug preventing some OGG track fields from being read.

Version 1.1.2 – 2011/09/29

  • Fixed a bug preventing some OGG metadata from being read.

Version 1.1.1 – 2011/01/31

  • Fixed crash on reading tag-less AIFF files.

  • Fixed crash on mp4 files containing invalid utf-8 data.

Version 1.1.0 – 2010/12/29

  • Added a wrapper class to automatically detect a file type.

  • Invalid AIFF files now set their attributes nonetheless.

Version 1.0.5 – 2010/12/20

  • Got rid of the hsutil dependency.

Version 1.0.4 – 2010/11/19

  • Fixed a crash when reading mp4 files with malformed attribute atoms.

Version 1.0.3 – 2010/11/11

  • Fixed a crash when reading mp4 files with out of range genre indexes.

Version 1.0.2 – 2010/09/25

  • Fixed a crash when reading Id3v2 text frames with invalid string encoding flag.

Version 1.0.1 – 2010/08/24

  • Fixed squeeze.squeeze_mpeg under py3k.

  • Fixed the decoding of mpeg files with Xing headers under py3k.

Version 1.0.0 – 2010/07/11

  • Initial Release

Project details

Download files

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

Source Distribution

hsaudiotag3k-1.1.3.post1.tar.gz (17.8 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page