pytags Beta

pytags is a Python library capable of reading and writing MP3, FLAC and OGG file tags.

Being tired of having to use a different API calls for the main 3 media files in my library I created this library class. It utilizes pyid3lib, python-vorbis and python-flac as backends. None are required, however, it is up the program implementing the class to decide which backends are needed. Note this library has not been widely tested yet. It is just being subject to release early and release often. That being said I have not suffered any corruption during any part of the development besides perhaps the loss of tag data.

Given that the Vorbis and FLAC tags are wildly different from ID3 some liberties have been taken on my part. While ID3 is limited to one field of each data Vorbis/FLAC can have as many as you want. This library handles that by only returning the first match on a get query. (Perhaps in the future they will all be returned) On a set query the new item will just be added on to the others. If a set then get occurs the last one set will be returned. Feel free to contact me tkorody you.know.what.to.do socal.rr.com with any questions or comments you may have.

Example of the API:

import pytags, os

print pytags.tags.get_Supported_Formats()
try:
media_file = pytags.tags(a_cool_song.flac)
except FileNotSupported:
print This file doesnt seem to be supported
os.exit(-1)

# Note the str() is used because None type object can get returned!
print Artist is + str(media_file.get_Artist())
print Album is + str(media_file.get_Album())
print Title is + str(media_file.get_Title())
print Track Total is + str(media_file.get_TrackTotal())
print Track Number is + str(media_file.get_TrackNumber())
print Genre is + str(media_file.get_Genre())
print Disc Number is + str(media_file.get_DiscNumber())
print Comment is + str(media_file.get_Comment())
print Date is + str(media_file.get_Date())

print Now Settings Tags!

text=Boring

media_file.set_Artist(text)
media_file.set_Genre(text)
media_file.set_Album(text)
media_file.set_Title(text)
media_file.set_TrackTotal(9)
media_file.set_TrackNumber(3)
media_file.set_DiscNumber(1)
media_file.set_Comment(text)
media_file.set_Date(1996)