NAME

MP3::CreateInlayCard - create a CD inlay label for a directory of MP3 files

SYNOPSIS

    use MP3::CreateInlayCard;
    print MP3::CreateInlayCard::create_inlay(
        {dir => $dir, template => $template});
    
    # $dir is the directory containing the MP3 files.  If not specified, we'll
    # use the current directory.
    # $template is the filename of a template which HTML::Template should
    # read and populate. Alternatively, it can be a scalar reference, in which
    # case it will be taken to be the template contents to use.  If it's not
    # supplied, a simple default built-in template will be used.
    
    # If you can't be bothered to write a script to call this module, use
    # 'makeinlay.pl' distributed with this package, or just do:
    perl -MMP3::CreateInlayCard -e \
        "print MP3::CreateInlayCard(create_inlay({ (see example above)  });"
        
    # If you're in the directory containing the MP3's, and you want to use the
    # built-in default template, just supply an empty hashref:
    perl -MMP3::CreateInlayCard \
        -e "print MP3::CreateInlayCard(create_inlay({});"
        
    # or, more easily, use the eg/createinlay.pl script supplied with this
    # module.  (Perhaps copy it to somewhere in your path and rename it to
    # 'createinlay', so you can just change directory into the appropriate
    # place and type 'createinlay').
    
    

DESCRIPTION

Reads a directory of MP3s, and produces a HTML file you can print for a nice "inlay" for a CD case. Useful if you're burning a directory full of MP3s to a CD, and want an inlay label created for you.

FUNCTIONS

create_inlay

Go through the specified directory and produce the inlay.

Takes a hashref of:

dir

The directory containing the MP3 files

template

A scalar containing the filename of a template which HTML::Template should read and populate. Alternatively, it can be a scalar reference, in which case it will be taken to be the template contents to use. If it's not supplied, a simple default built-in template will be used.

BUGS

Probably. If you find any, let me know - raising a ticket on rt.cpan.org is the recommended way, or you can mail me directly if you prefer.

This module assumes that tracks will be written to the CD in the order they appear in the directory.

AUTHOR

David Precious, <davidp@preshweb.co.uk>

All bug reports, feature requests, patches etc welcome.

COPYRIGHT AND LICENSE

Copyright (C) 2008-2009 by David Precious

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.0 or, at your option, any later version of Perl 5 you may have available.