Skip to main content
Join the official Python Developers Survey 2018 and win valuable prizes: Start the survey!

Read music meta data and length of MP3, OGG, FLAC and Wave files

Project description

tinytag is a library for reading music meta data of MP3, OGG, FLAC and Wave files with python

[![Build Status](]( [![Coverage Status](](

  • Read tags and length of music files
  • supported formats * MP3 (ID3 v1, v1.1, v2.2, v2.3+) * Wave * OGG * FLAC
  • pure python
  • supports python 2 and 3 (without 2to3)
  • is tested
  • Just a few hundred lines of code (just include it in your project!)

tinytag only provides the minimum needed for _reading_ MP3, OGG, FLAC and Wave meta-data. It can determine track number, total tracks, title, artist, album, year, duration and more.

from tinytag import TinyTag tag = TinyTag.get(‘/some/music.mp3’) print(‘This track is by %s.’ % tag.artist) print(‘It is %f seconds long.’ % tag.duration)

List of possible attributes you can get with TinyTag:

tag.album # album as string tag.artist # artist name as string tag.audio_offset # number of bytes before audio data begins tag.bitrate # bitrate in kBits/s tag.duration # duration of the song in seconds tag.filesize # file size in bytes tag.samplerate # samples per second tag.title # title of the song tag.track # track number as string tag.track_total # total number of tracks as string tag.year # year or data as string

supported python versions:

  • 2.6
  • 2.7
  • 3.2
  • 3.3
  • pypy

and possibly more.

Project details

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
tinytag-0.6.1.tar.gz (9.5 kB) Copy SHA256 hash SHA256 Source None Jun 30, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page