MP3::T...2_Data(3pm)

💖 MP3::Tag::ID3v2_Data — get_frame() data format and supported frames 🎀

okay bestie, welcome to the glow-up doc for MP3::Tag::ID3v2_Data, straight out of the User Contributed Perl Documentation section of your local man pages. this is the page that tells you what you actually get back when you call get_frame on an MP3::Tag::ID3v2 object. no cap. 🦋

---

✨ SYNOPSIS ✨

$mp3 = MP3::Tag->new($filename);
$mp3->get_tags();
$id3v2 = $mp3->{ID3v2} if exists $mp3->{id3v2};

($info, $long) = $id3v2->get_frame($id);    # or

($info, $long) = $id3v2->get_frame($id, 'raw');

that's the whole vibe. two little values, $info and $long, and they're about to change your life (or at least your tag-reading code). 💅

---

🌸 DESCRIPTION 🌸

this document describes how to use the results of the get_frame function of MP3::Tag::ID3v2, thus the data format of frames retrieved with MP3::Tag::ID3v2::get_frame().

it also contains a list of all supported ID3v2-Frames. yes, all of them. we're not gatekeeping. 🔥

🎀 get_frame() 🎀

($info, $long) = $id3v2->get_frame($id);    # or

($info, $long) = $id3v2->get_frame($id, 'raw');

$id has to be a name of a frame like "APIC". for more variants of calling, see get_frame().

and listen — the names of all frames found in a tag can be retrieved with the get_frame_ids() function. so you don't have to guess, bestie, you can just ask. 🙈

🔍 Using the returned data 🔍

in the ID3v2.3 specifications 73 frames are defined, which can contain very different information. that means that get_frame returns the information of different frames also in different ways. it's giving chaotic. it's giving iconic. both.

⭐ Simple Frames

a lot of the tags contain only a text string and encoding information. if you call ($info, $long) = $id3v2->get_frame($id) for such a frame, $info will contain the text string and $long will contain the english name of the frame.

example:

get_frame("TIT2");     # returns

("Birdhouse In Your Soul", "Title/songname/content description")

literally so easy. ate. 💖

🧚 Complex Frames

for more complex frames the returned $info is a reference to a hash, where each entry of the hash describes a part of the information found in the frame. the key of a hash entry contains the name of this part, the according value contains the information itself.

example:

get_frame("APIC");     # returns

( { "Description" => "Flood",
    "MIME Type" => "/image/jpeg",
    "Picture Type" => "Cover (front)",
    "_Data" => "..data of jpeg picture (binary).."
   },
  "Attached Picture");

a whole little hash, just for you. main character energy fr fr. 👑

🫶 Other Frames

some frames are not supported at the moment, ie the data found in the frame is not returned in a descriptive way. but you can read the data of this frames (and also of all other frames too) in raw mode. then the complete data field of the frame is returned, without any modifications. this means that the returned data will be almost binary data. 😭

example:

get_frame("TIT2", 'raw');    # returns

("\x00Birdhouse In Your Soul", "Title/songname/content description")

see that \x00? that's the encoding byte peeking through. raw mode does not hold back, it does not censor, it gives you the bytes exactly as they are. 💀

the frames which (in addition to "Text"/"URL") contain only "Description" and "Language" fields are in some intermediate position between "simple" and "complex" frames. they can be handled very similarly to "simple" frames by using "long names", such as COMM[description] or COMM(LANG)[description], and the corresponding "quick" API such as frame_select().

so yes, there's a lil middle ground. they're in their soft-launch era. 🍓

🌈 List of Simple Frames 🌈

following Frames are supported and return a single string (text). in the List you can find the frame IDs and the long names of the frames as returned by $id3v2->get_frame():

