tinytag

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

Features:

Read tags, length and IDv3 cover images of music files
supported formats
- MP3 (ID3 v1, v1.1, v2.2, v2.3+)
- Wave
- OGG
- OPUS
- FLAC
- WMA
- MP4/M4A
pure python
supports python 2.6+ and 3.2+
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, OPUS, MP4, M4A, FLAC, WMA 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.albumartist   # album artist 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.comment       # file comment as string
tag.disc          # disc number
tag.disc_total    # the total number of discs
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.

Changelog:

1.0.0 (2018-12-12):
- added comment field
- added wav-riff format support
- use MP4 parser for m4b files
- added simple cli tool
- fix parsing of FLAC files with ID3 header (thanks to minus7)
- added method TinyTag.is_supported(filename)
0.19.0 (2018-02-11):
- fixed corrupted images for some mp3s (#45)
0.18.0 (2017-04-29):
- fixed wrong bitrate and crash when parsing xing header
0.17.0 (2016-10-02):
- supporting ID3v2.2 images
0.16.0 (2016-08-06):
- MP4 cover image support
0.15.2 (2016-08-06):
- fixed crash for malformed MP4 files (#34)
0.15.0 (2016-08-06):
- fixed decoding of UTF-16LE ID3v2 Tags, improved overall stability
0.14.0 (2016-06-05):
- MP4/M4A and Opus support

Download files

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

Source Distribution

tinytag-1.0.1.tar.gz (23.9 kB view details)

Uploaded Apr 13, 2019 Source

File details

Details for the file tinytag-1.0.1.tar.gz.

File metadata

Download URL: tinytag-1.0.1.tar.gz
Upload date: Apr 13, 2019
Size: 23.9 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.20.1 setuptools/40.6.2 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.1

File hashes

Hashes for tinytag-1.0.1.tar.gz
Algorithm	Hash digest
SHA256	`21aba7f1cb020948e2ddde9df295c5cb953ac414171efcf31d30e6cf1596cc66`
MD5	`098e4c0145ea3023b4a37bcec8682100`
BLAKE2b-256	`6d8e98dae4d302aee74dbf6c972edac08bb7758031101f07f8b48774605d83e5`