skip to navigation
skip to content

tinytag 0.10.1

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

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


To install tinytag, simply:

pip install tinytag


  • Read tags, length and IDv3 cover images 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.genre         # genre as string
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

Additionally you can also get cover images from ID3 tags:

tag = TinyTag.get('/some/music.mp3', image=True)
image_data = tag.get_image()

supported python versions:

  • 2.6+
  • 3.2+
  • pypy

and possibly more.

File Type Py Version Uploaded on Size
tinytag-0.10.1.tar.gz (md5) Source 2015-10-12 31KB
  • Downloads (All Versions):
  • 7 downloads in the last day
  • 182 downloads in the last week
  • 1005 downloads in the last month