Mutagen Tutorial

This is great (!! :D) but where can I find more documentation & examples?

-Mike

how is audio.info.length formated

@timoverbeek10 - I think it's in seconds, which is odd. Milliseconds would be nicer for sure.

Could you post an example of how to read the mp3 artist name?

#!/usr/bin/python

from mutagen.mp3 import MP3
audio = MP3("testfile.mp3")
songtitle = audio["TIT2"]
artist = audio["TPE1"]
album = audio["TALB"]

print songtitle
print artist
print album

try to :

from mutagen.mp3 import MP3 
audio = MP3("testfile.mp3") 
dir(audio) 

:)

It would be nice to have a wrapper that detects the format and automatically reads/writes the right type of tag. Then all tags could be accessed from generic easy to use functions.

There is wrapper that detects the format and automatically reads/writes the right type of tag:

>>> mutagen.File("mutah_resign.mp3", easy=True)
{'date': [u'2011'], 'album': [u'Salary man on holidays'], 'title': [u'Resign'], 'genre': [u'Trip-Hop'], 'artist': [u'Mutah']}
>>> mutagen.File("080208workadub.ogg", easy=True)
{'album': [u''], 'description': [u''], 'artist': [u'Mutah'], 'title': [u'Work a dub'], 'date': [u'2008'], 'genre': [u'']}
>>> mutagen.File("01 - a custom skylark 1.flac", easy=True)
{'album': [u'cd Bea'], 'description': [u''], 'artist': [u'kaffe matthews'], 'title': [u'a custom skylark 1'], 'tracktotal': [u'26'], 
 'musicbrainz_sortname': [u'kaffe matthews'], 'genre': [u'Electro Experimental'], 'tracknumber': [u'1']}

I encountered an mp3 file with multiple cover images embeded (6 or 7 images in total) but mutagen reads and shows only 2. Are there any special methods of accessing those extra 'hidden' apic frames?

I suspect the reason Mutagen only finds two is because they have the same content descriptor (description string) and type. If this is the case, there is no way in the normal interface - Mutagen uses these to generate the frame's hash key, which is explicitly allowed by the ID3v2 specification, so the file are technically out of spec.

However, it is possible to subclass mutagen.id3.ID3 and override the 'add' method to intercept any frame, changing its hash key or otherwise special-casing its insertion into the dictionary. This is actually a supported API injection point, so it's unlikely to break - Quod Libet has used it for years to parse a common ID3v2.3 idiom.

OK. Got the idea. Thanks a lot for the explanation. I'll give it a try.

How can I write a comment field? This doesn't seem to work:

#!/usr/bin/env python
# -*- coding: utf-8 -*-

from mutagen.id3 import ID3, TRCK, TIT2, TPE1, TALB, TDRC, TCON, COMM
audio = ID3("example.mp3")

audio.add(TRCK(encoding=3, text=u"1"))
audio.add(TIT2(encoding=3, text=u"Title"))
audio.add(TPE1(encoding=3, text=u"Artist"))
audio.add(TALB(encoding=3, text=u"Album"))
audio.add(TDRC(encoding=3, text=u"2011"))
audio.add(TCON(encoding=3, text=u"Genre"))
audio.add(COMM(encoding=3, text=u"Comment"))

audio.save()

Also I get "ID3NoHeaderError" if the file has no ID3 tag at all. How can I do that?

Me too, I've got an error when adding a comment (COMM):

ValueError?: Invalid StringSpec?3? data: 'blabla'

Using MP3(filename, ID3=EasyID3), I was getting errors if I started with a file with no tags and tried to set tags. Actually, it would let me set tags but errors would happen in pprint() or save(). But, it seems to work the way I want with mutagen.File(filename,easy=True):

>>> import mutagen
>>> src = mutagen.File("You Said it Butch.mp3", easy=True)
>>> dest = mutagen.File("192/You Said it Butch.mp3", easy=True)
>>> for k in src:
...     dest[k] = src[k]
... 
>>> dest.save()
>>> test = mutagen.File("192/You Said it Butch.mp3", easy=True)
>>> print test.pprint()
MPEG 1 layer 3, 192000 bps, 44100 Hz, 248.25 seconds (audio/mp3)
album=The Burst of the West
artist=Harry Potter
encodedby=Fission
performer=Harry Potter
title=You Said it Butch
tracknumber=2/3
>>> 

