NAME

Audio::APETags - An interface to the APE tagging structure implemented entirely in Perl.

SYNOPSIS

use Audio::APETags;
my $ape = getTags("song.flac");

$apeTags = $ape->{'tags'};

foreach (keys %{$apeTags}) {
	print "$_: $apeTags->{$_}\n";
}

DESCRIPTION

This module returns a hash containing the contents of the APE tags associated with an audio file. There is no complete list of tag keys for APE tags, as they can be defined by the user; the basic set of tags used in the Ape convention include (but will not likely all be defined for a most audio files):

Title
Subtitle
Artist
Album
Debut Album
Publisher
Conductor
Track
Composer
Comment
Copyright
Publicationright
File
EAN/UPC
ISBN
Catalog
LC
Year
Record Date
Record Location
Genre
Media
Index
Related
ISRC
Abstract
Language
Bibliography
Introplay

Associated with each key is a set of flags; these flags contain information about the editability of the tag/item as well as the type of contents.

CONSTRUCTORS

getTags ($filename)

Opens an audio file and attempts to read APE tags from the top and bottom of the file, skipping ID3 tags if present.

SEE ALSO

http://www.personal.uni-jena.de/~pfk/mpp/sv8/apetag.html

AUTHOR

Erik Reckase, <cerebusjam at hotmail dot com>, with lots of help from Dan Sully, <daniel@cpan.org>

COPYRIGHT

Copyright (c) 2003, Erik Reckase.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.2 or, at your option, any later version of Perl 5 you may have available.