CoverHog

Home | Download | Changelog | Forums | Patches | Feature Requests | Bugs

What is CoverHog?

CoverHog is a command line utility that will fetch album cover art from the internet for MP3 files with valid ID3 tags.


More Details...

CoverHog will search amazon.com for a CD using info from the MP3's ID3 tags. The Album Title and Artist fields are required in the ID3 tag. The script will search once using the artist name and once more using the artist name and the album title. The two sets of results are then compared and the first match found is used to fetch the image.

If a directory is passed instead of a filename, the script will do a recursive sweep and check every MP3 file found. If a cover with the same name already exists in a directory, the search is aborted for the current MP3.


Download

CoverHog is hosted by SourceForge.net and can be downloaded from the project's File Section.

Although the program is written in perl, an EXE is provided for those who don't have perl installed.


Usage

perl: perl CoverHog.pl -i file_or_directory [options]
exe: CoverHog -i file_or_directory [options]

 -i file_or_directory : REQUIRED - MP3 file or directory to get cover(s) for
 -o output_filename   : output jpg file name [Default: cover.jpg]
 -v                   : verbose mode

Example 1 - Find the cover for Divided_Sky.mp3 in the same directory as CoverHog:
  a) perl: perl CoverHog.pl -i Divided_Sky.mp3
  b) exe: CoverHog -i Divided_Sky.mp3
Example 2 - Find the cover for Divided_Sky.mp3 using the full path to the directory and saving as album.jpg:
  a) perl: perl CoverHog.pl -i /Path/To/MusicDir/Divided_Sky.mp3 -o album.jpg
  b) exe: CoverHog -i /Path/To/MusicDir/Divided_Sky.mp3 -o album.jpg
Example 3 - Find covers for all MP3 files under the /Music/ directory:
  a) perl: perl CoverHog.pl -i /Music/
  b) exe: CoverHog -i /Music/


Note:CoverHog runs a little slow in batch mode due to all the searches and parsing involved. I kick it off before bed and let it run.


Copyright © 2004 Jeff Hoover
This program is released under the GNU General Public License