Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

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
Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
hsaudiotag3k-1.1.3.tar.gz (16.7 kB) Copy SHA256 Checksum SHA256 Source Aug 10, 2012

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting