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.

SEE ALSO

MP3::Find, MP3::Find::DB

AUTHOR

Peter Eichman <peichman@cpan.org>

COPYRIGHT AND LICENSE

Copyright (c) 2006 by Peter Eichman. All rights reserved.

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