| 1 | MP3::Find version 0.05 |
|---|
| 2 | ====================== |
|---|
| 3 | |
|---|
| 4 | DESCRIPTION |
|---|
| 5 | This module allows you to search for MP3 files by their ID3 tags. You |
|---|
| 6 | can ask for the results to be sorted by one or more of those tags, and |
|---|
| 7 | return either the list of filenames (the deault), a "printf"-style |
|---|
| 8 | formatted string for each file using its ID3 tags, or the actual Perl |
|---|
| 9 | data structure representing the results. |
|---|
| 10 | |
|---|
| 11 | There are currently two backends to this module: MP3::Find::Filesystem |
|---|
| 12 | and MP3::Find::DB. You choose which one you want by passing its name as |
|---|
| 13 | the argument to you "use" statement; MP3::Find will look for a |
|---|
| 14 | MP3::Find::$BACKEND module. If no backend name is given, it will default |
|---|
| 15 | to using MP3::Find::Filesystem. |
|---|
| 16 | |
|---|
| 17 | Note: I'm still working out some kinks in the DB backend, so it is |
|---|
| 18 | currently not as stable as the Filesystem backend. |
|---|
| 19 | |
|---|
| 20 | Note the second: This whole project is still in the alpha stage, so I |
|---|
| 21 | can make no guarentees that there won't be significant interface changes |
|---|
| 22 | in the next few versions or so. Also, comments about what about the API |
|---|
| 23 | rocks (or sucks!) are appreciated. |
|---|
| 24 | |
|---|
| 25 | INSTALL |
|---|
| 26 | To install this module type the following: |
|---|
| 27 | |
|---|
| 28 | perl Makefile.PL |
|---|
| 29 | make |
|---|
| 30 | make test |
|---|
| 31 | make install |
|---|
| 32 | |
|---|
| 33 | SYNOPSIS |
|---|
| 34 | # select with backend you want |
|---|
| 35 | use MP3::Find qw(Filesystem); |
|---|
| 36 | |
|---|
| 37 | print "$_\n" foreach find_mp3s( |
|---|
| 38 | dir => '/home/peter/cds', |
|---|
| 39 | query => { |
|---|
| 40 | artist => 'ilyaimy', |
|---|
| 41 | title => 'deep in the am', |
|---|
| 42 | }, |
|---|
| 43 | ignore_case => 1, |
|---|
| 44 | exact_match => 1, |
|---|
| 45 | sort => [qw(year album tracknum)], |
|---|
| 46 | printf => '%2n. %a - %t (%b: %y)', |
|---|
| 47 | ); |
|---|
| 48 | |
|---|
| 49 | REQUIRES |
|---|
| 50 | File::Find, MP3::Info, and Scalar::Util are needed for the filesystem |
|---|
| 51 | backend (MP3::Find::Filesystem). In addition, if MP3::Tag is available, |
|---|
| 52 | you can search by explicit ID3v2 tag frames. |
|---|
| 53 | |
|---|
| 54 | DBI, DBD::SQLite, and SQL::Abstract are needed for the database backend |
|---|
| 55 | (MP3::Find::DB). |
|---|
| 56 | |
|---|
| 57 | COPYRIGHT AND LICENSE |
|---|
| 58 | Copyright (c) 2006 by Peter Eichman. All rights reserved. |
|---|
| 59 | |
|---|
| 60 | This program is free software; you can redistribute it and/or modify it |
|---|
| 61 | under the same terms as Perl itself. |
|---|
| 62 | |
|---|
