new

change

args hash

file

The file to operate on.

album

If this is defined, the tag is set to it.

artist

If this is defined, the tag is set to it.

comment

If this is defined, the tag is set to it.

genre

If this is defined, the tag is set to it.

title

If this is defined, the tag is set to it.

track

If this is defined, the tag is set to it.

year

If this is defined, the tag is set to it.

    $foo->change(\%args);
    if($foo->error){
        warn('Error '.$foo->error.': '.$foo->errorString);
    }

rename

One argument is taken and it is a hash ref.

The returned argument is a hash ref.

args hash ref

files

This is a array of files to rename.

template

This is the template to use for renaming a file.

The template keys are listed below.

    {$title}
    {$track}
    {$artist}
    {$album}
    {$comment}
    {$year}
    {$genre}

The default template is.

    {$artist} - {$album} ({$year}) - {$track} - {$title}.mp3

return hash ref

failed

This is a array of failed files.

padto

This pads a the track out to be this wide with zeros. By default is is 2.

To disable this, set it to 0.

success

This is true if it succeeds.

If it any thing failed, this is set to false.

    my $returned=$foo->rename(\%args);
    if ( $foo->error ||  ){

    }

show

One argument is taken and it is a hash ref.

The returned argument is a hash ref.

args hash ref

files

This is a array of files to rename.

template

This is the template to use for renaming a file.

The template keys are listed below.

    {$file}
    {$title}
    {$track}
    {$artist}
    {$album}
    {$comment}
    {$year}
    {$genre}

The default template is.

    File: {$file}
    Artist: {$artist}
    Album: {$album}
    Year: {$year}
    Track: {$track}
    Title: {$title}

return hash ref

failed

This is a array of failed files.

padto

This pads a the track out to be this wide with zeros. By default is is 2.

To disable this, set it to 0.

success

This is true if it succeeds.

If it any thing failed, this is set to false.

    my $returned=$foo->rename(\%args);
    if ( $foo->error ||  ){

    }

error

This returns a integer or undefined, Perl boolean value, indicating if a error is present or not and if it is which.

    if($foo->error){
        print "Error Code: ".$foo->error."\n";
    }

errorString

    if($foo->errorString ne ''){
        print "Error String: ".$foo->errorString."\n";
    }

errorblank

This is a internal method and there is no good reason to call it.

1

2

3

4

5

6