A Wrapper Class for the libid3tag Library

Sample Image - CMP3ID3.jpg

Introduction

libid3tag is an open source project for retriving and modifying id3 tags. It will read / modify all versions of id3 tags (id3v1.x and id3v2.x). The beauty of this library is that it puts all versions of id3 tag information into the format of the most current version id3v2.4. By doing this, you don't need to be careful about what kind of id3 version may be contained in a given MP3 file, you always get an id3v2.4 interface. Though libid3tag is a great project, it has the problem of lacking documents. To make it easy to use for those who want to manipulate id3 tags, I decided to wrap the library into a simple class so that you don't need to spend your valuable time like I do, to go into details in order to get a feel of how to use it.

This is not a document to libid3tag, but the class does introduce the basic idea of how to use the libid3tag. If you decide to make your own class, this is probably a good start.

Using the code

The class is very simply to use.

First of all, you need to insert the following files into your VS project:

MP3ID3.cpp
MP3ID3.h
MP3Info.h
Macro.h

Secondly, you need to get libid3tag library from here. The latest version is 0.15.1b that was released on February 17, 2004. Once you have download the libid3tag-0.15.1b.tar.gz file, you need to build the lib file and link that library file to your project. Or you can simply use the lib file contained in the zip file.

Finally, to use CMP3ID3:

   
  CMP3ID3 mp3ID3;
  //Prepare MP3 file in readonly mode
  mp3ID3.prepareMP3("c:\\1.mp3", true);
  
  ustring strTitle  = mp3ID3.getTitle();
  ustring strGenre  = mp3ID3.getGenre();
  ustring strArtist = mp3ID3.getArtist();
  ....
  //You can also retrieve id3tag using CMP3Info class
  CMP3Info mp3Info;
  
  mp3Info = mp3ID3.getMP3Info("c:\\1.mp3");
  //Your processing code
  mp3Info = mp3ID3.getMP3Info("c:\\2.mp3");
  //Your processing code
  mp3Info = mp3ID3.getMP3Info("c:\\3.mp3");
  //Your processing code
  ...

Compiler Setting

You might experience a symbol redefined error when you link your project to the libid3tag library, you can simply add /NODEFAULTLIB:LIBCD.LIB or /NODEFAULTLIB:LIBCMTD.LIB depending on your project.

Reference Link:

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here