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


MP3-Find documentation  | view source Contained in the MP3-Find distribution.

Index


NAME

Top

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

SYNOPSIS

Top

    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

Top

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

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

DESCRIPTION

Top

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

Top

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

AUTHOR

Top

Peter Eichman <peichman@cpan.org>

COPYRIGHT AND LICENSE

Top


MP3-Find documentation  | view source Contained in the MP3-Find distribution.