NAME

MP3::Find::Filesystem - File::Find-based backend to MP3::Find

SYNOPSIS

    use MP3::Find::Filesystem;
    my $finder = MP3::Find::Filesystem->new;
    
    my @mp3s = $finder->find_mp3s(
        dir => '/home/peter/music',
        query => {
            artist => 'ilyaimy',
            album  => 'myxomatosis',
        },
        ignore_case => 1,
    );

REQUIRES

File::Find, MP3::Info, Scalar::Util

MP3::Tag is also needed if you want to search using ID3v2 tags.

DESCRIPTION

This module implements the "search" method from MP3::Find::Base using a File::Find based search of the local filesystem.

Special Options

"exclude_path"

Scalar or arrayref; any file whose name matches any of these paths will be skipped.

"use_id3v2"

Boolean, defaults to false. If set to true, MP3::Find::Filesystem will use MP3::Tag to get the ID3v2 tag for each file. You can then search for files by their ID3v2 data, using the four-character frame names. This isn't very useful if you are just search by artist or title, but if, for example, you have made use of the "TOPE" ("Orignal Performer") frame, you could search for all the cover songs in your collection:

    $finder->find_mp3s(query => { tope => '.' });

As with the basic query keys, ID3v2 query keys are converted to uppercase internally.

AUTHOR

Peter Eichman <peichman@cpan.org>

COPYRIGHT AND LICENSE

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.