/ 
AudioFile-Find-0.01
River stage zero No dependents
/ AudioFile::Find

NAME

AudioFile::Find - Find Audiofiles located on your harddisk. Supports MP3, WMA and Ogg Vorbis files.

VERSION

Version 0.01

SYNOPSIS

    use AudioFile::Find;

    my $finder = AudioFile::Find->new( 'some/dir' );
    
	# find everything
	my @audiofiles = $finder->search();
	
	# specify a search directory
	my @audiofiles = $finder->search( 'some/other/dir' );
	
	#same for genre, title, track, artist and album
	my @audiofiles = $finder->search( artist => 'Seeed' ); 
	
	#search using a regex
	my @audiofiles = $finder->search( 'some/other/dir', title => qr/Ding/ ); 
	
	# anonymous subroutine that returns true or false
	my @audiofiles = $finder->search( 'some/other/dir', track => sub { return shift > 10; } );

METHODS

new

Creates an object of this class. Takes an optional single argument which is the directory to search in.

new

Sets and returns the directory to search.

Starts the search and returns a hash of filenames as keys and AudioFile::Info-Objects as values. You may specify a search directory as the first argument and also pass a hash with search criteria. See the synopsis for details.

pass

Checks wether a given AudioFile::Info-Object meets given criteria. First argument is the Info-Object, second argument is a reference to the criteria hash.

AUTHOR

Markus, <holli.holzer at googlemail.com>

BUGS

Please report any bugs or feature requests to bug-audiofile-find at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=AudioFile-Find. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc AudioFile::Find

You can also look for information at:

ACKNOWLEDGEMENTS

COPYRIGHT & LICENSE

Copyright 2008 Markus 'holli' Holzer, all rights reserved.

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