NAME

Astroboy::API - organize mp3s on disk by id3 tags

SYNOPSIS

   use Astroboy;

   my $a = Astroboy->new;
   $a->abs_music('/home/myself/music');

   my $album = $a->dir('/home/myself/music_incoming/album1');

   $album->artist;
   $album->files;

DESCRIPTION

Astroboy is meant to be used via the command line. See astroboy.

METHODS

new()

dir()

Argument is path to directory. Returns Astroboy::AlbumDir object.

file()

Argument is path to file. Returns Astroboy::AlbumFile object.

errstr()

Astroboy::Base

artists()

Simply returns names of subdirs in ABS_MUSIC.

artists_count()

Returns number.

artist_guess()

Argument is a string, a filename, or a path. Tries to guess what artist it is. Uses artists currently listed in ABS MUSIC.

debug()

abs_music()

Perl setget method. Argument is abs path to music. Default is $ENV{HOME}/music. Same as $Astroboy::ABS_MUSIC, but as method.

$Astroboy::DEBUG

$Astroboy::ABS_MUSIC

CAVEATS

Do not use the api, use the cli. In development. Contact AUTHOR for suggestions, concerns, etc.

AUTHOR

Leo Charre leocharre at cpan dot org

LICENSE

This package is free software; you can redistribute it and/or modify it under the same terms as Perl itself, i.e., under the terms of the "Artistic License" or the "GNU General Public License".

DISCLAIMER

This package is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

See the "GNU General Public License" for more details.

cpanm Astroboy

perl -MCPAN -e shell
install Astroboy