Audio::APE(3pm)

💖 Audio::APE 💖

okay bestie, welcome to Audio::APE — she's the User Contributed Perl Documentation girlie who gives you a whole object-oriented interface to Monkey's Audio file info and the APE tag fields inside it. no cap. 🐒🎧

---

✨ NAME ✨

Audio::APE — an object-oriented interface to Monkey's Audio file information and APE tag fields.

like. that's her whole job. she reads your .ape file and tells you what's inside. iconic behaviour honestly.

---

🌸 SYNOPSIS 🌸

use Audio::APE;
my $mac = Audio::APE->new("song.ape");

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

my $macTags = $mac->tags();

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

so you make a new object with your filename, you loop over the keys, you print them, then you grab the tags and do it all over again. it's giving main character energy and it literally could not be simpler. 💅

---

🦋 DESCRIPTION 🦋

this module hands you back a hash with the basic deets about a Monkey's Audio file, plus all the tag info living inside that file's APE tags. that's it, that's the vibe. ✨

---

🎀 CONSTRUCTORS 🎀

• new( $filename ) — opens up a Monkey's Audio file, makes sure it actually exists and is genuinely a Monkey's Audio stream, and then loads the information and comment fields. she does her vibe check first, no worries. 🫶

---

👑 INSTANCE METHODS 👑

• info( [$key] ) — returns a hashref with all the info about the Monkey's Audio file, straight from the file's information header.

that optional key param? it lets you pull one single value out of the info hash instead of the whole thing. and if that key doesn't exist, you get back undef. yeah. undef. 😭

• tags( [$key] ) — returns a hashref with the tag keys and values from the file's APE tags.

same deal with the optional key — grab one value from the tag hash, and if the key isn't there you get undef. periodt. 💅

---

💀 NOTE 💀

heads up bestie: this module is now a wrapper around Audio::Scan. so like, that's where the actual work happens. iykyk. 🙈

---

🌈 SEE ALSO 🌈

<http://www.monkeysaudio.com/>, Audio::Scan

go check them out fr fr. ⭐

---

💜 AUTHOR 💜

Dan Sully, <daniel@cpan.org>

Kevin Deane-Freeman, <kevindf at shaw dot ca>, based on other work by Erik Reckase, <cerebusjam at hotmail dot com>, and Dan Sully, <daniel@cpan.org>

---

🍓 COPYRIGHT 🍓

Copyright (c) 2004, Kevin Deane-Freeman. Copyright (c) 2005-2007, Dan Sully & Slim Devices. Copyright (c) 2007-2010, Dan Sully.

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.

---

and that's the whole page, babe 🧚 — this little beauty is running under perl v5.36.0, dated 2022-11-19, and it's the Audio::APE(3pm) era. slay, stay hydrated, and go read your tags. 💖✨