bbJewel Man Page

NAME

bbJewel - A small script to print jewel case inlets from MP3 files

VERSION

This documentation refers to version 1.0

SYNOPSIS

bbJewel [options] [MP3 file] ...

DESCRIPTION

bbJewel will print a jewel case cover, it'll actually create a PDF with the cover, for the listed MP3 files. It'll parse each file and extract title, artist and length of the recording. It'll also scan the files for included cover images.

The titles will be listed in the order they are given on the command line. The first cover image found will be taken for printing.

bbJewel understands the following options:

-h --help

Give a short usage message

-i --image <file name>

Use file as cover image. Should be of a type GD understands (jpg, gif, png are save). If no image is given, bbJewel will look into the MP3 files for embedded images. The first image found will be used. If no image is found and no image is given on the commandline, no image will be printed and the front side of the cover will be empty.

-o --output <file name>

Output (PDF) file name. Defaults to CDCover.pdf. You need to specify the full file name, including extension.

-t --title <string>

Title for playlist. If no title is given, bbJewel will check if all titles are of the same artist and from the same album. If this is the case, the title will be 'Artist/Album'.

If there are different artists, but the album is the same for all titles, the album name will be used.

If the artist is the same for all titles, but the album is different, the artist name will be used.

If the titles have different artists and album names, the string 'Compilation' will be used.

DEPENDENCIES

The following CPAN modules are required to run bbJewel:

• utf8
• version
• MP3::Info
• MP3::Tag
• Getopt::Long
• PDF::API2
• GD::Image
• Readonly

BUGS AND LIMITATIONS

The duration of a title is sometimes printed wrong.

AUTHOR

Written by Bodo Bauer <bb@bb-zone.com>

REPORTING BUGS

Report bugs to <bb@bb-zone.com>

LICENSE AND COPYRIGHT

Copyright (c) 2008 Bodo Bauer. License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html> This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.