The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

AudioFile::Find - Finds audio files located on your system and maps them to AudioFile::Info objects.

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 whether a given AudioFile::Info object meets given criteria. First argument is the AudioFile::Info object, second argument is a reference to the criteria hash.

extensions

Discovers the extensions that are supported by the installed AudioFile::Info plugins.

AUTHORS

Markus, <holli.holzer at googlemail.com>
Joel Berger joel.a.berger@gmail.com

SOURCE REPOSITORY

http://github.com/jberger/AudioFile-Find

BUGS

Bugs may be reported to:

http://github.com/jberger/AudioFile-Find/issues
http://rt.cpan.org/NoAuth/ReportBug.html?Queue=AudioFile-Find

COPYRIGHT & LICENSE

Copyright 2008-2014 by Authors listed above, all rights reserved.

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