Skip to main content

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

Installation

To install tinytag, simply:

pip install tinytag

Features:

  • 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


Release history Release notifications

History Node

0.18.0

History Node

0.17.0

History Node

0.16.0

History Node

0.15.2

History Node

0.15.0

History Node

0.14.2

History Node

0.14.1

History Node

0.14.0

History Node

0.13.1

History Node

0.12.0

History Node

0.11.0

History Node

0.10.1

History Node

0.10.0

History Node

0.9.3

History Node

0.9.2

History Node

0.9.1

History Node

0.9.0

History Node

0.8.1

History Node

0.8.0

This version
History Node

0.7.2

History Node

0.7.1

History Node

0.6.1

History Node

0.6.0

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.7.2.tar.gz (10.4 kB) Copy SHA256 hash SHA256 Source None Oct 24, 2014

Supported by

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