How can I retrieve mp3 metadata in Python?
This question is tagged with
~ Asked on 2008-08-12 15:16:00
I used eyeD3 the other day with a lot of success. I found that it could add artwork to the ID3 tag which the other modules I looked at couldn't. You'll have to install using pip or download the tar and execute
python setup.py install from the source folder.
Relevant examples from the website are below.
Reading the contents of an mp3 file containing either v1 or v2 tag info:
import eyeD3 tag = eyeD3.Tag() tag.link("/some/file.mp3") print tag.getArtist() print tag.getAlbum() print tag.getTitle()
Read an mp3 file (track length, bitrate, etc.) and access it's tag:
if eyeD3.isMp3File(f): audioFile = eyeD3.Mp3AudioFile(f) tag = audioFile.getTag()
Specific tag versions can be selected:
tag.link("/some/file.mp3", eyeD3.ID3_V2) tag.link("/some/file.mp3", eyeD3.ID3_V1) tag.link("/some/file.mp3", eyeD3.ID3_ANY_VERSION) # The default.
Or you can iterate over the raw frames:
tag = eyeD3.Tag() tag.link("/some/file.mp3") for frame in tag.frames: print frame
Once a tag is linked to a file it can be modified and saved:
tag.setArtist(u"Cro-Mags") tag.setAlbum(u"Age of Quarrel") tag.update()
If the tag linked in was v2 and you'd like to save it as v1:
Read in a tag and remove it from the file:
tag.link("/some/file.mp3") tag.remove() tag.update()
Add a new tag:
tag = eyeD3.Tag() tag.link('/some/file.mp3') # no tag in this file, link returned False tag.header.setVersion(eyeD3.ID3_V2_3) tag.setArtist('Fugazi') tag.update()
~ Answered on 2008-09-19 14:30:41
I've used mutagen to edit tags in media files before. The nice thing about mutagen is that it can handle other formats, such as mp4, FLAC etc. I've written several scripts with a lot of success using this API.
~ Answered on 2008-08-14 09:46:21
A problem with
eyed3 is that it will throw
NotImplementedError("Unable to write ID3 v2.2") for common MP3 files.
In my experience, the
EasyID3 works more reliably. Example:
from mutagen.easyid3 import EasyID3 audio = EasyID3("example.mp3") audio['title'] = u"Example Title" audio['artist'] = u"Me" audio['album'] = u"My album" audio['composer'] = u"" # clear audio.save()
All other tags can be accessed this way and saved, which will serve most purposes. More information can be found in the Mutagen Tutorial.
~ Answered on 2016-01-24 00:07:24
What you're after is the ID3 module. It's very simple and will give you exactly what you need. Just copy the ID3.py file into your site-packages directory and you'll be able to do something like the following:
from ID3 import * try: id3info = ID3('file.mp3') print id3info # Change the tags id3info['TITLE'] = "Green Eggs and Ham" id3info['ARTIST'] = "Dr. Seuss" for k, v in id3info.items(): print k, ":", v except InvalidTagError, message: print "Invalid ID3 tag:", message
~ Answered on 2008-08-13 00:44:26
check this one out:
>>> import songdetails >>> song = songdetails.scan("data/song.mp3") >>> print song.duration 0:03:12
>>> import songdetails >>> song = songdetails.scan("data/commit.mp3") >>> song.artist = "Great artist" >>> song.save()
~ Answered on 2010-12-30 01:40:52
Just additional information to you guys:
take a look at the section "MP3 stuff and Metadata editors" in the page of PythonInMusic.
~ Answered on 2011-07-08 08:24:29
I looked the above answers and found out that they are not good for my project because of licensing problems with GPL.
Notable to mention is that both are LGPL, and are good to go.
~ Answered on 2009-12-20 19:32:11
easiest method is songdetails..
for read data
import songdetails song = songdetails.scan("blah.mp3") if song is not None: print song.artist
similarly for edit
import songdetails song = songdetails.scan("blah.mp3") if song is not None: song.artist = u"The Great Blah" song.save()
Don't forget to add u before name until you know chinese language.
u can read and edit in bulk using python glob module
import glob songs = glob.glob('*') # script should be in directory of songs. for song in songs: # do the above work.
~ Answered on 2016-08-11 09:05:38
After trying the simple
pip install route for eyeD3, pytaglib, and ID3 modules recommended here, I found this fourth option was the only one to work. The rest had import errors with missing dependencies in C++ or something magic or some other library that
pip missed. So go with this one for basic reading of ID3 tags (all versions):
from tinytag import TinyTag tag = TinyTag.get('/some/music.mp3')
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.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
It was tiny and self-contained, as advertised.
~ Answered on 2018-04-16 01:34:52
I used tinytag 1.3.1 because
1.3.0 (2020-03-09): added option to ignore encoding errors ignore_errors #73 Improved text decoding for many malformed files
MP3 (ID3 v1, v1.1, v2.2, v2.3+) Wave/RIFF OGG OPUS FLAC WMA MP4/M4A/M4B
from tinytag import TinyTag fileNameL ='''0bd1ab5f-e42c-4e48-a9e6-b485664594c1.mp3 0ea292c0-2c4b-42d4-a059-98192ac8f55c.mp3 1c49f6b7-6f94-47e1-a0ea-dd0265eb516c.mp3 5c706f3c-eea4-4882-887a-4ff71326d284.mp3 '''.split() for fn in fileNameL: fpath = './data/'+fn tag = TinyTag.get(fpath) print() print('"artist": "%s",' % tag.artist) print('"album": "%s",' % tag.album) print('"title": "%s",' % tag.title) print('"duration(secs)": "%s",' % tag.duration)
JoeTagPj>python joeTagTest.py "artist": "Conan O’Brien Needs A Friend", "album": "Conan O’Brien Needs A Friend", "title": "17. Thomas Middleditch and Ben Schwartz", "duration(secs)": "3565.1829583532785", "artist": "Conan O’Brien Needs A Friend", "album": "Conan O’Brien Needs A Friend", "title": "Are you ready to make friends?", "duration(secs)": "417.71840447045264", "artist": "Conan O’Brien Needs A Friend", "album": "Conan O’Brien Needs A Friend", "title": "Introducing Conan’s new podcast", "duration(secs)": "327.22187551899646", "artist": "Conan O’Brien Needs A Friend", "album": "Conan O’Brien Needs A Friend", "title": "19. Ray Romano", "duration(secs)": "3484.1986772305863", C:\1d\PodcastPjs\JoeTagPj>
~ Answered on 2020-03-10 21:02:09
The first answer that uses eyed3 is outdated so here is an updated version of it.
Reading tags from an mp3 file:
import eyed3 audiofile = eyed3.load("some/file.mp3") print(audiofile.tag.artist) print(audiofile.tag.album) print(audiofile.tag.album_artist) print(audiofile.tag.title) print(audiofile.tag.track_num)
An example from the website to modify tags:
import eyed3 audiofile = eyed3.load("some/file.mp3") audiofile.tag.artist = u"Integrity" audiofile.tag.album = u"Humanity Is The Devil" audiofile.tag.album_artist = u"Integrity" audiofile.tag.title = u"Hollow" audiofile.tag.track_num = 2
An issue I encountered while trying to use eyed3 for the first time had to do with an import error of libmagic even though it was installed. To fix this install the magic-bin whl from here
~ Answered on 2018-04-08 15:52:20
I would suggest mp3-tagger. Best thing about this is it is distributed under MIT License and supports all the required attributes.
- artist; - album; - song; - track; - comment; - year; - genre; - band; - composer; - copyright; - url; - publisher.
from mp3_tagger import MP3File # Create MP3File instance. mp3 = MP3File('File_Name.mp3') # Get all tags. tags = mp3.get_tags() print(tags)
It supports set, get, update and delete attributes of mp3 files.
~ Answered on 2018-06-26 13:50:36
It can depend on exactly what you want to do in addition to reading the metadata. If it is just simply the bitrate / name etc. that you need, and nothing else, something lightweight is probably best.
If you're manipulating the mp3 past that PyMedia may be suitable.
There are quite a few, whatever you do get, make sure and test it out on plenty of sample media. There are a few different versions of ID3 tags in particular, so make sure it's not too out of date.
Personally I've used this small MP3Info class with luck. It is quite old though.
~ Answered on 2008-08-12 15:37:59
import eyed3 import os for root, dirs, files in os.walk(folderp): for file in files: try: if file.find(".mp3") < 0: continue path = os.path.abspath(os.path.join(root , file)) t = eyed3.load(path) print(t.tag.title , t.tag.artist) #print(t.getArtist()) except Exception as e: print(e) continue
~ Answered on 2020-02-06 23:51:17
After some initial research I thought songdetails might fit my use case, but it doesn't handle .m4b files. Mutagen does. Note that while some have (reasonably) taken issue with Mutagen's surfacing of format-native keys, that vary from format to format (TIT2 for mp3, title for ogg, \xa9nam for mp4, Title for WMA etc.), mutagen.File() has a (new?) easy=True parameter that provides EasyMP3/EasyID3 tags, which have a consistent, albeit limited, set of keys. I've only done limited testing so far, but the common keys, like album, artist, albumartist, genre, tracknumber, discnumber, etc. are all present and identical for .mb4 and .mp3 files when using easy=True, making it very convenient for my purposes.
~ Answered on 2015-07-12 23:17:59