The dest file was produced by transcoding the src file using lame (which drops ID3 tags). Another way that worked with the MP3(filename, ID3=EasyID3) class, was to tell lame "--tt title" to add one dummy tag. Then mutagen was willing to transfer the tags and save the changes. But that's obscure and kludgy.

So the long-term question is, what's the general way to get mutagen to let me add tags in the "easy" way to a file that starts out tagless?

If you have problems opening or saving files using MP3(filename, ID3=EasyID3), please report a ticket.

Joe-- Okay, I reported it as Problem adding ID3 tags to tagless file opened with MP3(filename, ID3=EasyID3)

yomguyparisson: Use this to put comment to MP3 tags:

#!/usr/bin/env python
# -*- coding: utf-8 -*-

# Imports
from mutagen.id3 import ID3, TRCK, TIT2, TPE1, TALB, TDRC, TCON, COMM

# Set file
audio = ID3("example.mp3")

# Add tags
audio.add(TRCK(encoding=3, text=u"1"))
audio.add(TIT2(encoding=3, text=u"Title"))
audio.add(TPE1(encoding=3, text=u"Artist"))
audio.add(TALB(encoding=3, text=u"Album"))
audio.add(TDRC(encoding=3, text=u"2011"))
audio.add(TCON(encoding=3, text=u"Genre"))
audio.add(COMM(encoding=3, lang="eng", desc="", text="Comment"))

# Save tags
audio.save()

# Print tags
print audio.pprint()

...But I still haven't figured out how to create ID3 header if the file has none.

If you are having trouble adding an ID3 tag to a file, please see the FAQ "How do I add an ID3 tag?"

i'm having problems with mp4 cover, with mp3 is fine, but with mp4 i ain't being able to figure out how to set it, anyone has a suggestion ?

thanks a lot

after saving tags with mutagen, the tags just "disappear" and are not being displayed on windows//explorer or wmp.... on itunes is ok, when i pprint the tags are shown, but windows seems to do not like it.... any ideas ?!

thanks

How would you use Mutagen with StringIO for reading ID3 tags from mp3s stored in strings.

How to get track length for FLAC?

How I can add APIC tag using some JPG file as picture into MP3 file? If adding an image can be done something like that

audio = ID3(u'P:/How Low_2.mp3')
pic = APIC(3, u'image/jpg', 3, u'Front cover', open(u'cover.jpg', 'rb').read())
audio.add(pic)
audio.save()

then I would like to report an error - the image is added incorrectly or incompletely.

After many hours . . .

I discovered why on save() the information disappears in Windows Explorer and Media Player . . .

. . . Windows Explorer and Media Player only read, and mutagen does NOT write, ID3v1 tags!

And as far as I can tell from the LIMITED documentation, mutagen will READ BUT NOT WRITE ID3v1 tags.

I further discovered, while playing with WINAMP, that it is possible to have BOTH ID3v1 and ID3v2 tags in a file, BUT Windows Explorer and Media Player require the ID3v1 tags to come first!

But there's no way to explicitly ensure that mutagen follows this requirement.

Does anybody know ID3v1 well enough to dive into the source code and fix this?

I'm using Windows 7, Python 2.7, Mutagen 1.20. I really hope this helps someone avoid spending painful amounts time!

$ pydoc mutagen.id3.ID3.save

Help on method save in mutagen.id3.ID3:

mutagen.id3.ID3.save = save(self, filename=None, v1=1) unbound mutagen.id3.ID3 method
    Save changes to a file.
    
    If no filename is given, the one most recently loaded is used.
    
    Keyword arguments:
    v1 -- if 0, ID3v1 tags will be removed
          if 1, ID3v1 tags will be updated but not added
          if 2, ID3v1 tags will be created and/or updated

I would like to scan many files and catch ones that have too small images. I see the APIC element, but no obvious way to determine the length and width. Could someone please post an example of how to determine the image length and width?

How can I access the value inside the POPM tag? Using:

from mutagen.mp3 import MP3
audio = MP3("testfile.mp3")
popular = audio["POPM"]

Gives me an error:

File "/usr/lib/pymodules/python2.7/mutagen/_util.py", line 108, in __getitem__
    return self.__dict[key]
KeyError: 'POPM