• IPLS : Involved people list
• MCDI : Music CD identifier
• PCNT : Play counter
• TALB : Album/Movie/Show title
• TBPM : BPM (beats per minute)
• TCOM : Composer
• TCON : Content type
• TCOP : Copyright message
• TDAT : Date
• TDLY : Playlist delay
• TDRC : Recording time
• TENC : Encoded by
• TEXT : Lyricist/Text writer
• TFLT : File type
• TIME : Time
• TIPL : Involved people list
• TIT1 : Content group description
• TIT2 : Title/songname/content description
• TIT3 : Subtitle/Description refinement
• TKEY : Initial key
• TLAN : Language(s)
• TLEN : Length
• TMCL : Musician credits list
• TMED : Media type
• TOAL : Original album/movie/show title
• TOFN : Original filename
• TOLY : Original lyricist(s)/text writer(s)
• TOPE : Original artist(s)/performer(s)
• TORY : Original release year
• TOWN : File owner/licensee
• TPE1 : Lead performer(s)/Soloist(s)
• TPE2 : Band/orchestra/accompaniment
• TPE3 : Conductor/performer refinement
• TPE4 : Interpreted, remixed, or otherwise modified by
• TPOS : Part of a set
• TPUB : Publisher
• TRCK : Track number/Position in set
• TRDA : Recording dates
• TRSN : Internet radio station name
• TRSO : Internet radio station owner
• TSIZ : Size
• TSRC : ISRC (international standard recording code)
• TSSE : Software/Hardware and settings used for encoding
• TYER : Year
• WCOM : Commercial information
• WCOP : Copyright/Legal information
• WOAF : Official audio file webpage
• WOAR : Official artist/performer webpage
• WOAS : Official audio source webpage
• WORS : Official internet radio station homepage
• WPAY : Payment
• WPUB : Publishers official webpage

52 of them. all returning one humble little string. we love consistency. 💜

🦋 List of Complex Frames 🦋

following frames are supported and return a reference to a hash. the list shows which keys can be found in the returned hash:

• AENC : Audio encryption
  • Keys: URL, Preview start, Preview length, _Data
• APIC : Attached picture
  • Keys: MIME type, Picture Type, Description, _Data
• COMM : Comments
  • Keys: Language, Description, Text
• COMR : Commercial frame
  • Keys: Price, Valid until, URL, Received as, Name of Seller, Description, MIME type, _Logo
• ENCR : Encryption method registration
  • Keys: Owner ID, Method symbol, _Data
• GEOB : General encapsulated object
  • Keys: MIME type, Filename, Description, _Data
• GRID : Group identification registration
  • Keys: Owner, Symbol, _Data
• LINK : Linked information
  • Keys: ID, URL, Text
• OWNE : Ownership frame
  • Keys: Price payed, Date of purchase, Text
• POPM : Popularimeter
  • Keys: URL, Rating, Counter
• PRIV : Private frame
  • Keys: Text, _Data
• RBUF : Recommended buffer size
  • Keys: Buffer size, Embedded info flag, Offset to next tag
• RVRB : Reverb
  • Keys: Reverb left (ms), Reverb right (ms), Reverb bounces (left), Reverb bounces (right), Reverb feedback (left to left), Reverb feedback (left to right), Reverb feedback (right to right), Reverb feedback (right to left), Premix left to right, Premix right to left
• SYTC : Synchronized tempo codes
  • Keys: Time Stamp Format, _Data
• TXXX : User defined text information frame
  • Keys: Description, Text
• UFID : Unique file identifier
  • Keys: Text, _Data
• USER : Terms of use
  • Keys: Language, Text
• USLT : Unsychronized lyric/text transcription
  • Keys: Language, Description, Text
• WXXX : User defined URL link frame
  • Keys: Description, URL

the RVRB one is lowkey a whole essay of keys and i respect it for that. 💅

💀 List of Other Frames 💀

following frames are only supported in raw mode:

• CRM : Encrypted meta frame
• EQUA : Equalization
• ETCO : Event timing codes
• LNK : Linked information
• MLLT : MPEG location lookup table
• PIC : Attached picture
• POSS : Position synchronisation frame
• RVAD : Relative volume adjustment
• SYLT : Synchronized lyric/text

raw mode is right there waiting if you need them, bestie. no frame left behind. 🫶

---

🌟 SEE ALSO 🌟

• MP3::Tag
• MP3::Tag::ID3v2

---

and that's the page!! go read some tags, slay, be free. ✨

sign-off szn 🎀 — this lil masterpiece is shipped with perl v5.36.0, dated 2022-12-30, and lives happily inside the User Contributed Perl Documentation collection. mwah. 💋