Peter Eichman > MP3-Find > MP3::Find::Filesystem

Download:
MP3-Find-0.07.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Source  

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.

syntax highlighting: