id3reader is a Python module that reads ID3 metadata tags in MP3 files. It can read ID3v1, ID3v2.2, ID3v2.3, or ID3v2.4 tags. It does not write tags at all.

The code in is in the public domain. Do with it as you please.


To install id3reader, just copy to your Python path.



Using id3reader couldn’t be simpler:

import id3reader

# Construct a reader from a file or filename.
id3r = id3reader.Reader('my_favorite.mp3')

# Ask the reader for ID3 values:
print id3r.getValue('TT2')

In addition to whatever literal ID3 tag ids are found in the file (TP1, TIT2, etc), id3reader defines five pseudo ids for convenience:


These ids find the appropriate ID3 id for the ID3 version read from the file, so you can get at this basic data without having to consider the different versions of the ID3 spec.

If you run id3reader from the console, it will dump the ID3 information for the MP3 file named as its argument.


The ID3 spec is quite extensive, and specifies functionality that I have never encountered in actual MP3 files. Id3reader implements as much of the spec as I have seen used. If you have files that id3reader does not properly interpret, please mail them to me. I’ll extend id3reader to read them.


5 January 2004: It wasn’t reading ID3v1 tags properly, and had problems with empty string values.

9 January 2004: Now it reads ID3v2.3 properly, and reads unsyncronized tags.

13 January 2004: Fix unsynchronized reading, reads compressed frames, improved detection of end of frames, extended headers are read (but not interpreted), multi-string frames are interpreted, and the file is closed if we opened it.

3 August 2004: Add support for genres (although they’re stupid), and the command-line mode will print strings regardless of their encoding.

13 September 2004: Better protection against non-character data when showing the data on the command line.


Sooo easy to use. it's really nice!

this is a very cool piece of software. i use before eyed3 and my files where not read at all. with this peace of software it's so much easier to write my programs. thank you for your work and please go on :-)

Perfect! Just what I've been looking for. Much better at reading v2 tags than anything else I've found for python. Keep up the good work :o)
sweet! just what i needed... now i can incorporate renaming files by id tag in my file reanming program. Thank you very much!
Need a way to read ID3v1/1.1 and ID3v2.x seperately so an application can compare, copy tag, delete one or the other, etc.
In class Reader, change the initialization of self.header to:
self.header = _Header()
It is apparently legal (though not likely) to have an MP3 file with no ID3 tags at all.

I am writing a special-purpose splitter that first copies only the data to another file, then goes back later and adds ID3 tags. I am using id3writer for this, which in turn relies on your id3reader.

id3 writer is available from

I like your lib, thanks

But I need some help: how can I read comments?

If I try dump I could see them but I don't know how to read them

Hi Ned,

I'm trying to write something to set ID3 tags in Python using ID3-PY (

Does that replace id3reader?
Hey - fabulous script, just the thing I was looking for. Great stuff, thanks a lot!

maybe somebody could help me in this case.
Beside the other informations i am reading out of mp3 files, i want to read the time of the mp3s, for example(03:45). Do you know if this is possible with id3Reader and how?
If it is not possible with the id3reader, how else can i get the time?

thank you
was having some problems with encodings in unicode build of wxpython. here is my solution:

def getValue(self, id, encoding):
""" Return the value for an ID3 tag id, or for a
convenience label ('title', 'performer', ...),
or return None if there is no such value.
if self.frames.has_key(id):
if hasattr(self.frames[id], 'value'):
if isinstance(self.frames[id].value, unicode):
returnValue = self.frames[id].value
returnValue = unicode(self.frames[id].value, encoding)
return returnValue

if _simpleDataMapping.has_key(id):
for id2 in _simpleDataMapping[id]:
v = self.getValue(id2, encoding)
if v:
if isinstance(v, unicode):
returnV = v
returnV = unicode(v, encoding)
return returnV
return None

so now I can specify the encoding returned by id3reader, usage is as follows:
id3r = id3reader.Reader(file)
value = id3r.getValue(id, encoding)
hum the tabs didn't stick... well you should know what to do ;)
I can't even write my own url.
Very, good! Thanks!
One problem, I can't get tags from string in zip file:

z = zipfile.ZipFile("")
flist = z.namelist()
for j in flist:
next_mp3 =
id3 = id3reader.Reader(next_mp3) # Not work :((
Hi Ned,

This is exactly what I have been looking for.
Absolutely fantastic!
Many thanks.
Awesome python script. Will be definately using it in my project. Will comment about it when I get something concrete..
Any one knows how to read album art of mp3 files in python?
I was having problems with lists generated from the data returned by id3reader. The problem was that if one of the fields was empty then you'd have a list of unicode type data with one NoneType in the middle which throws errors with some methods like join which expect str or unicode. I changed the return None in def getValue to return u'None' which worked. I don't how elegant this solution is but it worked.
I understood that I can read almost all information from media section.
But, how can I read "Length" parameter from this section and how can I read the file audio information?
I need to know the "bit rate" parameter
Thank you for your help
Thank you so much
Hi, I am working on armstrong cms, a open source cms for newsrooms that uses django. I am wondering about using this code in our project. The project is using Apache license v2. The code is up on
I am wondering what you think licensing wise.
Any hope of getting one that will write to ID3 tags?
@Tensigh: I'm not even maintaining this reader any more, so I'm definitely not writing a writer.
I see. There are other ones out there, this one just seemed to be the easiest on accessing the tags. Kind of useless though, without being able to write them back.

Thanks, though! Cool project otherwise!
I had a problem with some tracks that had fields with characters that couldn't be read by str.decode('utf-16'). Couldn't figure out what the characters were, because nothing would print them, just skip them. The fix I had was to use str.decode('utf-16', 'ignore') (line 149 of version '1.53.20070415').
Your .py file is replete with errors and I have attempted to repair all of them,but is yet to actually do anything. I cannot get over all the "experts" who write code with so many oversights. Items include Calls without Parens, Prints without parens. half assignments ( =1 ==1 ==0 =0) with no assignment on the left. You must not be doing the Python in Debian Linux or Windows. THe code is REJECTED both places. Do your homework.
Hi Hugh, sorry you had a tough time with this code.

This code was written 13 years ago, and runs on Python 2. It sounds
like you ran it on Python 3.

Next time, ask a question. The answer is different than, "Ned is an
idiot claiming to be an expert."
Thanks, Ned. That works great!

I've converted it to run under Python 3, and the conversion's available on the same terms as your original. It's available at , in case it's useful for anyone else.

This doesn’t work for me. First, I had to update it to Python 3 (not manually though, thank goodness). Then when I imported it, and made a (id3r = id3reader.Reader("file.mp3")) and did (id3r.getValue("title")), it gave me None, even though I know it has data, because I can check (system app). So, could you update it?

Add a comment:

Ignore this:
Leave this empty:
Name is required. Either email or web are required. Email won't be displayed and I won't spam you. Your web site won't be indexed by search engines.
Don't put anything here:
Leave this empty:
Comment text is Markdown.