TagLookup

Introduction

TagLookup is a utility for tagging MP3s and other taggable audio file formats. It inspects a set of audio files and uses their lengths to look up an appropriate disc from a CDDB-compatible service. TagLookup can be used in two modes:

• ID — Given a CDDB ID and a number of files, look up the details of the CDDB disc from a CDDB service. Tag files using the CDDB disc. Match each file with each CDDB track using the closest track length.
• Sequence — Given a number of files, generate a CDDB ID and query a CDDB service. CDDB IDs are generated based on the sequence of tracks. Choose the closest matching CDDB disc to tag the files.

As well as this, TagLookup can:

• Rename — Rename files based on their tags.

Current Version

Current version is 0.2. Release date 2007-10-28

Supported Formats

TagLookup supports all formats that are handled by taglib. As of version taglib 1.4 these are: MP3 (ID3v1 and ID3v2), Ogg Vorbis (comments and ID3 tags) and FLAC (Vorbis comments).

Usage and Examples

• Usage
• Example — Sequence
• Example — ID

Download Source Code

• taglookup-0.2.tgz (16K)
  Source tarball
• taglookup-0.2-complete.tgz (158KB)
  Source tarball with XCode project, darcs source control, documentation, FreeBSD port and www pages.
• taglookup-0.1.tgz (12K)
  Source tarball
• taglookup-0.1-complete.tgz (133KB)
  Source tarball with XCode project, darcs source control and documentation

Download Binaries

• Mac OS X 10.3.9 PowerPC (217KB)
  Statically linked with libcddb 1.2.2 and (a patched) taglib 1.4.
• FreeBSD 6.1-RELEASE i386 (161KB)
  Statically linked with libcddb 1.2.2 and (a patched) taglib 1.4.

Depends

• libcddb — Developed against version 1.2.2
• taglib — Developed against version 1.4.

TagLib Patch

If you are having problems with genres being written as numbers (in strings), you may wish to patch taglib's id3v2tag.cpp.

Contact

Alex Allan <alex X kamaz.org.uk>

Thanks

Thanks to Scott Wheeler of the KDE Project for taglib, Kris Verbeeck for libcddb and to the freedb developers and contributors.

License and Copyright

TagLookup and this site © Copyright Alex Allan 2007. All rights reserved.

TagLookup is under the terms of a BSD-like license: TagLookup License