tinytag is a library for reading music meta data of MP3, OGG, OPUS, MP4, M4A, FLAC, WMA and Wave files with python
[](https://travis-ci.org/devsnd/tinytag) [](https://coveralls.io/r/devsnd/tinytag)
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
File details
Details for the file tinytag-1.0.0.tar.gz.
File metadata
- Download URL: tinytag-1.0.0.tar.gz
- Upload date:
- Size: 24.6 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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9110a917b87dda4cde2ac8ff72fb5ebf1f060d3629676df566ea2aa049ea2c45
|
|
| MD5 |
3ec448c8bc323ddd0b4d93fddc4998d2
|
|
| BLAKE2b-256 |
734b0c57a99a66abd4aae7128b14256923d9a47877a18a32514156a403f4b9e7
|
](https://travis-ci.org/devsnd/tinytag){kind=link}
](https://coveralls.io/r/devsnd/tinytag){kind=link}