<?xml version="1.0" encoding="UTF-8"?>
<ufwb version="1.17">
<grammar name="MP3" start="id:1999" author="Andreas Pehnack" email="andreas@synalysis.com" fileextension="mp3" uti="public.mp3">
<description>Grammar for MP3 files</description>
<structure name="MP3 file" id="1999" encoding="ISO_8859-1:1987" endian="big" signed="no">
<structure name="ID3" id="2000" repeatmin="0" order="variable">
<structref name="ID3V2.0" id="2002" repeatmin="0" structure="id:2001"/>
<structref name="ID3v2.3" id="2004" repeatmin="0" structure="id:2003"/>
</structure>
<structure name="Frames" id="2006" repeatmax="-1" order="variable">
<structref name="Frame" id="2008" repeatmin="0" structure="id:2007"/>
<structref name="ID3v1" id="2010" repeatmin="0" structure="id:2009"/>
<number name="Padding" id="2011" repeatmin="0" type="integer" length="1"/>
</structure>
</structure>
<structure name="MPEG Audio Frame Frame" id="2007" encoding="ISO_8859-1:1987" endian="big" signed="no">
<number name="Frame sync" mustmatch="yes" id="2014" fillcolor="FF2F92" type="integer" length="11" lengthunit="bit" display="hex">
<fixedvalues>
<fixedvalue name="SYNC" value="0x7FF"/>
</fixedvalues>
</number>
<number name="MPEG Audio version ID" id="2015" type="integer" length="2" lengthunit="bit">
<fixedvalues>
<fixedvalue name="MPEG Version 2.5" value="0"/>
<fixedvalue name="reserved" value="1"/>
<fixedvalue name="MPEG Version 2 (ISO/IEC 13818-3)" value="2"/>
<fixedvalue name="MPEG Version 1 (ISO/IEC 11172-3)" value="3"/>
</fixedvalues>
</number>
<number name="Layer description" id="2016" type="integer" length="2" lengthunit="bit">
<fixedvalues>
<fixedvalue name="reserved" value="0"/>
<fixedvalue name="Layer III" value="1"/>
<fixedvalue name="Layer II" value="2"/>
<fixedvalue name="Layer I" value="3"/>
</fixedvalues>
</number>
<number name="Protection bit" id="2017" type="integer" length="1" lengthunit="bit">
<fixedvalues>
<fixedvalue name="Protected by CRC" value="0"/>
<fixedvalue name="Not protected" value="1"/>
</fixedvalues>
</number>
<number name="Bitrate index" id="2018" type="integer" length="4" lengthunit="bit"/>
<scriptelement name="Bitrate" id="2019">
<script name="unnamed" type="Generic">
<source language="Python">rows = 16
columns = 5
bitrateMatrix = [[0 for x in range(columns)] for y in range(rows)]
# First row
for i in range(columns):
bitrateMatrix[0][i] = "free"
# Last row
for i in range(columns):
bitrateMatrix[rows-1][i] = "bad"
bitrateMatrix[1] = "32,32,32,32,8".split(",")
bitrateMatrix[2] = "64,48,40,48,16".split(",")
bitrateMatrix[3] = "96,56,48,56,24".split(",")
bitrateMatrix[4] = "128,64,56,64,32".split(",")
bitrateMatrix[5] = "160,80,64,80,40".split(",")
bitrateMatrix[6] = "192,96,80,96,48".split(",")
bitrateMatrix[7] = "224,112,96,112,56".split(",")
bitrateMatrix[8] = "256,128,112,128,64".split(",")
bitrateMatrix[9] = "288,160,128,144,80".split(",")
bitrateMatrix[10] = "320,192,160,160,96".split(",")
bitrateMatrix[11] = "352,224,192,176,112".split(",")
bitrateMatrix[12] = "384,256,224,192,128".split(",")
bitrateMatrix[13] = "416,320,256,224,144".split(",")
bitrateMatrix[14] = "448,384,320,256,160".split(",")
# get collection with results so far
results = currentMapper.getCurrentResults()
# get bitrate index
lastResult = results.getLastResult()
versionIdResult = results.getResultByName("MPEG Audio version ID")
layerResult = results.getResultByName("Layer description")
# access the parsed values
bitrateIndexValue = lastResult.getValue()
versionIdValue = versionIdResult.getValue()
layerValue = layerResult.getValue()
# get the value parsed
bitrateIndex = bitrateIndexValue.getUnsignedNumber()
version = versionIdValue.getUnsignedNumber()
layer = layerValue.getUnsignedNumber()
column = 0
if (version == 3):
if (layer == 3):
column = 0
elif (layer == 2):
column = 1
elif (layer == 1):
column = 2
elif (version == 2):
if (layer == 3):
column = 3
else:
column = 4
bitrate = bitrateMatrix[bitrateIndex][column] + " kbit"
value = Value()
value.setString(bitrate)
# element = currentMapper.getCurrentElement()
element = Element(ELEMENT_STRING, "Bitrate", True)
# add element with value to results
results.addElement(element, 0, 0, value)
</source>
</script>
</scriptelement>
<number name="Sampling rate frequency index" id="2020" fillcolor="72FCD5" type="integer" length="2" lengthunit="bit"/>
<scriptelement name="Sampling rate" id="2021">
<script name="unnamed" type="Generic">
<source language="Python">rows = 4
columns = 3
samplingRateMatrix = [[0 for x in range(columns)] for y in range(rows)]
samplingRateMatrix[0] = "44100,22050,11025".split(",")
samplingRateMatrix[1] = "48000,24000,12000".split(",")
samplingRateMatrix[2] = "32000,16000,8000".split(",")
samplingRateMatrix[3] = "reserv.,reserv.,reserv.".split(",")
# get collection with results so far
results = currentMapper.getCurrentResults()
# get sampling rate index
lastResult = results.getLastResult()
versionIdResult = results.getResultByName("MPEG Audio version ID")
# access the parsed values
samplingRateIndexValue = lastResult.getValue()
versionIdValue = versionIdResult.getValue()
# get the value parsed
samplingRateIndex = samplingRateIndexValue.getUnsignedNumber()
version = versionIdValue.getUnsignedNumber()
column = 0
if (version == 3):
column = 0
elif (version == 2):
column = 1
else:
column = 2
samplingRate = samplingRateMatrix[samplingRateIndex][column] + " Hz"
print(samplingRate)
value = Value()
value.setString(samplingRate)
# element = currentMapper.getCurrentElement()
element = Element(ELEMENT_STRING, "Sampling rate", True)
# add element with value to results
results.addElement(element, 0, 0, value)
</source>
</script>
</scriptelement>
<number name="Padding bit" id="2022" type="integer" length="1" lengthunit="bit"/>
<number name="Private bit" id="2023" type="integer" length="1" lengthunit="bit"/>
<number name="Channel Mode" id="2024" type="integer" length="2" lengthunit="bit">
<fixedvalues>
<fixedvalue name="Stereo" value="0"/>
<fixedvalue name="Joint Stereo" value="1"/>
<fixedvalue name="Dual channel (Stereo)" value="2"/>
<fixedvalue name="Single channel (Mono)" value="3"/>
</fixedvalues>
</number>
<number name="Mode extension" id="2025" type="integer" length="2" lengthunit="bit"/>
<number name="Copyright" id="2026" fillcolor="FF7D78" type="integer" length="1" lengthunit="bit">
<fixedvalues>
<fixedvalue name="Audio is not copyrighted" value="0"/>
<fixedvalue name="Audio is copyrighted" value="1"/>
</fixedvalues>
</number>
<number name="Original" id="2027" type="integer" length="1" lengthunit="bit">
<fixedvalues>
<fixedvalue name="Copy of original media" value="0"/>
<fixedvalue name="Original media" value="1"/>
</fixedvalues>
</number>
<number name="Emphasis" id="2028" type="integer" length="2" lengthunit="bit">
<fixedvalues>
<fixedvalue name="none" value="0"/>
<fixedvalue name="50/15 ms" value="1"/>
<fixedvalue name="reserved" value="2"/>
<fixedvalue name="CCIT J.17" value="3"/>
</fixedvalues>
</number>
<scriptelement name="ParseCRC" id="2029">
<script name="unnamed" type="Generic">
<source language="Python"># get collection with results so far
results = currentMapper.getCurrentResults()
# get protection bit
protectionBitResult = results.getResultByName("Protection bit")
# access the parsed values
protectionBitValue = protectionBitResult.getValue()
# get the value parsed
protectionBit = protectionBitValue.getUnsignedNumber()
if (protectionBit == 0):
element = Element(ELEMENT_NUMBER, "CRC", True)
element.setLength("2", LENGTH_UNIT_BYTES)
element.setNumberDisplayType(NUMBER_DISPLAY_HEX)
currentMapper.mapElementWithSize(element, 2)
</source>
</script>
</scriptelement>
<scriptelement name="Length" id="2030">
<script name="unnamed" type="Generic">
<source language="Python"># get collection with results so far
results = currentMapper.getCurrentResults()
# get bitrate index
bitrateResult = results.getResultByName("Bitrate")
samplingRateResult = results.getResultByName("Sampling rate")
layerResult = results.getResultByName("Layer description")
paddingResult = results.getResultByName("Padding bit")
# access the parsed values
bitrateValue = bitrateResult.getValue()
samplingRateValue = samplingRateResult.getValue()
layerValue = layerResult.getValue()
paddingValue = paddingResult.getValue()
# get the value parsed
bitrate = bitrateValue.getUnsignedNumber() * 1000
samplingRate = samplingRateValue.getUnsignedNumber()
layer = layerValue.getUnsignedNumber()
paddingBit = paddingValue.getUnsignedNumber()
if (samplingRate < 1):
print("Sampling rate is negative")
frameLengthInBytes = 0
padding = 0
if (layer == 3):
if (paddingBit == 1):
padding = 4
frameLengthInBytes = (12 * bitrate // samplingRate + padding) * 4 - 4
else:
if (paddingBit == 1):
padding = 1
frameLengthInBytes = 144 * bitrate // samplingRate + padding - 4
if (frameLengthInBytes < 0):
print("Frame length not positive")
value = Value()
value.setUnsigned(frameLengthInBytes)
element = Element(ELEMENT_NUMBER, "Length", True)
# add element with value to results
results.addElement(element, 0, 0, value)
</source>
</script>
</scriptelement>
<binary name="FrameData" id="2031" fillcolor="72FA78" length="Length"/>
</structure>
<structure name="ID3v1" id="2009" encoding="ISO_8859-1:1987" endian="big" signed="no">
<string name="Identifier" mustmatch="yes" id="2033" fillcolor="FF40FF" type="fixed-length" length="3">
<fixedvalues>
<fixedvalue name="TAG" value="TAG"/>
</fixedvalues>
</string>
<string name="Title" id="2034" fillcolor="FF7D78" type="fixed-length" length="30"/>
<string name="Artist" id="2035" fillcolor="FF89D8" type="fixed-length" length="30"/>
<string name="Album" id="2036" fillcolor="75D5FF" type="fixed-length" length="30"/>
<string name="Year" id="3994" fillcolor="FEFC78" type="fixed-length" length="4"/>
<string name="Comment" id="2038" fillcolor="73FDFF" type="fixed-length" length="30"/>
<number name="Genre" id="2039" fillcolor="7980FF" type="integer" length="1">
<fixedvalues>
<fixedvalue name="Blues" value="0"/>
<fixedvalue name="Classic Rock" value="1"/>
<fixedvalue name="Country" value="2"/>
<fixedvalue name="Dance" value="3"/>
<fixedvalue name="Disco" value="4"/>
<fixedvalue name="Func" value="5"/>
<fixedvalue name="Grunge" value="6"/>
<fixedvalue name="Hip-Hop" value="7"/>
<fixedvalue name="Jazz" value="8"/>
<fixedvalue name="Metal" value="9"/>
<fixedvalue name="New Age" value="10"/>
<fixedvalue name="Oldies" value="11"/>
<fixedvalue name="Other" value="12"/>
<fixedvalue name="Pop" value="13"/>
<fixedvalue name="R&B" value="14"/>
<fixedvalue name="Rap" value="15"/>
<fixedvalue name="Reggae" value="16"/>
<fixedvalue name="Rock" value="17"/>
<fixedvalue name="Techno" value="18"/>
<fixedvalue name="Industrial" value="19"/>
<fixedvalue name="Alternative" value="20"/>
<fixedvalue name="Ska" value="21"/>
<fixedvalue name="Death Metal" value="22"/>
<fixedvalue name="Pranks" value="23"/>
<fixedvalue name="Soundtrack" value="24"/>
<fixedvalue name="Euro-Techno" value="25"/>
<fixedvalue name="Ambient" value="26"/>
<fixedvalue name="Trip-Hop" value="27"/>
<fixedvalue name="Vocal" value="28"/>
<fixedvalue name="Jazz+Funk" value="29"/>
<fixedvalue name="Fusion" value="30"/>
<fixedvalue name="Trance" value="31"/>
<fixedvalue name="Classical" value="32"/>
<fixedvalue name="Instrumental" value="33"/>
<fixedvalue name="Acid" value="34"/>
<fixedvalue name="House" value="35"/>
<fixedvalue name="Game" value="36"/>
<fixedvalue name="Sound Clip" value="37"/>
<fixedvalue name="Gospel" value="38"/>
<fixedvalue name="Noise" value="39"/>
<fixedvalue name="AlternRock" value="40"/>
<fixedvalue name="Bass" value="41"/>
<fixedvalue name="Soul" value="42"/>
<fixedvalue name="Punk" value="43"/>
<fixedvalue name="Space" value="44"/>
<fixedvalue name="Meditative" value="45"/>
<fixedvalue name="Instrumental Pop" value="46"/>
<fixedvalue name="Instrumental Rock" value="47"/>
<fixedvalue name="Ethnic" value="48"/>
<fixedvalue name="Gothic" value="49"/>
<fixedvalue name="Darkwave" value="50"/>
<fixedvalue name="Techno-Industrial" value="51"/>
<fixedvalue name="Electronic" value="52"/>
<fixedvalue name="Pop-Folk" value="53"/>
<fixedvalue name="Eurodance" value="54"/>
<fixedvalue name="Dream" value="55"/>
<fixedvalue name="Southern Rock" value="56"/>
<fixedvalue name="Comedy" value="57"/>
<fixedvalue name="Cult" value="58"/>
<fixedvalue name="Gangsta" value="59"/>
<fixedvalue name="Top 40" value="60"/>
<fixedvalue name="Christian Rap" value="61"/>
<fixedvalue name="Pop/Funk" value="62"/>
<fixedvalue name="Jungle" value="63"/>
<fixedvalue name="Native American" value="64"/>
<fixedvalue name="Cabaret" value="65"/>
<fixedvalue name="New Wave" value="66"/>
<fixedvalue name="Psychadelic" value="67"/>
<fixedvalue name="Rave" value="68"/>
<fixedvalue name="Showtunes" value="69"/>
<fixedvalue name="Trailer" value="70"/>
<fixedvalue name="LoFi" value="71"/>
<fixedvalue name="Tribal" value="72"/>
<fixedvalue name="Acid Punk" value="73"/>
<fixedvalue name="Acid Jazz" value="74"/>
<fixedvalue name="Polka" value="75"/>
<fixedvalue name="Retro" value="76"/>
<fixedvalue name="Musical" value="77"/>
<fixedvalue name="Rock & Roll" value="78"/>
<fixedvalue name="Hard Rock" value="79"/>
<fixedvalue name="Folk" value="80"/>
<fixedvalue name="Folk-Rock" value="81"/>
<fixedvalue name="National Folk" value="82"/>
<fixedvalue name="Swing" value="83"/>
<fixedvalue name="Fast Fusion" value="84"/>
<fixedvalue name="Bebob" value="85"/>
<fixedvalue name="Latin" value="86"/>
<fixedvalue name="Revival" value="87"/>
<fixedvalue name="Celtic" value="88"/>
<fixedvalue name="Bluegrass" value="89"/>
<fixedvalue name="Avantgarde" value="90"/>
<fixedvalue name="Gothic Rock" value="91"/>
<fixedvalue name="Progressive Rock" value="92"/>
<fixedvalue name="Psychedelic Rock" value="93"/>
<fixedvalue name="Symphonic Rock" value="94"/>
<fixedvalue name="Slow Rock" value="95"/>
<fixedvalue name="Big Band" value="96"/>
<fixedvalue name="Chorus" value="97"/>
<fixedvalue name="Easy Listening" value="98"/>
<fixedvalue name="Acoustic" value="99"/>
<fixedvalue name="Humour" value="100"/>
<fixedvalue name="Speech" value="101"/>
<fixedvalue name="Chanson" value="102"/>
<fixedvalue name="Opera" value="103"/>
<fixedvalue name="Chamber Music" value="104"/>
<fixedvalue name="Sonata" value="105"/>
<fixedvalue name="Symphony" value="106"/>
<fixedvalue name="Booty Brass" value="107"/>
<fixedvalue name="Primus" value="108"/>
<fixedvalue name="Porn Groove" value="109"/>
<fixedvalue name="Satire" value="110"/>
<fixedvalue name="Slow Jam" value="111"/>
<fixedvalue name="Club" value="112"/>
<fixedvalue name="Tango" value="113"/>
<fixedvalue name="Samba" value="114"/>
<fixedvalue name="Folklore" value="115"/>
<fixedvalue name="Ballad" value="116"/>
<fixedvalue name="Power Ballad" value="117"/>
<fixedvalue name="Rhythmic Soul" value="118"/>
<fixedvalue name="Freestyle" value="119"/>
<fixedvalue name="Duet" value="120"/>
<fixedvalue name="Punk Rock" value="121"/>
<fixedvalue name="Drum Solo" value="122"/>
<fixedvalue name="A Capela" value="123"/>
<fixedvalue name="Euro-House" value="124"/>
<fixedvalue name="Dance Hall" value="125"/>
</fixedvalues>
</number>
</structure>
<structure name="ID3v2" id="2041" encoding="ISO_8859-1:1987" endian="big" signed="no">
<string name="Identifier" mustmatch="yes" id="2042" type="fixed-length" length="3">
<fixedvalues>
<fixedvalue name="ID3" value="ID3"/>
</fixedvalues>
</string>
<number name="Major version" mustmatch="yes" id="2043" type="integer" length="1"/>
<number name="Minor version" mustmatch="yes" id="2044" type="integer" length="1"/>
</structure>
<structure name="ID3V2.0" id="2001" length="0" extends="id:2041">
<number name="Major version" id="2047" type="integer">
<fixedvalues>
<fixedvalue name="2" value="2"/>
</fixedvalues>
</number>
<number name="Minor version" id="2048" type="integer">
<fixedvalues>
<fixedvalue name="0" value="0"/>
</fixedvalues>
</number>
<number name="Unsynchronisation" id="2049" type="integer" length="1" lengthunit="bit"/>
<number name="Compression" id="2050" type="integer" length="1" lengthunit="bit"/>
<number name="OtherFlags" id="2051" type="integer" length="6" lengthunit="bit"/>
<number name="RawSize" id="2052" type="integer" length="32" lengthunit="bit"/>
<scriptelement name="Size" id="2053">
<script name="unnamed" type="Generic">
<source language="Python">size = 4
# get collection with results so far
results = currentMapper.getCurrentResults()
lastResult = results.getLastResult()
# access the parsed value
value = lastResult.getValue()
# get the value parsed
number = value.getUnsignedNumber()
decodedNumber = (number & 0x7F) + ((number & 0x7F00) >> 1) + ((number & 0x7F0000) >> 2) + ((number & 0x7F000000) >> 3)
print(number)
print(decodedNumber)
value = Value()
value.setUnsigned(decodedNumber)
# element = currentMapper.getCurrentElement()
element = Element(ELEMENT_NUMBER, "Size", True)
# add element with value to results
results.addElement(element, size, 0, value)
</source>
</script>
</scriptelement>
<structure name="Frames" id="2054" length="Size">
<structure name="Switch" id="2055" repeatmax="-1" order="variable">
<structref name="BUF Frame - Recommended buffer size" id="2057" repeatmin="0" structure="id:2056"/>
<structref name="CNT Frame - Play counter" id="2059" repeatmin="0" structure="id:2058"/>
<structref name="COM Frame - Comments" id="2061" repeatmin="0" structure="id:2060"/>
<structref name="CRA Frame - Audio encryption" id="2063" repeatmin="0" structure="id:2062"/>
<structref name="CRM Frame - Encrypted meta frame" id="2065" repeatmin="0" structure="id:2064"/>
<structref name="ETC Frame - Event timing codes" id="2067" repeatmin="0" structure="id:2066"/>
<structref name="EQU Frame - Equalisation" id="2069" repeatmin="0" structure="id:2068"/>
<structref name="GEO Frame - General encapsulated object" id="2071" repeatmin="0" structure="id:2070"/>
<structref name="IPL Frame - Involved people list" id="2073" repeatmin="0" structure="id:2072"/>
<structref name="LNK Frame - Linked information" id="2075" repeatmin="0" structure="id:2074"/>
<structref name="MCI Frame - Music CD Identifier" id="2077" repeatmin="0" structure="id:2076"/>
<structref name="MLL Frame - MPEG location lookup table" id="2079" repeatmin="0" structure="id:2078"/>
<structref name="PIC Frame - Attached picture" id="2081" repeatmin="0" structure="id:2080"/>
<structref name="POP Frame - Popularimeter" id="2083" repeatmin="0" structure="id:2082"/>
<structref name="REV Frame - Reverb" id="2085" repeatmin="0" structure="id:2084"/>
<structref name="RVA Frame - Relative volume adjustment" id="2087" repeatmin="0" structure="id:2086"/>
<structref name="SLT Frame - Synchronised lyrics/text" id="2089" repeatmin="0" structure="id:2088"/>
<structref name="STC Frame - Synced tempo codes" id="2091" repeatmin="0" structure="id:2090"/>
<structref name="TAL Frame - Album/Movie/Show title" id="2093" repeatmin="0" structure="id:2092"/>
<structref name="TBP Frame - BPM (Beats Per Minute)" id="2095" repeatmin="0" structure="id:2094"/>
<structref name="TCM Frame - Composer(s)" id="2097" repeatmin="0" structure="id:2096"/>
<structref name="TCO Frame - Content type" id="2099" repeatmin="0" structure="id:2098"/>
<structref name="TCR Frame - Copyright message" id="2101" repeatmin="0" structure="id:2100"/>
<structref name="TDA Frame - Date" id="2103" repeatmin="0" structure="id:2102"/>
<structref name="TDY Frame - Playlist delay" id="2105" repeatmin="0" structure="id:2104"/>
<structref name="TEN Frame - Encoded by" id="2107" repeatmin="0" structure="id:2106"/>
<structref name="TFT Frame - File type" id="2109" repeatmin="0" structure="id:2108"/>
<structref name="TIM Frame - Time" id="2111" repeatmin="0" structure="id:2110"/>
<structref name="TKE Frame - Initial key" id="2113" repeatmin="0" structure="id:2112"/>
<structref name="TLA Frame - Language(s)" id="2115" repeatmin="0" structure="id:2114"/>
<structref name="TLE Frame - Length" id="2117" repeatmin="0" structure="id:2116"/>
<structref name="TMT Frame - Media type" id="2119" repeatmin="0" structure="id:2118"/>
<structref name="TOA Frame - Original artist(s)/performer(s)" id="2121" repeatmin="0" structure="id:2120"/>
<structref name="TOF Frame - Original filename" id="2123" repeatmin="0" structure="id:2122"/>
<structref name="TOL Frame - Original Lyricist(s)/text writer(s)" id="2125" repeatmin="0" structure="id:2124"/>
<structref name="TOR Frame - Original release year" id="2127" repeatmin="0" structure="id:2126"/>
<structref name="TOT Frame - Original album/Movie/Show title" id="2129" repeatmin="0" structure="id:2128"/>
<structref name="TP1 Frame - Lead artist(s)/Lead performer(s)/Soloist(s)/Performing group" id="2131" repeatmin="0" structure="id:2130"/>
<structref name="TP2 Frame - Band/Orchestra/Accompaniment" id="2133" repeatmin="0" structure="id:2132"/>
<structref name="TP3 Frame - Conductor" id="2135" repeatmin="0" structure="id:2134"/>
<structref name="TP4 Frame - Interpreted, remixed, or otherwise modified by" id="2137" repeatmin="0" structure="id:2136"/>
<structref name="TPA Frame - Part of a set" id="2139" repeatmin="0" structure="id:2138"/>
<structref name="TPB Frame - Publisher" id="2141" repeatmin="0" structure="id:2140"/>
<structref name="TRC Frame - ISRC (International Standard Recording Code)" id="2143" repeatmin="0" structure="id:2142"/>
<structref name="TRD Frame - Recording dates" id="2145" repeatmin="0" structure="id:2144"/>
<structref name="TRK Frame - Track number/Position in set" id="2147" repeatmin="0" structure="id:2146"/>
<structref name="TSA Frame - Album Sort" id="2149" repeatmin="0" structure="id:2148"/>
<structref name="TS2 Frame - Album Artist Sort" id="2151" repeatmin="0" structure="id:2150"/>
<structref name="TSC Frame - Composer Sort" id="2153" repeatmin="0" structure="id:2152"/>
<structref name="TSI Frame - Size" id="2155" repeatmin="0" structure="id:2154"/>
<structref name="TSP Frame - Artist Sort" id="2157" repeatmin="0" structure="id:2156"/>
<structref name="TSS Frame - Software/hardware and settings used for encoding" id="2159" repeatmin="0" structure="id:2158"/>
<structref name="TST Frame - Title Sort" id="2161" repeatmin="0" structure="id:2160"/>
<structref name="TT1 Frame - Content group description" id="2163" repeatmin="0" structure="id:2162"/>
<structref name="TT2 Frame - Title/Songname/Content description" id="2165" repeatmin="0" structure="id:2164"/>
<structref name="TT3 Frame - Subtitle/Description refinement" id="2167" repeatmin="0" structure="id:2166"/>
<structref name="TXT Frame - Lyricist(s)/text writer(s)" id="2169" repeatmin="0" structure="id:2168"/>
<structref name="TXX Frame - User defined text information frame" id="2171" repeatmin="0" structure="id:2170"/>
<structref name="TYE Frame - Year" id="2173" repeatmin="0" structure="id:2172"/>
<structref name="UFI Frame - Unique file identifier" id="2175" repeatmin="0" structure="id:2174"/>
<structref name="ULT Frame - Unsychronised lyrics/text transcription" id="2177" repeatmin="0" structure="id:2176"/>
<structref name="ULT Frame - Unsychronised lyrics/text transcription-1" id="2178" repeatmin="0" structure="id:2176"/>
<structref name="ID3v2.0 Frame" id="2180" structure="id:2179"/>
</structure>
</structure>
</structure>
<structure name="ID3v2.3" id="2003" length="0" extends="id:2041" encoding="ISO_8859-1:1987" endian="big" signed="no">
<number name="Major version" id="2185" type="integer">
<fixedvalues>
<fixedvalue name="3" value="3"/>
</fixedvalues>
</number>
<number name="Minor version" id="2186" type="integer" length="1">
<fixedvalues>
<fixedvalue name="Version 0" value="0"/>
</fixedvalues>
</number>
<number name="Unsynchronisation" id="2187" type="integer" length="1" lengthunit="bit"/>
<number name="ExtendedHeader" id="2188" type="integer" length="1" lengthunit="bit"/>
<number name="Experimental indicator" id="2189" type="integer" length="1" lengthunit="bit"/>
<number name="Unused" id="2190" type="integer" length="5" lengthunit="bit"/>
<number name="RawSize" id="2191" type="integer" length="4" display="hex"/>
<scriptelement name="Size" id="2192">
<script name="unnamed" type="Generic">
<source language="Python">size = 4
# get collection with results so far
results = currentMapper.getCurrentResults()
lastResult = results.getLastResult()
# access the parsed value
value = lastResult.getValue()
# get the value parsed
number = value.getUnsignedNumber()
decodedNumber = (number & 0x7F) + ((number & 0x7F00) >> 1) + ((number & 0x7F0000) >> 2) + ((number & 0x7F000000) >> 3)
print(number)
print(decodedNumber)
value = Value()
value.setUnsigned(decodedNumber)
# element = currentMapper.getCurrentElement()
element = Element(ELEMENT_NUMBER, "Size", True)
# add element with value to results
results.addElement(element, size, 0, value)
</source>
</script>
</scriptelement>
<structure name="Frames" id="2193" length="Size">
<structure name="Switch" id="2194" length="0" repeatmax="-1" order="variable">
<structref name="AENC Frame - Audio encryption" id="2196" repeatmin="0" structure="id:2195"/>
<structref name="APIC Frame" id="2198" repeatmin="0" structure="id:2197"/>
<structref name="ASPI Frame - Audio seek point index" id="2200" repeatmin="0" structure="id:2199"/>
<structref name="COMM Frame - Comments" id="2202" repeatmin="0" structure="id:2201"/>
<structref name="COMR Frame - Commercial frame" id="2204" repeatmin="0" structure="id:2203"/>
<structref name="ENCR Frame - Encryption method registration" id="2206" repeatmin="0" structure="id:2205"/>
<structref name="EQUA Frame - Equalization" id="2208" repeatmin="0" structure="id:2207"/>
<structref name="EQU2 Frame - Equalisation (2)" id="2210" repeatmin="0" structure="id:2209"/>
<structref name="ETCO Frame - Event timing codes" id="2212" repeatmin="0" structure="id:2211"/>
<structref name="GEOB Frame - General encapsulated object" id="2214" repeatmin="0" structure="id:2213"/>
<structref name="GRID Frame - Group identification registration" id="2216" repeatmin="0" structure="id:2215"/>
<structref name="IPLS Frame - Involved people list" id="2218" repeatmin="0" structure="id:2217"/>
<structref name="LINK Frame - Linked information" id="2220" repeatmin="0" structure="id:2219"/>
<structref name="MLLT Frame - MPEG location lookup table" id="2222" repeatmin="0" structure="id:2221"/>
<structref name="OWNE Frame - Ownership frame" id="2224" repeatmin="0" structure="id:2223"/>
<structref name="PRIV Frame - Ownership frame" id="2226" repeatmin="0" structure="id:2225"/>
<structref name="PCNT Frame - Play counter" id="2228" repeatmin="0" structure="id:2227"/>
<structref name="POPM Frame - Popularimeter" id="2230" repeatmin="0" structure="id:2229"/>
<structref name="POSS Frame - Position synchronisation frame" id="2232" repeatmin="0" structure="id:2231"/>
<structref name="RBUF Frame - Recommended buffer size" id="2234" repeatmin="0" structure="id:2233"/>
<structref name="RVAD Frame - Relative volume adjustment" id="2236" repeatmin="0" structure="id:2235"/>
<structref name="RVA2 Frame - Relative volume adjustment (2)" id="2238" repeatmin="0" structure="id:2237"/>
<structref name="RVRB Frame - Reverb" id="2240" repeatmin="0" structure="id:2239"/>
<structref name="SEEK Frame - Seek frame" id="2242" repeatmin="0" structure="id:2241"/>
<structref name="SIGN Frame - Signature frame" id="2244" repeatmin="0" structure="id:2243"/>
<structref name="SYLT Frame - Synchronized lyric/text" id="2246" repeatmin="0" structure="id:2245"/>
<structref name="SYTC Frame - Synchronized tempo codes" id="2248" repeatmin="0" structure="id:2247"/>
<structref name="TALB Frame - Album/Movie/Show title" id="2250" repeatmin="0" structure="id:2249"/>
<structref name="TBPM Frame - BPM (beats per minute)" id="2252" repeatmin="0" structure="id:2251"/>
<structref name="TCOM Frame - Composer" id="2254" repeatmin="0" structure="id:2253"/>
<structref name="TCON Frame - Content type" id="2256" repeatmin="0" structure="id:2255"/>
<structref name="TCOP Frame - Copyright message" id="2258" repeatmin="0" structure="id:2257"/>
<structref name="TDAT Frame - Date" id="2260" repeatmin="0" structure="id:2259"/>
<structref name="TDEN Frame - Encoding time" id="2262" repeatmin="0" structure="id:2261"/>
<structref name="TDLY Frame - Playlist delay" id="2264" repeatmin="0" structure="id:2263"/>
<structref name="TDOR Frame - Original release time" id="2266" repeatmin="0" structure="id:2265"/>
<structref name="TDRC Frame - Recording time" id="2268" repeatmin="0" structure="id:2267"/>
<structref name="TDRL Frame - Release time" id="2270" repeatmin="0" structure="id:2269"/>
<structref name="TDTG Frame - Tagging time" id="2272" repeatmin="0" structure="id:2271"/>
<structref name="TENC Frame - Encoded by" id="2274" repeatmin="0" structure="id:2273"/>
<structref name="TEXT Frame - Lyricist/Text writer" id="2276" repeatmin="0" structure="id:2275"/>
<structref name="TFLT Frame - File type" id="2278" repeatmin="0" structure="id:2277"/>
<structref name="TIME Frame - Time" id="2280" repeatmin="0" structure="id:2279"/>
<structref name="TIPL Frame - Involved people list" id="2282" repeatmin="0" structure="id:2281"/>
<structref name="TIT1 Frame - Content group description" id="2284" repeatmin="0" structure="id:2283"/>
<structref name="TIT2 Frame" id="2286" repeatmin="0" structure="id:2285"/>
<structref name="TIT3 Frame - Subtitle/Description refinement" id="2288" repeatmin="0" structure="id:2287"/>
<structref name="TKEY Frame - Initial key" id="2290" repeatmin="0" structure="id:2289"/>
<structref name="TLAN Frame - Language(s)" id="2292" repeatmin="0" structure="id:2291"/>
<structref name="TLEN Frame - Length" id="2294" repeatmin="0" structure="id:2293"/>
<structref name="TMCL Frame - Musician credits list" id="2296" repeatmin="0" structure="id:2295"/>
<structref name="TMED Frame - Media type" id="2298" repeatmin="0" structure="id:2297"/>
<structref name="TMOO Frame - Mood" id="2300" repeatmin="0" structure="id:2299"/>
<structref name="TOAL Frame - Original album/movie/show title" id="2302" repeatmin="0" structure="id:2301"/>
<structref name="TOFN Frame - Original filename" id="2304" repeatmin="0" structure="id:2303"/>
<structref name="TOLY Frame - Original lyricist(s)/text writer(s)" id="2306" repeatmin="0" structure="id:2305"/>
<structref name="TOPE Frame - Original artist(s)/performer(s)" id="2308" repeatmin="0" structure="id:2307"/>
<structref name="TORY Frame - Original release year" id="2310" repeatmin="0" structure="id:2309"/>
<structref name="TOWN Frame - File owner/licensee" id="2312" repeatmin="0" structure="id:2311"/>
<structref name="TPE1 Frame" id="2314" repeatmin="0" structure="id:2313"/>
<structref name="TPE2 Frame - Band/orchestra/accompaniment" id="2316" repeatmin="0" structure="id:2315"/>
<structref name="TPE3 Frame - Conductor/performer refinement" id="2318" repeatmin="0" structure="id:2317"/>
<structref name="TPE4 Frame - Interpreted, remixed, or otherwise modified by" id="2320" repeatmin="0" structure="id:2319"/>
<structref name="TPOS Frame - Part of a set" id="2322" repeatmin="0" structure="id:2321"/>
<structref name="TPUB Frame - Publisher" id="2324" repeatmin="0" structure="id:2323"/>
<structref name="TPRO Frame - Produced notice" id="2326" repeatmin="0" structure="id:2325"/>
<structref name="TRCK Frame - Track number/Position in set" id="2328" repeatmin="0" structure="id:2327"/>
<structref name="TRDA Frame - Recording dates" id="2330" repeatmin="0" structure="id:2329"/>
<structref name="TRSN Frame - Internet radio station name" id="2332" repeatmin="0" structure="id:2331"/>
<structref name="TRSO Frame - Internet radio station owner" id="2334" repeatmin="0" structure="id:2333"/>
<structref name="TSIZ Frame - Size" id="2336" repeatmin="0" structure="id:2335"/>
<structref name="TSOA Frame - Album sort order" id="2338" repeatmin="0" structure="id:2337"/>
<structref name="TSOP Frame - Performer sort order" id="2340" repeatmin="0" structure="id:2339"/>
<structref name="TSOT Frame - Title sort order" id="2342" repeatmin="0" structure="id:2341"/>
<structref name="TSRC Frame - ISRC (international standard recording code)" id="2344" repeatmin="0" structure="id:2343"/>
<structref name="TSSE Frame - Software/Hardware and settings used for encoding" id="2346" repeatmin="0" structure="id:2345"/>
<structref name="TSST Frame - Set subtitle" id="2348" repeatmin="0" structure="id:2347"/>
<structref name="TYER Frame - Year" id="2350" repeatmin="0" structure="id:2349"/>
<structref name="TXXX Frame - User defined text information frame" id="2352" repeatmin="0" structure="id:2351"/>
<structref name="UFID Frame - Unique file identifier" id="2354" repeatmin="0" structure="id:2353"/>
<structref name="USER Frame - Terms of use" id="2356" repeatmin="0" structure="id:2355"/>
<structref name="USLT Frame - Unsychronized lyric/text transcription" id="2358" repeatmin="0" structure="id:2357"/>
<structref name="WCOM Frame - Commercial information" id="2360" repeatmin="0" structure="id:2359"/>
<structref name="WCOP Frame - Copyright/Legal information" id="2362" repeatmin="0" structure="id:2361"/>
<structref name="WOAF Frame - Official audio file webpage" id="2364" repeatmin="0" structure="id:2363"/>
<structref name="WOAR Frame - Official artist/performer webpage" id="2366" repeatmin="0" structure="id:2365"/>
<structref name="WOAS Frame - Official audio source webpage" id="2368" repeatmin="0" structure="id:2367"/>
<structref name="WORS Frame - Official internet radio station homepage" id="2370" repeatmin="0" structure="id:2369"/>
<structref name="WPAY Frame - Payment" id="2372" repeatmin="0" structure="id:2371"/>
<structref name="WPUB Frame - Publishers official webpage" id="2374" repeatmin="0" structure="id:2373"/>
<structref name="WXXX Frame - User defined URL link frame" id="2376" repeatmin="0" structure="id:2375"/>
<structref name="ID3v2 Frame" id="2378" repeatmin="0" structure="id:2377"/>
</structure>
</structure>
</structure>
<structure name="ID3v2.0 Frame" id="2179" length="Size + 6" encoding="ISO_8859-1:1987" endian="big" signed="no">
<string name="Frame ID" mustmatch="yes" id="2382" fillcolor="D4FB78" type="fixed-length" length="3"/>
<number name="Size" id="2383" fillcolor="73FDFF" type="integer" length="3"/>
</structure>
<structure name="BUF Frame - Recommended buffer size" id="2056" extends="id:2179" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>Sometimes the server from which a audio file is streamed is aware of transmission or coding problems resulting in interruptions in the audio stream. In these cases, the size of the buffer can be recommended by the server using this frame. If the 'embedded info flag' is true (1) then this indicates that an ID3 tag with the maximum size described in 'Buffer size' may occur in the audiostream.
In such case the tag should reside between two MPEG [MPEG] frames, if the audio is MPEG encoded. If the position of the next tag is known, offset to next tag' may be used. The offset is calculated from the end of tag in which this frame resides to the first byte of the header in the next. This field may be omitted. Embedded tags is currently not recommended since this could render unpredictable behaviour from present software/hardware. The 'Buffer size' should be kept to a minimum. There may only be one "BUF" frame in each tag.</description>
<string name="Frame ID" id="2385" type="fixed-length">
<fixedvalues>
<fixedvalue name="BUF" value="BUF"/>
</fixedvalues>
</string>
<number name="Size" id="2386" type="integer"/>
<number name="Embedded info flag" id="2387" type="integer" length="1"/>
<number name="Offset to next tag" id="2388" type="integer" length="4"/>
</structure>
<structure name="CNT Frame - Play counter" id="2058" extends="id:2179" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>This is simply a counter of the number of times a file has been played. The value is increased by one every time the file begins to play. There may only be one "CNT" frame in each tag. When the counter reaches all one's, one byte is inserted in front of the counter thus making the counter eight bits bigger. The counter must be at least 32-bits long to begin with.</description>
<string name="Frame ID" id="2390" type="fixed-length">
<fixedvalues>
<fixedvalue name="CNT" value="CNT"/>
</fixedvalues>
</string>
<number name="Size" id="2391" type="integer"/>
<number name="Counter" id="2392" type="integer" length="4"/>
</structure>
<structure name="COM Frame - Comments" id="2060" extends="id:2179" encoding="ISO_8859-1:1987" endian="big" signed="no" valueexpression="The actual text">
<description>This frame replaces the old 30-character comment field in ID3v1. It consists of a frame head followed by encoding, language and content descriptors and is ended with the actual comment as a text string.
Newline characters are allowed in the comment text string. There may be more than one comment frame in each tag, but only one with the same language and content descriptor.</description>
<string name="Frame ID" id="2394" type="fixed-length">
<fixedvalues>
<fixedvalue name="COM" value="COM"/>
</fixedvalues>
</string>
<number name="Size" id="2395" type="integer"/>
<number name="Text Encoding" id="2396" type="integer" length="1">
<fixedvalues>
<fixedvalue name="ISO-8859-1" value="0"/>
<fixedvalue name="Unicode" value="1"/>
</fixedvalues>
</number>
<string name="Language" id="2397" type="fixed-length" length="3"/>
<string name="Short content description" id="2398" type="zero-terminated"/>
<string name="The actual text" id="2399" type="fixed-length" length="remaining"/>
</structure>
<structure name="CRA Frame - Audio encryption" id="2062" extends="id:2179" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>This frame indicates if the actual audio stream is encrypted, and by whom. Since standardisation of such encrypion scheme is beyond this document, all "CRA" frames begin with a terminated string with a URL containing an email address, or a link to a location where an email address can be found, that belongs to the organisation responsible for this specific encrypted audio file. Questions regarding the encrypted audio should be sent to the email address specified. If a $00 is found directly after the 'Frame size' and the audiofile indeed is encrypted, the whole file may be considered useless.
After the 'Owner identifier', a pointer to an unencrypted part of the audio can be specified. The 'Preview start' and 'Preview length' is described in frames. If no part is unencrypted, these fields should be left zeroed. After the 'preview length' field follows optionally a datablock required for decryption of the audio. There may be more than one "CRA" frames in a tag, but only one with the same 'Owner identifier'.</description>
<string name="Frame ID" id="2401" type="fixed-length">
<fixedvalues>
<fixedvalue name="CRA" value="CRA"/>
</fixedvalues>
</string>
<number name="Size" id="2402" type="integer"/>
<string name="Owner identifier" id="2403" type="zero-terminated"/>
<number name="Preview start" id="2404" type="integer" length="2"/>
<number name="Preview length" id="2405" type="integer" length="2"/>
<binary name="Encryption info" id="2406" length="remaining"/>
</structure>
<structure name="CRM Frame - Encrypted meta frame" id="2064" extends="id:2179" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>This frame contains one or more encrypted frames. This enables protection of copyrighted information such as pictures and text, that people might want to pay extra for. Since standardisation of such an encryption scheme is beyond this document, all "CRM" frames begin with a terminated string with a URL [URL] containing an email address, or a link to a location where an email adress can be found, that belongs to the organisation responsible for this specific encrypted meta frame.
Questions regarding the encrypted frame should be sent to the indicated email address. If a $00 is found directly after the 'Frame size', the whole frame should be ignored, and preferably be removed.
The 'Owner identifier' is then followed by a short content description and explanation as to why it's encrypted. After the 'content/explanation' description, the actual encrypted block follows.
When an ID3v2 decoder encounters a "CRM" frame, it should send the datablock to the 'plugin' with the corresponding 'owner identifier' and expect to receive either a datablock with one or several ID3v2 frames after each other or an error. There may be more than one "CRM" frames in a tag, but only one with the same 'owner identifier'.</description>
<string name="Frame ID" id="2408" type="fixed-length">
<fixedvalues>
<fixedvalue name="CRM" value="CRM"/>
</fixedvalues>
</string>
<number name="Size" id="2409" type="integer"/>
<string name="Owner identifier" id="2410" type="zero-terminated"/>
<string name="Content/explanation" id="2411" type="zero-terminated"/>
<binary name="Encrypted datablock" id="2412" length="remaining"/>
</structure>
<structure name="ETC Frame - Event timing codes" id="2066" extends="id:2179" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>This frame allows synchronisation with key events in a song or sound.</description>
<string name="Frame ID" id="2414" type="fixed-length">
<fixedvalues>
<fixedvalue name="ETC" value="ETC"/>
</fixedvalues>
</string>
<number name="Size" id="2415" type="integer"/>
<number name="Time stamp format" id="2416" type="integer" length="1">
<fixedvalues>
<fixedvalue name="Absolute time, 32 bit sized, using MPEG [MPEG] frames as unit" value="1"/>
<fixedvalue name="Absolute time, 32 bit sized, using milliseconds as unit" value="2"/>
</fixedvalues>
</number>
<structure name="Key Events" id="2417" repeatmax="-1">
<number name="Type" id="2418" type="integer" length="1" display="hex">
<fixedvalues>
<fixedvalue name="padding" value="0x0"/>
<fixedvalue name="end of initial silence" value="0x1"/>
<fixedvalue name="intro start" value="0x2"/>
<fixedvalue name="main part start" value="0x3"/>
<fixedvalue name="outro start" value="0x4"/>
<fixedvalue name="outro end" value="0x5"/>
<fixedvalue name="verse begins" value="0x6"/>
<fixedvalue name="refrain begins" value="0x7"/>
<fixedvalue name="interlude" value="0x8"/>
<fixedvalue name="theme start" value="0x9"/>
<fixedvalue name="variation" value="0xA"/>
<fixedvalue name="key change" value="0xB"/>
<fixedvalue name="time change" value="0xC"/>
<fixedvalue name="unwanted noise" value="0xD"/>
<fixedvalue name="not predefined sync 0" value="0xE0"/>
<fixedvalue name="not predefined sync 1" value="0xE1"/>
<fixedvalue name="not predefined sync 2" value="0xE2"/>
<fixedvalue name="not predefined sync 3" value="0xE3"/>
<fixedvalue name="not predefined sync 4" value="0xE4"/>
<fixedvalue name="not predefined sync 5" value="0xE5"/>
<fixedvalue name="not predefined sync 6" value="0xE6"/>
<fixedvalue name="not predefined sync 7" value="0xE7"/>
<fixedvalue name="not predefined sync 8" value="0xE8"/>
<fixedvalue name="not predefined sync 9" value="0xE9"/>
<fixedvalue name="not predefined sync A" value="0xEA"/>
<fixedvalue name="not predefined sync B" value="0xEB"/>
<fixedvalue name="not predefined sync C" value="0xEC"/>
<fixedvalue name="not predefined sync D" value="0xED"/>
<fixedvalue name="not predefined sync E" value="0xEE"/>
<fixedvalue name="not predefined sync F" value="0xEF"/>
<fixedvalue name="audio end (start of silence)" value="0xFD"/>
<fixedvalue name="audio file ends" value="0xFE"/>
<fixedvalue name="one more byte of events follows" value="0xFF"/>
</fixedvalues>
</number>
<number name="Time stamp" id="2419" type="integer" length="4"/>
</structure>
</structure>
<structure name="EQU Frame - Equalisation" id="2068" extends="id:2179" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>This is another subjective, alignment frame. It allows the user to predefine an equalisation curve within the audio file. There may only be one "EQU" frame in each tag.</description>
<string name="Frame ID" id="2422" type="fixed-length">
<fixedvalues>
<fixedvalue name="EQU" value="EQU"/>
</fixedvalues>
</string>
<number name="Size" id="2423" type="integer"/>
<number name="AdjustmentBits" id="2424" type="integer" length="1"/>
<number name="Increment/decrement" id="2425" type="integer" length="1" lengthunit="bit">
<fixedvalues>
<fixedvalue name="decrement" value="0"/>
<fixedvalue name="increment" value="1"/>
</fixedvalues>
</number>
<number name="Frequency" id="2426" type="integer" length="15" lengthunit="bit"/>
<number name="Adjustment" id="2427" type="integer" length="AdjustmentBits" lengthunit="bit"/>
</structure>
<structure name="GEO Frame - General encapsulated object" id="2070" extends="id:2179" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>In this frame any type of file can be encapsulated. After the header, 'Frame size' and 'Encoding' follows 'MIME type' [MIME] and 'Filename' for the encapsulated object, both represented as terminated strings encoded with ISO 8859-1 [ISO-8859-1]. The filename is case sensitive.
Then follows a content description as terminated string, encoded as 'Encoding'. The last thing in the frame is the actual object. The first two strings may be omitted, leaving only their terminations. MIME type is always an ISO-8859-1 text string. There may be more than one "GEO" frame in each tag, but only one with the same content descriptor.</description>
<string name="Frame ID" id="2429" type="fixed-length">
<fixedvalues>
<fixedvalue name="GEO" value="GEO"/>
</fixedvalues>
</string>
<number name="Size" id="2430" type="integer"/>
<number name="Text Encoding" id="2431" type="integer" length="1">
<fixedvalues>
<fixedvalue name="ISO-8859-1" value="0"/>
<fixedvalue name="Unicode" value="1"/>
</fixedvalues>
</number>
<string name="MIME type" id="2432" type="zero-terminated"/>
<string name="File name" id="2433" type="zero-terminated"/>
<string name="Content description" id="2434" type="zero-terminated"/>
<binary name="Encapsulated object" id="2435" length="remaining"/>
</structure>
<structure name="IPL Frame - Involved people list" id="2072" extends="id:2179" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>Since there might be a lot of people contributing to an audio file in various ways, such as musicians and technicians, the 'Text information frames' are often insufficient to list everyone involved in a project. The 'Involved people list' is a frame containing the names of those involved, and how they were involved. The body simply contains a terminated string with the involvement directly followed by a terminated string with the involvee followed by a new involvement and so on. There may only be one "IPL" frame in each tag.</description>
<string name="Frame ID" id="2437" type="fixed-length">
<fixedvalues>
<fixedvalue name="IPL" value="IPL"/>
</fixedvalues>
</string>
<number name="Size" id="2438" type="integer"/>
<string name="People list strings" id="2439" type="zero-terminated"/>
</structure>
<structure name="LNK Frame - Linked information" id="2074" extends="id:2179" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>To keep space waste as low as possible this frame may be used to link information from another ID3v2 tag that might reside in another audio file or alone in a binary file. It is recommended that this method is only used when the files are stored on a CD-ROM or other circumstances when the risk of file seperation is low. The frame contains a frame identifier, which is the frame that should be linked into this tag, a URL [URL] field, where a reference to the file where the frame is given, and additional ID data, if needed. Data should be retrieved from the first tag found in the file to which this link points. There may be more than one "LNK" frame in a tag, but only one with the same contents. A linked frame is to be considered as part of the tag and has the same restrictions as if it was a physical part of the tag (i.e. only one "REV" frame allowed, whether it's linked or not).
Frames that may be linked and need no additional data are "IPL", "MCI", "ETC", "LLT", "STC", "RVA", "EQU", "REV", "BUF", the text information frames and the URL link frames.
The "TXX", "PIC", "GEO", "CRM" and "CRA" frames may be linked with the content descriptor as additional ID data.
The "COM", "SLT" and "ULT" frames may be linked with three bytes of language descriptor directly followed by a content descriptor as additional ID data.</description>
<string name="Frame ID" id="2441" type="fixed-length">
<fixedvalues>
<fixedvalue name="LNK" value="LNK"/>
</fixedvalues>
</string>
<number name="Size" id="2442" type="integer"/>
<string name="Frame identifier" id="2443" type="fixed-length"/>
<string name="URL" id="2444" type="zero-terminated"/>
<string name="Additional ID data" id="2445" type="fixed-length" length="remaining"/>
</structure>
<structure name="MCI Frame - Music CD Identifier" id="2076" extends="id:2179" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>This frame is intended for music that comes from a CD, so that the CD can be identified in databases such as the CDDB [CDDB]. The frame consists of a binary dump of the Table Of Contents, TOC, from the CD, which is a header of 4 bytes and then 8 bytes/track on the CD making a maximum of 804 bytes. This frame requires a present and valid "TRK" frame. There may only be one "MCI" frame in each tag.</description>
<string name="Frame ID" id="2447" type="fixed-length">
<fixedvalues>
<fixedvalue name="MCI" value="MCI"/>
</fixedvalues>
</string>
<number name="Size" id="2448" type="integer"/>
<binary name="CD TOC" id="2449" length="remaining"/>
</structure>
<structure name="MLL Frame - MPEG location lookup table" id="2078" extends="id:2179" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>To increase performance and accuracy of jumps within a MPEG [MPEG] audio file, frames with timecodes in different locations in the file might be useful. The ID3 frame includes references that the software can use to calculate positions in the file. After the frame header is a descriptor of how much the 'frame counter' should increase for every reference. If this value is two then the first reference points out the second frame, the 2nd reference the 4th frame, the 3rd reference the 6th frame etc. In a similar way the 'bytes between reference' and 'milliseconds between reference' points out bytes and milliseconds respectively.
Each reference consists of two parts; a certain number of bits, as defined in 'bits for bytes deviation', that describes the difference between what is said in 'bytes between reference' and the reality and a certain number of bits, as defined in 'bits for milliseconds deviation', that describes the difference between what is said in 'milliseconds between reference' and the reality. The number of bits in every reference, i.e. 'bits for bytes deviation'+'bits for milliseconds deviation', must be a multiple of four. There may only be one "MLL" frame in each tag.</description>
<string name="Frame ID" id="2451" type="fixed-length">
<fixedvalues>
<fixedvalue name="MLL" value="MLL"/>
</fixedvalues>
</string>
<number name="Size" id="2452" type="integer"/>
<number name="MPEG frames between reference" id="2453" type="integer" length="2"/>
<number name="Bytes between reference" id="2454" type="integer" length="3"/>
<number name="Milliseconds between reference" id="2455" type="integer" length="3"/>
<number name="Bits for bytes deviation" id="2456" type="integer" length="1"/>
<number name="Bits for milliseconds deviation" id="2457" type="integer" length="1"/>
</structure>
<structure name="PIC Frame - Attached picture" id="2080" extends="id:2179" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>This frame contains a picture directly related to the audio file. Image format is preferably "PNG" [PNG] or "JPG" [JFIF]. Description is a short description of the picture, represented as a terminated textstring. The description has a maximum length of 64 characters, but may be empty. There may be several pictures attached to one file, each in their individual "PIC" frame, but only one with the same content descriptor. There may only be one picture with the picture type declared as picture type $01 and $02 respectively. There is a possibility to put only a link to the image file by using the 'image format' "-->" and having a complete URL [URL] instead of picture data.
The use of linked files should however be used restrictively since there is the risk of separation of files.</description>
<string name="Frame ID" id="2459" type="fixed-length">
<fixedvalues>
<fixedvalue name="PIC" value="PIC"/>
</fixedvalues>
</string>
<number name="Size" id="2460" type="integer"/>
<number name="Text Encoding" id="2461" type="integer" length="1">
<fixedvalues>
<fixedvalue name="ISO-8859-1" value="0"/>
<fixedvalue name="Unicode" value="1"/>
</fixedvalues>
</number>
<string name="Image format" id="2462" type="fixed-length" length="3"/>
<number name="Picture type" id="2463" type="integer" length="1" display="hex">
<fixedvalues>
<fixedvalue name="Other" value="0x0"/>
<fixedvalue name="32x32 pixels 'file icon' (PNG only)" value="0x1"/>
<fixedvalue name="Other file icon" value="0x2"/>
<fixedvalue name="Cover (front)" value="0x3"/>
<fixedvalue name="Cover (back)" value="0x4"/>
<fixedvalue name="Leaflet page" value="0x5"/>
<fixedvalue name="Media (e.g. lable side of CD)" value="0x6"/>
<fixedvalue name="Lead artist/lead performer/soloist" value="0x7"/>
<fixedvalue name="Artist/performer" value="0x8"/>
<fixedvalue name="Conductor" value="0x9"/>
<fixedvalue name="Band/Orchestra" value="0xA"/>
<fixedvalue name="Composer" value="0xB"/>
<fixedvalue name="Lyricist/text writer" value="0xC"/>
<fixedvalue name="Recording Location" value="0xD"/>
<fixedvalue name="During recording" value="0xE"/>
<fixedvalue name="During performance" value="0xF"/>
<fixedvalue name="Movie/video screen capture" value="0x10"/>
<fixedvalue name="A bright coloured fish" value="0x11"/>
<fixedvalue name="Illustration" value="0x12"/>
<fixedvalue name="Band/artist logotype" value="0x13"/>
<fixedvalue name="Publisher/Studio logotype" value="0x14"/>
</fixedvalues>
</number>
<string name="Description" id="2464" type="zero-terminated"/>
<binary name="Picture data" id="2465" length="remaining"/>
</structure>
<structure name="POP Frame - Popularimeter" id="2082" extends="id:2179" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The purpose of this frame is to specify how good an audio file is.
Many interesting applications could be found to this frame such as a playlist that features better audiofiles more often than others or it could be used to profile a persons taste and find other 'good' files by comparing people's profiles. The frame is very simple. It contains the email address to the user, one rating byte and a four byte play counter, intended to be increased with one for every time the file is played. The email is a terminated string. The rating is 1-255 where 1 is worst and 255 is best. 0 is unknown. If no personal counter is wanted it may be omitted. When the counter reaches all one's, one byte is inserted in front of the counter thus making the counter eight bits bigger in the same away as the play counter ("CNT").
There may be more than one "POP" frame in each tag, but only one with the same email address.</description>
<string name="Frame ID" id="2467" type="fixed-length">
<fixedvalues>
<fixedvalue name="POP" value="POP"/>
</fixedvalues>
</string>
<number name="Size" id="2468" type="integer"/>
<string name="Email to user" id="2469" type="zero-terminated"/>
<number name="Rating" id="2470" type="integer" length="1"/>
<number name="Counter" id="2471" type="integer" length="4"/>
</structure>
<structure name="REV Frame - Reverb" id="2084" extends="id:2179" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>Yet another subjective one. You may here adjust echoes of different kinds. Reverb left/right is the delay between every bounce in ms. Reverb bounces left/right is the number of bounces that should be made. $FF equals an infinite number of bounces. Feedback is the amount of volume that should be returned to the next echo bounce. $00 is 0%, $FF is 100%. If this value were $7F, there would be 50% volume reduction on the first bounce, yet 50% on the second and so on. Left to left means the sound from the left bounce to be played in the left speaker, while left to right means sound from the left bounce to be played in the right speaker.
'Premix left to right' is the amount of left sound to be mixed in the right before any reverb is applied, where $00 id 0% and $FF is 100%. 'Premix right to left' does the same thing, but right to left. Setting both premix to $FF would result in a mono output (if the reverb is applied symmetric). There may only be one "REV" frame in each tag.</description>
<string name="Frame ID" id="2473" type="fixed-length">
<fixedvalues>
<fixedvalue name="REV" value="REV"/>
</fixedvalues>
</string>
<number name="Size" id="2474" type="integer"/>
<number name="Reverb left (ms)" id="2475" type="integer" length="2"/>
<number name="Reverb right (ms)" id="2476" type="integer" length="2"/>
<number name="Reverb bounces, left" id="2477" type="integer" length="1"/>
<number name="Reverb bounces, right" id="2478" type="integer" length="1"/>
<number name="Reverb feedback, left to left" id="2479" type="integer" length="1"/>
<number name="Reverb feedback, left to right" id="2480" type="integer" length="1"/>
<number name="Reverb feedback, right to right" id="2481" type="integer" length="1"/>
<number name="Reverb feedback, right to left" id="2482" type="integer" length="1"/>
<number name="Premix left to right" id="2483" type="integer" length="1"/>
<number name="Premix right to left" id="2484" type="integer" length="1"/>
</structure>
<structure name="RVA Frame - Relative volume adjustment" id="2086" extends="id:2179" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>This is a more subjective function than the previous ones. It allows the user to say how much he wants to increase/decrease the volume on each channel while the file is played. The purpose is to be able to align all files to a reference volume, so that you don't have to change the volume constantly. This frame may also be used to balance adjust the audio. If the volume peak levels are known then this could be described with the 'Peak volume right' and 'Peak volume left' field. If Peakvolume is not known these fields could be left zeroed or completely omitted. There may only be one "RVA" frame in each tag.</description>
<string name="Frame ID" id="2486" type="fixed-length">
<fixedvalues>
<fixedvalue name="RVA" value="RVA"/>
</fixedvalues>
</string>
<number name="Size" id="2487" type="integer"/>
<number name="Increment/decrement" id="2488" type="integer" length="4"/>
<number name="Bits used for volume descr." id="2489" type="integer" length="1"/>
<number name="Relative volume change, right" id="2490" type="integer" length="2"/>
<number name="Relative volume change, left" id="2491" type="integer" length="2"/>
<number name="Peak volume right" id="2492" type="integer" length="2"/>
<number name="Peak volume left" id="2493" type="integer" length="2"/>
</structure>
<structure name="SLT Frame - Synchronised lyrics/text" id="2088" extends="id:2179" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>This is another way of incorporating the words, said or sung lyrics, in the audio file as text, this time, however, in sync with the audio. It might also be used to describing events e.g. occurring on a stage or on the screen in sync with the audio. The header includes a content descriptor, represented with as terminated textstring. If no descriptor is entered, 'Content descriptor' is $00 (00) only.</description>
<string name="Frame ID" id="2495" type="fixed-length">
<fixedvalues>
<fixedvalue name="SLT" value="SLT"/>
</fixedvalues>
</string>
<number name="Size" id="2496" type="integer"/>
<number name="Text Encoding" id="2497" type="integer" length="1">
<fixedvalues>
<fixedvalue name="ISO-8859-1" value="0"/>
<fixedvalue name="Unicode" value="1"/>
</fixedvalues>
</number>
<string name="Language" id="2498" type="fixed-length" length="3"/>
<number name="Time stamp format" id="2499" type="integer" length="1">
<fixedvalues>
<fixedvalue name="Absolute time, 32 bit sized, using MPEG [MPEG] frames as unit" value="1"/>
<fixedvalue name="Absolute time, 32 bit sized, using milliseconds as unit" value="2"/>
</fixedvalues>
</number>
<number name="Content type" id="2500" type="integer" length="1">
<fixedvalues>
<fixedvalue name="other" value="0"/>
<fixedvalue name="lyrics" value="1"/>
<fixedvalue name="text transcription" value="2"/>
<fixedvalue name="movement/part name" value="3"/>
<fixedvalue name="events" value="4"/>
<fixedvalue name="chord" value="5"/>
</fixedvalues>
</number>
<string name="Content descriptor" id="2501" type="fixed-length" length="remaining"/>
</structure>
<structure name="STC Frame - Synced tempo codes" id="2090" extends="id:2179" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>For a more accurate description of the tempo of a musical piece this frame might be used. After the header follows one byte describing which time stamp format should be used. Then follows one or more tempo codes. Each tempo code consists of one tempo part and one time part. The tempo is in BPM described with one or two bytes. If the first byte has the value $FF, one more byte follows, which is added to the first giving a range from 2 - 510 BPM, since $00 and $01 is reserved. $00 is used to describe a beat-free time period, which is not the same as a music-free time period. $01 is used to indicate one single beat-stroke followed by a beat-free period.
The tempo descriptor is followed by a time stamp. Every time the tempo in the music changes, a tempo descriptor may indicate this for the player. All tempo descriptors should be sorted in chronological order. The first beat-stroke in a time-period is at the same time as the beat description occurs. There may only be one "STC" frame in each tag.</description>
<string name="Frame ID" id="2503" type="fixed-length">
<fixedvalues>
<fixedvalue name="STC" value="STC"/>
</fixedvalues>
</string>
<number name="Size" id="2504" type="integer"/>
<number name="Time stamp format" id="2505" type="integer" length="1">
<fixedvalues>
<fixedvalue name="Absolute time, 32 bit sized, using MPEG [MPEG] frames as unit" value="1"/>
<fixedvalue name="Absolute time, 32 bit sized, using milliseconds as unit" value="2"/>
</fixedvalues>
</number>
<binary name="Tempo data" id="2506" length="remaining"/>
</structure>
<structure name="ID3v2.0 Text information frame" id="2508" extends="id:2179" valueexpression="Encoded String">
<description>The text information frames are the most important frames, containing information like artist, album and more. There may only be one text information frame of its kind in an tag. If the textstring is followed by a termination ($00 (00)) all the following information should be ignored and not be displayed.</description>
<string name="Frame ID" id="2509" type="fixed-length"/>
<number name="Size" id="2510" type="integer"/>
<structref name="Encoded String" id="2512" structure="id:2511"/>
</structure>
<structure name="TAL Frame - Album/Movie/Show title" id="2092" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Album/Movie/Show title' frame is intended for the title of the recording(/source of sound) which the audio in the file is taken from.</description>
<string name="Frame ID" id="2514" type="fixed-length">
<fixedvalues>
<fixedvalue name="TAL" value="TAL"/>
</fixedvalues>
</string>
</structure>
<structure name="TBP Frame - BPM (Beats Per Minute)" id="2094" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>BPM is short for beats per minute, and is easily computed by dividing the number of beats in a musical piece with its length. To get a more accurate result, do the BPM calculation on the main-part only. To acquire best result measure the time between each beat and calculate individual BPM for each beat and use the median value as result. BPM is an integer and represented as a numerical string.</description>
<string name="Frame ID" id="2518" type="fixed-length">
<fixedvalues>
<fixedvalue name="TBP" value="TBP"/>
</fixedvalues>
</string>
</structure>
<structure name="TCM Frame - Composer(s)" id="2096" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Composer(s)' frame is intended for the name of the composer(s).
They are seperated with the "/" character.</description>
<string name="Frame ID" id="2522" type="fixed-length">
<fixedvalues>
<fixedvalue name="TCM" value="TCM"/>
</fixedvalues>
</string>
</structure>
<structure name="TCO Frame - Content type" id="2098" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The content type, which previously (in ID3v1.1, see appendix A) was stored as a one byte numeric value only, is now a numeric string. You may use one or several of the types as ID3v1.1 did or, since the category list would be impossible to maintain with accurate and up to date categories, define your own.
References to the ID3v1 genres can be made by, as first byte, enter "(" followed by a number from the genres list (section A.3.) and ended with a ")" character. This is optionally followed by a refinement, e.g. "(21)" or "(4)Eurodisco". Several references can be made in the same frame, e.g. "(51)(39)". If the refinement should begin with a "(" character it should be replaced with "((", e.g. "((I can figure out any genre)" or "(55)((I think...)". The following new content types is defined in ID3v2 and is implemented in the same way as the numerig content types, e.g. "(RX)".
RX Remix
CR Cover</description>
<string name="Frame ID" id="2526" type="fixed-length">
<fixedvalues>
<fixedvalue name="TCO" value="TCO"/>
</fixedvalues>
</string>
</structure>
<structure name="TCR Frame - Copyright message" id="2100" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Copyright message' frame, which must begin with a year and a space character (making five characters), is intended for the copyright holder of the original sound, not the audio file itself. The absence of this frame means only that the copyright information is unavailable or has been removed, and must not be interpreted to mean that the sound is public domain. Every time this field is displayed the field must be preceded with "Copyright " (C) " ", where (C) is one character showing a C in a circle.</description>
<string name="Frame ID" id="2530" type="fixed-length">
<fixedvalues>
<fixedvalue name="TCR" value="TCR"/>
</fixedvalues>
</string>
</structure>
<structure name="TDA Frame - Date" id="2102" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Date' frame is a numeric string in the DDMM format containing the date for the recording. This field is always four characters long.</description>
<string name="Frame ID" id="2534" type="fixed-length">
<fixedvalues>
<fixedvalue name="TDA" value="TDA"/>
</fixedvalues>
</string>
</structure>
<structure name="TDY Frame - Playlist delay" id="2104" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Playlist delay' defines the numbers of milliseconds of silence between every song in a playlist. The player should use the "ETC" frame, if present, to skip initial silence and silence at the end of the audio to match the 'Playlist delay' time. The time is represented as a numeric string.</description>
<string name="Frame ID" id="2538" type="fixed-length">
<fixedvalues>
<fixedvalue name="TDY" value="TDY"/>
</fixedvalues>
</string>
</structure>
<structure name="TEN Frame - Encoded by" id="2106" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Encoded by' frame contains the name of the person or organisation that encoded the audio file. This field may contain a copyright message, if the audio file also is copyrighted by the encoder.</description>
<string name="Frame ID" id="2542" type="fixed-length">
<fixedvalues>
<fixedvalue name="TEN" value="TEN"/>
</fixedvalues>
</string>
</structure>
<structure name="TFT Frame - File type" id="2108" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'File type' frame indicates which type of audio this tag defines.
The following type and refinements are defined:
MPG MPEG Audio
/1 MPEG 2 layer I
/2 MPEG 2 layer II
/3 MPEG 2 layer III
/2.5 MPEG 2.5
/AAC Advanced audio compression
but other types may be used, not for these types though. This is used in a similar way to the predefined types in the "TMT" frame, but without parenthesis. If this frame is not present audio type is assumed to be "MPG".</description>
<string name="Frame ID" id="2546" type="fixed-length">
<fixedvalues>
<fixedvalue name="TFT" value="TFT"/>
</fixedvalues>
</string>
</structure>
<structure name="TIM Frame - Time" id="2110" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Time' frame is a numeric string in the HHMM format containing the time for the recording. This field is always four characters long.</description>
<string name="Frame ID" id="2550" type="fixed-length">
<fixedvalues>
<fixedvalue name="TIM" value="TIM"/>
</fixedvalues>
</string>
</structure>
<structure name="TKE Frame - Initial key" id="2112" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Initial key' frame contains the musical key in which the sound starts. It is represented as a string with a maximum length of three characters. The ground keys are represented with "A","B","C","D","E", "F" and "G" and halfkeys represented with "b" and "#". Minor is represented as "m". Example "Cbm". Off key is represented with an "o" only.</description>
<string name="Frame ID" id="2554" type="fixed-length">
<fixedvalues>
<fixedvalue name="TKE" value="TKE"/>
</fixedvalues>
</string>
</structure>
<structure name="TLA Frame - Language(s)" id="2114" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Language(s)' frame should contain the languages of the text or lyrics in the audio file. The language is represented with three characters according to ISO-639-2. If more than one language is used in the text their language codes should follow according to their usage.</description>
<string name="Frame ID" id="2558" type="fixed-length">
<fixedvalues>
<fixedvalue name="TLA" value="TLA"/>
</fixedvalues>
</string>
</structure>
<structure name="TLE Frame - Length" id="2116" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Length' frame contains the length of the audiofile in milliseconds, represented as a numeric string.</description>
<string name="Frame ID" id="2562" type="fixed-length">
<fixedvalues>
<fixedvalue name="TLE" value="TLE"/>
</fixedvalues>
</string>
</structure>
<structure name="TMT Frame - Media type" id="2118" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Media type' frame describes from which media the sound originated. This may be a textstring or a reference to the predefined media types found in the list below. References are made within "(" and ")" and are optionally followed by a text refinement, e.g. "(MC) with four channels". If a text refinement should begin with a "(" character it should be replaced with "((" in the same way as in the "TCO" frame. Predefined refinements is appended after the media type, e.g. "(CD/S)" or "(VID/PAL/VHS)".</description>
<string name="Frame ID" id="2566" type="fixed-length">
<fixedvalues>
<fixedvalue name="TMT" value="TMT"/>
</fixedvalues>
</string>
</structure>
<structure name="TOA Frame - Original artist(s)/performer(s)" id="2120" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Original artist(s)/performer(s)' frame is intended for the performer(s) of the original recording, if for example the music in the file should be a cover of a previously released song. The performers are seperated with the "/" character.</description>
<string name="Frame ID" id="2570" type="fixed-length">
<fixedvalues>
<fixedvalue name="TOA" value="TOA"/>
</fixedvalues>
</string>
</structure>
<structure name="TOF Frame - Original filename" id="2122" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Original filename' frame contains the preferred filename for the file, since some media doesn't allow the desired length of the filename. The filename is case sensitive and includes its suffix.</description>
<string name="Frame ID" id="2574" type="fixed-length">
<fixedvalues>
<fixedvalue name="TOF" value="TOF"/>
</fixedvalues>
</string>
</structure>
<structure name="TOL Frame - Original Lyricist(s)/text writer(s)" id="2124" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Original Lyricist(s)/text writer(s)' frame is intended for the text writer(s) of the original recording, if for example the music in the file should be a cover of a previously released song. The text writers are seperated with the "/" character.</description>
<string name="Frame ID" id="2578" type="fixed-length">
<fixedvalues>
<fixedvalue name="TOL" value="TOL"/>
</fixedvalues>
</string>
</structure>
<structure name="TOR Frame - Original release year" id="2126" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Original release year' frame is intended for the year when the original recording, if for example the music in the file should be a cover of a previously released song, was released. The field is formatted as in the "TDY" frame.</description>
<string name="Frame ID" id="2582" type="fixed-length">
<fixedvalues>
<fixedvalue name="TOR" value="TOR"/>
</fixedvalues>
</string>
</structure>
<structure name="TOT Frame - Original album/Movie/Show title" id="2128" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Original album/Movie/Show title' frame is intended for the title of the original recording(/source of sound), if for example the music in the file should be a cover of a previously released song.</description>
<string name="Frame ID" id="2586" type="fixed-length">
<fixedvalues>
<fixedvalue name="TOT" value="TOT"/>
</fixedvalues>
</string>
</structure>
<structure name="TP1 Frame - Lead artist(s)/Lead performer(s)/Soloist(s)/Performing group" id="2130" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Lead artist(s)/Lead performer(s)/Soloist(s)/Performing group' is used for the main artist(s). They are seperated with the "/" character.</description>
<string name="Frame ID" id="2590" type="fixed-length">
<fixedvalues>
<fixedvalue name="TP1" value="TP1"/>
</fixedvalues>
</string>
</structure>
<structure name="TP2 Frame - Band/Orchestra/Accompaniment" id="2132" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Band/Orchestra/Accompaniment' frame is used for additional information about the performers in the recording.</description>
<string name="Frame ID" id="2594" type="fixed-length">
<fixedvalues>
<fixedvalue name="TP2" value="TP2"/>
</fixedvalues>
</string>
</structure>
<structure name="TP3 Frame - Conductor" id="2134" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Conductor' frame is used for the name of the conductor.</description>
<string name="Frame ID" id="2598" type="fixed-length">
<fixedvalues>
<fixedvalue name="TP3" value="TP3"/>
</fixedvalues>
</string>
</structure>
<structure name="TP4 Frame - Interpreted, remixed, or otherwise modified by" id="2136" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Interpreted, remixed, or otherwise modified by' frame contains more information about the people behind a remix and similar interpretations of another existing piece.</description>
<string name="Frame ID" id="2602" type="fixed-length">
<fixedvalues>
<fixedvalue name="TP4" value="TP4"/>
</fixedvalues>
</string>
</structure>
<structure name="TPA Frame - Part of a set" id="2138" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Part of a set' frame is a numeric string that describes which part of a set the audio came from. This frame is used if the source described in the "TAL" frame is divided into several mediums, e.g. a double CD. The value may be extended with a "/" character and a numeric string containing the total number of parts in the set. E.g. "1/2".</description>
<string name="Frame ID" id="2606" type="fixed-length">
<fixedvalues>
<fixedvalue name="TPA" value="TPA"/>
</fixedvalues>
</string>
</structure>
<structure name="TPB Frame - Publisher" id="2140" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Publisher' frame simply contains the name of the label or publisher.</description>
<string name="Frame ID" id="2610" type="fixed-length">
<fixedvalues>
<fixedvalue name="TPB" value="TPB"/>
</fixedvalues>
</string>
</structure>
<structure name="TRC Frame - ISRC (International Standard Recording Code)" id="2142" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'ISRC' frame should contian the International Standard Recording Code [ISRC].</description>
<string name="Frame ID" id="2614" type="fixed-length">
<fixedvalues>
<fixedvalue name="TRC" value="TRC"/>
</fixedvalues>
</string>
</structure>
<structure name="TRD Frame - Recording dates" id="2144" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Recording dates' frame is a intended to be used as complement to the "TYE", "TDA" and "TIM" frames. E.g. "4th-7th June, 12th June" in combination with the "TYE" frame.</description>
<string name="Frame ID" id="2618" type="fixed-length">
<fixedvalues>
<fixedvalue name="TRD" value="TRD"/>
</fixedvalues>
</string>
</structure>
<structure name="TRK Frame - Track number/Position in set" id="2146" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Track number/Position in set' frame is a numeric string containing the order number of the audio-file on its original recording. This may be extended with a "/" character and a numeric string containing the total numer of tracks/elements on the original recording. E.g. "4/9".</description>
<string name="Frame ID" id="2622" type="fixed-length">
<fixedvalues>
<fixedvalue name="TRK" value="TRK"/>
</fixedvalues>
</string>
</structure>
<structure name="TSA Frame - Album Sort" id="2148" extends="id:2508">
<string name="Frame ID" id="2626" type="fixed-length">
<fixedvalues>
<fixedvalue name="TSA" value="TSA"/>
</fixedvalues>
</string>
</structure>
<structure name="TS2 Frame - Album Artist Sort" id="2150" extends="id:2508">
<string name="Frame ID" id="2630" type="fixed-length">
<fixedvalues>
<fixedvalue name="TS2" value="TS2"/>
</fixedvalues>
</string>
</structure>
<structure name="TSC Frame - Composer Sort" id="2152" extends="id:2508">
<string name="Frame ID" id="2634" type="fixed-length">
<fixedvalues>
<fixedvalue name="TSC" value="TSC"/>
</fixedvalues>
</string>
</structure>
<structure name="TSI Frame - Size" id="2154" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Size' frame contains the size of the audiofile in bytes excluding the tag, represented as a numeric string.</description>
<string name="Frame ID" id="2638" type="fixed-length">
<fixedvalues>
<fixedvalue name="TSI" value="TSI"/>
</fixedvalues>
</string>
</structure>
<structure name="TSP Frame - Artist Sort" id="2156" extends="id:2508">
<string name="Frame ID" id="2642" type="fixed-length">
<fixedvalues>
<fixedvalue name="TSP" value="TSP"/>
</fixedvalues>
</string>
</structure>
<structure name="TSS Frame - Software/hardware and settings used for encoding" id="2158" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Software/hardware and settings used for encoding' frame includes the used audio encoder and its settings when the file was encoded. Hardware refers to hardware encoders, not the computer on which a program was run.</description>
<string name="Frame ID" id="2646" type="fixed-length">
<fixedvalues>
<fixedvalue name="TSS" value="TSS"/>
</fixedvalues>
</string>
</structure>
<structure name="TST Frame - Title Sort" id="2160" extends="id:2508">
<string name="Frame ID" id="2650" type="fixed-length">
<fixedvalues>
<fixedvalue name="TST" value="TST"/>
</fixedvalues>
</string>
</structure>
<structure name="TT1 Frame - Content group description" id="2162" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Content group description' frame is used if the sound belongs to a larger category of sounds/music. For example, classical music is often sorted in different musical sections (e.g. "Piano Concerto", "Weather - Hurricane").</description>
<string name="Frame ID" id="2654" type="fixed-length">
<fixedvalues>
<fixedvalue name="TT1" value="TT1"/>
</fixedvalues>
</string>
</structure>
<structure name="TT2 Frame - Title/Songname/Content description" id="2164" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Title/Songname/Content description' frame is the actual name of the piece (e.g. "Adagio", "Hurricane Donna").</description>
<string name="Frame ID" id="2658" type="fixed-length">
<fixedvalues>
<fixedvalue name="TT2" value="TT2"/>
</fixedvalues>
</string>
</structure>
<structure name="TT3 Frame - Subtitle/Description refinement" id="2166" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Subtitle/Description refinement' frame is used for information directly related to the contents title (e.g. "Op. 16" or "Performed live at wembley").</description>
<string name="Frame ID" id="2662" type="fixed-length">
<fixedvalues>
<fixedvalue name="TT3" value="TT3"/>
</fixedvalues>
</string>
</structure>
<structure name="TXT Frame - Lyricist(s)/text writer(s)" id="2168" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Lyricist(s)/text writer(s)' frame is intended for the writer(s) of the text or lyrics in the recording. They are seperated with the "/" character.</description>
<string name="Frame ID" id="2666" type="fixed-length">
<fixedvalues>
<fixedvalue name="TXT" value="TXT"/>
</fixedvalues>
</string>
</structure>
<structure name="TXX Frame - User defined text information frame" id="2170" extends="id:2179" encoding="ISO_8859-1:1987" endian="big" signed="no" valueexpression="Value">
<description>This frame is intended for one-string text information concerning the audiofile in a similar way to the other "T"xx frames. The frame body consists of a description of the string, represented as a terminated string, followed by the actual string. There may be more than one "TXX" frame in each tag, but only one with the same description.</description>
<string name="Frame ID" id="2670" type="fixed-length">
<fixedvalues>
<fixedvalue name="TXX" value="TXX"/>
</fixedvalues>
</string>
<number name="Size" id="2671" type="integer"/>
<number name="Text encoding" id="2672" type="integer" length="1"/>
<string name="Description" id="2673" type="zero-terminated"/>
<string name="Value" id="2674" type="fixed-length" length="remaining"/>
</structure>
<structure name="TYE Frame - Year" id="2172" extends="id:2508" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Year' frame is a numeric string with a year of the recording.
This frames is always four characters long (until the year 10000).</description>
<string name="Frame ID" id="2676" type="fixed-length">
<fixedvalues>
<fixedvalue name="TYE" value="TYE"/>
</fixedvalues>
</string>
</structure>
<structure name="UFI Frame - Unique file identifier" id="2174" extends="id:2179" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>This frame's purpose is to be able to identify the audio file in a database that may contain more information relevant to the content.
Since standardisation of such a database is beyond this document, all frames begin with a null-terminated string with a URL [URL] containing an email address, or a link to a location where an email address can be found, that belongs to the organisation responsible for this specific database implementation. Questions regarding the database should be sent to the indicated email address. The URL should not be used for the actual database queries. If a $00 is found directly after the 'Frame size' the whole frame should be ignored, and preferably be removed. The 'Owner identifier' is then followed by the actual identifier, which may be up to 64 bytes. There may be more than one "UFI" frame in a tag, but only one with the same 'Owner identifier'.</description>
<string name="Frame ID" id="2680" type="fixed-length">
<fixedvalues>
<fixedvalue name="UFI" value="UFI"/>
</fixedvalues>
</string>
<number name="Size" id="2681" type="integer"/>
<string name="Owner Identifier" id="2682" type="zero-terminated"/>
<binary name="Identifier" id="2683" length="remaining"/>
</structure>
<structure name="ULT Frame - Unsychronised lyrics/text transcription" id="2176" extends="id:2179" encoding="ISO_8859-1:1987" endian="big" signed="no" valueexpression="Lyrics/text">
<description>This frame contains the lyrics of the song or a text transcription of other vocal activities. The head includes an encoding descriptor and a content descriptor. The body consists of the actual text. The 'Content descriptor' is a terminated string. If no descriptor is entered, 'Content descriptor' is $00 (00) only. Newline characters are allowed in the text. Maximum length for the descriptor is 64 bytes. There may be more than one lyrics/text frame in each tag, but only one with the same language and content descriptor.</description>
<string name="Frame ID" id="2685" type="fixed-length">
<fixedvalues>
<fixedvalue name="ULT" value="ULT"/>
</fixedvalues>
</string>
<number name="Size" id="2686" type="integer"/>
<number name="Text Encoding" id="2687" type="integer" length="1"/>
<string name="Language" id="2688" type="fixed-length" length="3"/>
<string name="Content descriptor" id="2689" type="zero-terminated"/>
<string name="Lyrics/text" id="2690" type="fixed-length" length="remaining"/>
</structure>
<structure name="ID3v2.0 URL link frame" id="2692" extends="id:2179" valueexpression="URL">
<description>With these frames dynamic data such as webpages with touring information, price information or plain ordinary news can be added to the tag. There may only be one URL [URL] link frame of its kind in an tag, except when stated otherwise in the frame description. If the textstring is followed by a termination ($00 (00)) all the following information should be ignored and not be displayed.</description>
<string name="Frame ID" id="2693" type="fixed-length">
<fixedvalues/>
</string>
<number name="Size" id="2694" type="integer"/>
<string name="URL" id="2695" type="zero-terminated"/>
</structure>
<structure name="WAF Frame - Official audio file webpage" id="2697" extends="id:2692" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Official audio file webpage' frame is a URL pointing at a file specific webpage.</description>
<string name="Frame ID" id="2698" type="fixed-length">
<fixedvalues>
<fixedvalue name="WAF" value="WAF"/>
</fixedvalues>
</string>
</structure>
<structure name="WAR Frame - Official artist/performer webpage" id="2702" extends="id:2692" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Official artist/performer webpage' frame is a URL pointing at the artists official webpage. There may be more than one "WAR" frame in a tag if the audio contains more than one performer.</description>
<string name="Frame ID" id="2703" type="fixed-length">
<fixedvalues>
<fixedvalue name="WAR" value="WAR"/>
</fixedvalues>
</string>
</structure>
<structure name="WAS Frame - Official audio source webpage" id="2707" extends="id:2692" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Official audio source webpage' frame is a URL pointing at the official webpage for the source of the audio file, e.g. a movie.</description>
<string name="Frame ID" id="2708" type="fixed-length">
<fixedvalues>
<fixedvalue name="WAS" value="WAS"/>
</fixedvalues>
</string>
</structure>
<structure name="WCM Frame - Commercial information" id="2712" extends="id:2692" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Commercial information' frame is a URL pointing at a webpage with information such as where the album can be bought. There may be more than one "WCM" frame in a tag.</description>
<string name="Frame ID" id="2713" type="fixed-length">
<fixedvalues>
<fixedvalue name="WCM" value="WCM"/>
</fixedvalues>
</string>
</structure>
<structure name="WCP Frame - Copyright/Legal information" id="2717" extends="id:2692" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Copyright/Legal information' frame is a URL pointing at a webpage where the terms of use and ownership of the file is described.</description>
<string name="Frame ID" id="2718" type="fixed-length">
<fixedvalues>
<fixedvalue name="WCP" value="WCP"/>
</fixedvalues>
</string>
</structure>
<structure name="WPB Frame - Publishers official webpage" id="2722" extends="id:2692" encoding="ISO_8859-1:1987" endian="big" signed="no">
<description>The 'Publishers official webpage' frame is a URL pointing at the official web page for the publisher.</description>
<string name="Frame ID" id="2723" type="fixed-length">
<fixedvalues>
<fixedvalue name="WPB" value="WPB"/>
</fixedvalues>
</string>
</structure>
<structure name="WXX Frame - User defined URL link frame" id="2727" extends="id:2179" encoding="ISO_8859-1:1987" endian="big" signed="no" valueexpression="URL">
<description>This frame is intended for URL [URL] links concerning the audiofile in a similar way to the other "W"xx frames. The frame body consists of a description of the string, represented as a terminated string, followed by the actual URL. The URL is always encoded with ISO-8859-1 [ISO-8859-1]. There may be more than one "WXX" frame in each tag, but only one with the same description.</description>
<string name="Frame ID" id="2728" type="fixed-length">
<fixedvalues>
<fixedvalue name="WXX" value="WXX"/>
</fixedvalues>
</string>
<number name="Size" id="2729" type="integer"/>
<number name="Text encoding" id="2730" type="integer" length="1"/>
<string name="Description" id="2731" type="zero-terminated"/>
<string name="URL" id="2732" type="fixed-length" length="remaining"/>
</structure>
<structure name="ID3v2.3 Frame" id="2377" length="Size + 10" encoding="ISO_8859-1:1987" endian="big" signed="no">
<string name="Frame ID" mustmatch="yes" id="2734" fillcolor="D4FB78" type="fixed-length" length="4"/>
<number name="Size" id="2735" fillcolor="73FDFF" type="integer" length="4"/>
<number name="Tag alter preservation" id="2736" type="integer" length="1" lengthunit="bit">
<description>This flag tells the software what to do with this frame if it is unknown and the tag is altered in any way. This applies to all kinds of alterations, including adding more padding and reordering the frames.</description>
<fixedvalues>
<fixedvalue name="Frame should be preserved" value="0"/>
<fixedvalue name="Frame should be discarded" value="1"/>
</fixedvalues>
</number>
<number name="File alter preservation" id="2737" type="integer" length="1" lengthunit="bit">
<description>This flag tells the software what to do with this frame if it is unknown and the file, excluding the tag, is altered. This does not apply when the audio is completely replaced with other audio data.</description>
<fixedvalues>
<fixedvalue name="Frame should be preserved" value="0"/>
<fixedvalue name="Frame should be discarded" value="1"/>
</fixedvalues>
</number>
<number name="Read only" id="2738" type="integer" length="1" lengthunit="bit">
<description>This flag, if set, tells the software that the contents of this frame is intended to be read only. Changing the contents might break something, e.g. a signature. If the contents are changed, without knowledge in why the frame was flagged read only and without taking the proper means to compensate, e.g. recalculating the signature, the bit should be cleared.</description>
<fixedvalues>
<fixedvalue name="Not read only" value="0"/>
<fixedvalue name="Read only" value="1"/>
</fixedvalues>
</number>
<number name="Unused Flags" id="2739" type="integer" length="5" lengthunit="bit"/>
<number name="Compression" id="2740" type="integer" length="1" lengthunit="bit">
<description>This flag indicates whether or not the frame is compressed</description>
<fixedvalues>
<fixedvalue name="Frame is not compressed" value="0"/>
<fixedvalue name="Frame is compressed" value="1"/>
</fixedvalues>
</number>
<number name="Encryption" id="2741" type="integer" length="1" lengthunit="bit">
<description>This flag indicates wether or not the frame is enrypted. If set one byte indicating with which method it was encrypted will be appended to the frame header.</description>
<fixedvalues>
<fixedvalue name="Frame is not encrypted" value="0"/>
<fixedvalue name="Frame is encrypted" value="1"/>
</fixedvalues>
</number>
<number name="Grouping identity" id="2742" type="integer" length="1" lengthunit="bit">
<description>This flag indicates whether or not this frame belongs in a group with other frames. If set a group identifier byte is added to the frame header. Every frame with the same group identifier belongs to the same group.
</description>
<fixedvalues>
<fixedvalue name="Frame does not contain group information" value="0"/>
<fixedvalue name="Frame contains group information" value="1"/>
</fixedvalues>
</number>
<number name="Unused Flags 2" id="2743" type="integer" length="5" lengthunit="bit"/>
</structure>
<structure name="AENC Frame - Audio encryption" id="2195" extends="id:2377">
<description>This frame indicates if the actual audio stream is encrypted, and by whom. Since standardization of such encryption scheme is beyond this document, all "AENC" frames begin with a terminated string with a URL containing an email address, or a link to a location where an email address can be found, that belongs to the organisation responsible for this specific encrypted audio file. Questions regarding the encrypted audio should be sent to the email address specified. If a $00 is found directly after the 'Frame size' and the audiofile indeed is encrypted, the whole file may be considered useless.
After the 'Owner identifier', a pointer to an unencrypted part of the audio can be specified. The 'Preview start' and 'Preview length' is described in frames. If no part is unencrypted, these fields should be left zeroed. After the 'preview length' field follows optionally a datablock required for decryption of the audio. There may be more than one "AENC" frames in a tag, but only one with the same 'Owner identifier'.</description>
<string name="Frame ID" id="2745" type="fixed-length">
<fixedvalues>
<fixedvalue name="AENC" value="AENC"/>
</fixedvalues>
</string>
<number name="Size" id="2746" type="integer"/>
<string name="Owner identifier" id="2755" type="zero-terminated"/>
<number name="Preview start" id="2756" type="integer" length="2"/>
<number name="Preview length" id="2757" type="integer" length="2"/>
<binary name="Encryption info" id="2758" length="remaining"/>
</structure>
<structure name="APIC Frame - Attached picture" id="2197" extends="id:2377">
<description>This frame contains a picture directly related to the audio file. Image format is the MIME type and subtype for the image. In the event that the MIME media type name is omitted, "image/" will be implied. The "image/png" or "image/jpeg" picture format should be used when interoperability is wanted. Description is a short description of the picture, represented as a terminated textstring. The description has a maximum length of 64 characters, but may be empty. There may be several pictures attached to one file, each in their individual "APIC" frame, but only one with the same content descriptor. There may only be one picture with the picture type declared as picture type $01 and $02 respectively. There is the possibility to put only a link to the image file by using the 'MIME type' "-->" and having a complete URL instead of picture data. The use of linked files should however be used sparingly since there is the risk of separation of files.</description>
<string name="Frame ID" id="2760" type="fixed-length">
<fixedvalues>
<fixedvalue name="APIC" value="APIC"/>
</fixedvalues>
</string>
<number name="Size" id="2761" type="integer"/>
<number name="Text encoding" id="2770" type="integer" length="1"/>
<string name="MIME type" id="2771" type="zero-terminated"/>
<number name="Picture type" id="2772" type="integer" length="1" display="hex">
<fixedvalues>
<fixedvalue name="Other" value="0x0"/>
<fixedvalue name="32x32 pixels 'file icon' (PNG only)" value="0x1"/>
<fixedvalue name="Other file icon" value="0x2"/>
<fixedvalue name="Cover (front)" value="0x3"/>
<fixedvalue name="Cover (back)" value="0x4"/>
<fixedvalue name="Leaflet page" value="0x5"/>
<fixedvalue name="Media (e.g. lable side of CD)" value="0x6"/>
<fixedvalue name="Lead artist/lead performer/soloist" value="0x7"/>
<fixedvalue name="Artist/performer" value="0x8"/>
<fixedvalue name="Conductor" value="0x9"/>
<fixedvalue name="Band/Orchestra" value="0xA"/>
<fixedvalue name="Composer" value="0xB"/>
<fixedvalue name="Lyricist/text writer" value="0xC"/>
<fixedvalue name="Recording Location" value="0xD"/>
<fixedvalue name="During recording" value="0xE"/>
<fixedvalue name="During performance" value="0xF"/>
<fixedvalue name="Movie/video screen capture" value="0x10"/>
<fixedvalue name="A bright coloured fish" value="0x11"/>
<fixedvalue name="Illustration" value="0x12"/>
<fixedvalue name="Band/artist logotype" value="0x13"/>
<fixedvalue name="Publisher/Studio logotype" value="0x14"/>
</fixedvalues>
</number>
<string name="Description" id="2773" type="zero-terminated"/>
<binary name="Image Data" id="2774" length="remaining"/>
</structure>
<structure name="ASPI Frame - Audio seek point index" id="2199" extends="id:2377">
<description>Audio files with variable bit rates are intrinsically difficult to deal with in the case of seeking within the file. The ASPI frame makes seeking easier by providing a list a seek points within the audio file. The seek points are a fractional offset within the audio data, providing a starting point from which to find an appropriate point to start decoding. The presence of an ASPI frame requires the existence of a TLEN frame, indicating the duration of the file in milliseconds. There may only be one 'audio seek point index' frame in a tag.
'Indexed data start' is a byte offset from the beginning of the file. 'Indexed data length' is the byte length of the audio data being indexed. 'Number of index points' is the number of index points, as the name implies. The recommended number is 100. 'Bits per index point' is 8 or 16, depending on the chosen precision. 8 bits works well for short files (less than 5 minutes of audio), while 16 bits is advantageous for long files. 'Fraction at index' is the numerator of the fraction representing a relative position in the data. The denominator is 2 to the power of b.
Here are the algorithms to be used in the calculation. The known data must be the offset of the start of the indexed data (S), the offset of the end of the indexed data (E), the number of index points (N), the offset at index i (Oi). We calculate the fraction at index i (Fi).
Oi is the offset of the frame whose start is soonest after the point for which the time offset is (i/N * duration).
The frame data should be calculated as follows:
Fi = Oi/L * 2^b (rounded down to the nearest integer)
Offset calculation should be calculated as follows from data in the frame:
Oi = (Fi/2^b)*L (rounded up to the nearest integer)</description>
<string name="Frame ID" id="2776" type="fixed-length">
<fixedvalues>
<fixedvalue name="ASPI" value="ASPI"/>
</fixedvalues>
</string>
<number name="Size" id="2777" type="integer"/>
<number name="Indexed data start (S)" id="2786" type="integer" length="4"/>
<number name="Indexed data length (L)" id="2787" type="integer" length="4"/>
<number name="NumberOfIndexPoints" id="2788" type="integer" length="2"/>
<number name="BitsPerIndexPoint" id="2789" type="integer" length="1"/>
<number name="Fraction at index (Fi)" id="2790" repeatmin="0" repeatmax="NumberOfIndexPoints" type="integer" length="BitsPerIndexPoint" lengthunit="bit"/>
</structure>
<structure name="COMM Frame - Comments" id="2201" extends="id:2377" valueexpression="The actual text">
<description>This frame is indended for any kind of full text information that does not fit in any other frame. It consists of a frame header followed by encoding, language and content descriptors and is ended with the actual comment as a text string. Newline characters are allowed in the comment text string. There may be more than one comment frame in each tag, but only one with the same language and content descriptor.</description>
<string name="Frame ID" id="2792" type="fixed-length">
<fixedvalues>
<fixedvalue name="COMM" value="COMM"/>
</fixedvalues>
</string>
<number name="Size" id="2793" type="integer"/>
<number name="Text encoding" id="2802" type="integer" length="1"/>
<string name="Language" id="2803" type="fixed-length" length="3"/>
<string name="Short content description" id="2804" type="zero-terminated"/>
<string name="The actual text" id="2805" type="fixed-length" length="remaining"/>
</structure>
<structure name="COMR Frame - Commercial frame" id="2203" extends="id:2377">
<description>This frame enables several competing offers in the same tag by bundling all needed information. That makes this frame rather complex but it's an easier solution than if one tries to achieve the same result with several frames. The frame begins, after the frame ID, size and encoding fields, with a price string field. A price is constructed by one three character currency code, encoded according to ISO-4217 alphabetic currency code, followed by a numerical value where "." is used as decimal seperator. In the price string several prices may be concatenated, seperated by a "/" character, but there may only be one currency of each type.
The price string is followed by an 8 character date string in the format YYYYMMDD, describing for how long the price is valid. After that is a contact URL, with which the user can contact the seller, followed by a one byte 'received as' field.
Next follows a terminated string with the name of the seller followed by a terminated string with a short description of the product. The last thing is the ability to include a company logotype. The first of them is the 'Picture MIME type' field containing information about which picture format is used. In the event that the MIME media type name is omitted, "image/" will be implied. Currently only "image/png" and "image/jpeg" are allowed. This format string is followed by the binary picture data. This two last fields may be omitted if no picture is to attach.</description>
<string name="Frame ID" id="2807" type="fixed-length">
<fixedvalues>
<fixedvalue name="COMR" value="COMR"/>
</fixedvalues>
</string>
<number name="Size" id="2808" type="integer"/>
<number name="Text encoding" id="2817" type="integer" length="1"/>
<string name="Price string" id="2818" type="zero-terminated"/>
<string name="Valid until" id="2819" type="fixed-length" length="8"/>
<string name="Contact URL" id="2820" type="zero-terminated"/>
<number name="Received as" id="2821" type="integer" length="1">
<fixedvalues>
<fixedvalue name="Other" value="0"/>
<fixedvalue name="Standard CD album with other songs" value="1"/>
<fixedvalue name="Compressed audio on CD" value="2"/>
<fixedvalue name="File over the Internet" value="3"/>
<fixedvalue name="Stream over the Internet" value="4"/>
<fixedvalue name="As note sheets" value="5"/>
<fixedvalue name="As note sheets in a book with other sheets" value="6"/>
<fixedvalue name="Music on other media" value="7"/>
<fixedvalue name="Non-musical merchandise" value="8"/>
</fixedvalues>
</number>
<string name="Seller" id="2822" type="zero-terminated"/>
<string name="Description" id="2823" type="zero-terminated"/>
<string name="Picture MIME type" id="2824" repeatmin="0" type="zero-terminated"/>
<binary name="Picture data" id="2825" repeatmin="0" length="remaining"/>
</structure>
<structure name="ENCR Frame - Encryption method registration" id="2205" extends="id:2377">
<description>To identify with which method a frame has been encrypted the encryption method must be registered in the tag with this frame. The 'Owner identifier' is a null-terminated string with a URL containing an email address, or a link to a location where an email address can be found, that belongs to the organisation responsible for this specific encryption method. Questions regarding the encryption method should be sent to the indicated email address. The 'Method symbol' contains a value that is associated with this method throughout the whole tag. Values below $80 are reserved. The 'Method symbol' may optionally be followed by encryption specific data. There may be several "ENCR" frames in a tag but only one containing the same symbol and only one containing the same owner identifier. The method must be used somewhere in the tag.</description>
<string name="Frame ID" id="2827" type="fixed-length">
<fixedvalues>
<fixedvalue name="ENCR" value="ENCR"/>
</fixedvalues>
</string>
<number name="Size" id="2828" type="integer"/>
<string name="Owner identifier" id="2837" type="zero-terminated"/>
<number name="Method symbol" id="2838" type="integer" length="1"/>
<binary name="Encryption data" id="2839" length="remaining"/>
</structure>
<structure name="EQUA Frame - Equalization" id="2207" extends="id:2377">
<description>This is another subjective, alignment frame. It allows the user to predefine an equalisation curve within the audio file. There may only be one "EQUA" frame in each tag.
The 'adjustment bits' field defines the number of bits used for representation of the adjustment. This is normally $10 (16 bits) for MPEG 2 layer I, II and III and MPEG 2.5. This value may not be $00.
This is followed by 2 bytes + ('adjustment bits' rounded up to the nearest byte) for every equalisation band in the following format, giving a frequency range of 0 - 32767Hz
The increment/decrement bit is 1 for increment and 0 for decrement. The equalisation bands should be ordered increasingly with reference to frequency. All frequencies don't have to be declared. The equalisation curve in the reading software should be interpolated between the values in this frame. Three equal adjustments for three subsequent frequencies. A frequency should only be described once in the frame.</description>
<string name="Frame ID" id="2841" type="fixed-length">
<fixedvalues>
<fixedvalue name="EQUA" value="EQUA"/>
</fixedvalues>
</string>
<number name="Size" id="2842" type="integer"/>
<number name="AdjustmentBits" id="2851" type="integer" length="1"/>
<number name="Increment/decrement" id="2852" type="integer" length="1" lengthunit="bit"/>
<number name="Frequency" id="2853" type="integer" length="15" lengthunit="bit"/>
<number name="Adjustment" id="2854" type="integer" length="AdjustmentBits" lengthunit="bit"/>
</structure>
<structure name="EQU2 Frame - Equalisation (2)" id="2209" extends="id:2377">
<description>This is another subjective, alignment frame. It allows the user to predefine an equalisation curve within the audio file. There may be more than one "EQU2" frame in each tag, but only one with the same identification string.
The 'interpolation method' describes which method is preferred when an interpolation between the adjustment point that follows. The following methods are currently defined:
$00 Band
No interpolation is made. A jump from one adjustment level to
another occurs in the middle between two adjustment points.
$01 Linear
Interpolation between adjustment points is linear.
The 'identification' string is used to identify the situation and/or device where this adjustment should apply. The following is then repeated for every adjustment point
Frequency $xx xx
Volume adjustment $xx xx
The frequency is stored in units of 1/2 Hz, giving it a range from 0 to 32767 Hz.
The volume adjustment is encoded as a fixed point decibel value, 16 bit signed integer representing (adjustment*512), giving +/- 64 dB with a precision of 0.001953125 dB. E.g. +2 dB is stored as $04 00 and -2 dB is $FC 00.
Adjustment points should be ordered by frequency and one frequency should only be described once in the frame.</description>
<string name="Frame ID" id="2856" type="fixed-length">
<fixedvalues>
<fixedvalue name="EQU2" value="EQU2"/>
</fixedvalues>
</string>
<number name="Size" id="2857" type="integer"/>
<number name="Interpolation method" id="2866" type="integer" length="1">
<description>The 'interpolation method' describes which method is preferred when an interpolation between the adjustment point that follows. The following methods are currently defined:
$00 Band
No interpolation is made. A jump from one adjustment level to
another occurs in the middle between two adjustment points.
$01 Linear
Interpolation between adjustment points is linear.</description>
<fixedvalues>
<fixedvalue name="Band" value="0"/>
<fixedvalue name="Linear" value="1"/>
</fixedvalues>
</number>
<string name="Identification" id="2867" type="zero-terminated">
<description>The 'identification' string is used to identify the situation and/or device where this adjustment should apply.</description>
</string>
<structure name="Adjustment point" id="2868" repeatmin="0" repeatmax="-1">
<description>Adjustment points should be ordered by frequency and one frequency should only be described once in the frame.</description>
<number name="Frequency" id="2869" type="integer" length="2">
<description>The frequency is stored in units of 1/2 Hz, giving it a range from 0 to 32767 Hz.</description>
</number>
<number name="Volume adjustment" id="2870" type="integer" length="2">
<description>The volume adjustment is encoded as a fixed point decibel value, 16 bit signed integer representing (adjustment*512), giving +/- 64 dB with a precision of 0.001953125 dB. E.g. +2 dB is stored as $04 00 and -2 dB is $FC 00.</description>
</number>
</structure>
</structure>
<structure name="ETCO Frame - Event timing codes" id="2211" extends="id:2377">
<description>This frame allows synchronisation with key events in a song or sound.
Terminating the start events such as "intro start" is not required. The 'Not predefined sync's ($E0-EF) are for user events. You might want to synchronise your music to something, like setting of an explosion on-stage, turning on your screensaver etc.
There may only be one "ETCO" frame in each tag.</description>
<string name="Frame ID" id="2873" type="fixed-length">
<fixedvalues>
<fixedvalue name="ETCO" value="ETCO"/>
</fixedvalues>
</string>
<number name="Size" id="2874" type="integer"/>
<number name="Time stamp format" id="2883" type="integer" length="1">
<fixedvalues>
<fixedvalue name="Absolute time, 32 bit sized, using MPEG frames as unit1" value="1"/>
<fixedvalue name="Absolute time, 32 bit sized, using milliseconds as unit" value="2"/>
</fixedvalues>
</number>
<structure name="Key event" id="2884" repeatmin="0" repeatmax="-1">
<number name="Type" id="2885" type="integer" length="1" display="hex">
<fixedvalues>
<fixedvalue name="padding (has no meaning)" value="0x0"/>
<fixedvalue name="end of initial silence" value="0x1"/>
<fixedvalue name="intro start" value="0x2"/>
<fixedvalue name="mainpart start" value="0x3"/>
<fixedvalue name="outro start" value="0x4"/>
<fixedvalue name="outro end" value="0x5"/>
<fixedvalue name="verse start" value="0x6"/>
<fixedvalue name="refrain start" value="0x7"/>
<fixedvalue name="interlude start" value="0x8"/>
<fixedvalue name="theme start" value="0x9"/>
<fixedvalue name="variation start" value="0xA"/>
<fixedvalue name="key change" value="0xB"/>
<fixedvalue name="time change" value="0xC"/>
<fixedvalue name="momentary unwanted noise (Snap, Crackle & Pop)" value="0xD"/>
<fixedvalue name="sustained noise" value="0xE"/>
<fixedvalue name="sustained noise end" value="0xF"/>
<fixedvalue name="intro end" value="0x10"/>
<fixedvalue name="mainpart end" value="0x11"/>
<fixedvalue name="verse end" value="0x12"/>
<fixedvalue name="refrain end" value="0x13"/>
<fixedvalue name="theme end" value="0x14"/>
<fixedvalue name="not predefined sync 0" value="0xE0"/>
<fixedvalue name="not predefined sync 1" value="0xE1"/>
<fixedvalue name="not predefined sync 2" value="0xE2"/>
<fixedvalue name="not predefined sync 3" value="0xE3"/>
<fixedvalue name="not predefined sync 4" value="0xE4"/>
<fixedvalue name="not predefined sync 5" value="0xE5"/>
<fixedvalue name="not predefined sync 6" value="0xE6"/>
<fixedvalue name="not predefined sync 7" value="0xE7"/>
<fixedvalue name="not predefined sync 8" value="0xE8"/>
<fixedvalue name="not predefined sync 9" value="0xE9"/>
<fixedvalue name="not predefined sync A" value="0xEA"/>
<fixedvalue name="not predefined sync B" value="0xEB"/>
<fixedvalue name="not predefined sync C" value="0xEC"/>
<fixedvalue name="not predefined sync D" value="0xED"/>
<fixedvalue name="not predefined sync E" value="0xEE"/>
<fixedvalue name="not predefined sync F" value="0xEF"/>
<fixedvalue name="audio end (start of silence)" value="0xFD"/>
<fixedvalue name="audio file ends" value="0xFE"/>
<fixedvalue name="one more byte of events follows (all the following bytes with the value $FF have the same function)" value="0xFF"/>
</fixedvalues>
</number>
<number name="Time stamp" id="2886" type="integer" length="1"/>
</structure>
</structure>
<structure name="GEOB Frame - General encapsulated object" id="2213" extends="id:2377">
<description>In this frame any type of file can be encapsulated. After the header, 'Frame size' and 'Encoding' follows 'MIME type' represented as as a terminated string encoded with ISO-8859-1. The filename is case sensitive and is encoded as 'Encoding'. Then follows a content description as terminated string, encoded as 'Encoding'. The last thing in the frame is the actual object. The first two strings may be omitted, leaving only their terminations. There may be more than one "GEOB" frame in each tag, but only one with the same content descriptor.</description>
<string name="Frame ID" id="2889" type="fixed-length">
<fixedvalues>
<fixedvalue name="GEOB" value="GEOB"/>
</fixedvalues>
</string>
<number name="Size" id="2890" type="integer"/>
<number name="Text encoding" id="2899" type="integer" length="1"/>
<string name="MIME type" id="2900" type="zero-terminated"/>
<string name="Filename" id="2901" type="zero-terminated"/>
<string name="Content description" id="2902" type="zero-terminated"/>
<binary name="Encapsulated object" id="2903" length="remaining"/>
</structure>
<structure name="GRID Frame - Group identification registration" id="2215" extends="id:2377">
<description>This frame enables grouping of otherwise unrelated frames. This can be used when some frames are to be signed. To identify which frames belongs to a set of frames a group identifier must be registered in the tag with this frame. The 'Owner identifier' is a null-terminated string with a URL containing an email address, or a link to a location where an email address can be found, that belongs to the organisation responsible for this grouping. Questions regarding the grouping should be sent to the indicated email address. The 'Group symbol' contains a value that associates the frame with this group throughout the whole tag. Values below $80 are reserved. The 'Group symbol' may optionally be followed by some group specific data, e.g. a digital signature. There may be several "GRID" frames in a tag but only one containing the same symbol and only one containing the same owner identifier. The group symbol must be used somewhere in the tag.</description>
<string name="Frame ID" id="2905" type="fixed-length">
<fixedvalues>
<fixedvalue name="GRID" value="GRID"/>
</fixedvalues>
</string>
<number name="Size" id="2906" type="integer"/>
<string name="Owner identifier" id="2915" type="zero-terminated"/>
<number name="Group symbol" id="2916" type="integer" length="1"/>
<binary name="Group dependent data" id="2917" length="remaining"/>
</structure>
<structure name="IPLS Frame - Involved people list" id="2217" extends="id:2377">
<description>Since there might be a lot of people contributing to an audio file in various ways, such as musicians and technicians, the 'Text information frames' are often insufficient to list everyone involved in a project. The 'Involved people list' is a frame containing the names of those involved, and how they were involved. The body simply contains a terminated string with the involvement directly followed by a terminated string with the involvee followed by a new involvement and so on. There may only be one "IPLS" frame in each tag.</description>
<string name="Frame ID" id="2919" type="fixed-length">
<fixedvalues>
<fixedvalue name="IPLS" value="IPLS"/>
</fixedvalues>
</string>
<number name="Size" id="2920" type="integer"/>
<number name="Text encoding" id="2929" type="integer" length="1"/>
<string name="People list strings" id="2930" type="fixed-length" length="remaining"/>
</structure>
<structure name="LINK Frame - Linked information" id="2219" extends="id:2377">
<description>To keep space waste as low as possible this frame may be used to link information from another ID3v2 tag that might reside in another audio file or alone in a binary file. It is recommended that this method is only used when the files are stored on a CD-ROM or other circumstances when the risk of file seperation is low. The frame contains a frame identifier, which is the frame that should be linked into this tag, a URL field, where a reference to the file where the frame is given, and additional ID data, if needed. Data should be retrieved from the first tag found in the file to which this link points. There may be more than one "LINK" frame in a tag, but only one with the same contents. A linked frame is to be considered as part of the tag and has the same restrictions as if it was a physical part of the tag (i.e. only one "RVRB" frame allowed, whether it's linked or not).
Frames that may be linked and need no additional data are "IPLS", "MCID", "ETCO", "MLLT", "SYTC", "RVAD", "EQUA", "RVRB", "RBUF", the text information frames and the URL link frames.
The "TXXX", "APIC", "GEOB" and "AENC" frames may be linked with the content descriptor as additional ID data.
The "COMM", "SYLT" and "USLT" frames may be linked with three bytes of language descriptor directly followed by a content descriptor as additional ID data.</description>
<string name="Frame ID" id="2932" type="fixed-length">
<fixedvalues>
<fixedvalue name="LINK" value="LINK"/>
</fixedvalues>
</string>
<number name="Size" id="2933" type="integer"/>
<string name="Frame identifier" id="2942" type="fixed-length" length="3"/>
<string name="URL" id="2943" type="zero-terminated"/>
<string name="ID and additional data" id="2944" type="fixed-length" length="remaining"/>
</structure>
<structure name="MCDI Frame - Music CD identifier" id="2946" extends="id:2377">
<description>This frame is intended for music that comes from a CD, so that the CD can be identified in databases such as the CDDB. The frame consists of a binary dump of the Table Of Contents, TOC, from the CD, which is a header of 4 bytes and then 8 bytes/track on the CD plus 8 bytes for the 'lead out' making a maximum of 804 bytes. The offset to the beginning of every track on the CD should be described with a four bytes absolute CD-frame address per track, and not with absolute time. This frame requires a present and valid "TRCK" frame, even if the CD's only got one track. There may only be one "MCDI" frame in each tag.</description>
<string name="Frame ID" id="2947" type="fixed-length">
<fixedvalues>
<fixedvalue name="MCDI" value="MCDI"/>
</fixedvalues>
</string>
<number name="Size" id="2948" type="integer"/>
<binary name="CD TOC" id="2957" length="remaining"/>
</structure>
<structure name="MLLT Frame - MPEG location lookup table" id="2221" extends="id:2377">
<description>To increase performance and accuracy of jumps within a MPEG audio file, frames with timecodes in different locations in the file might be useful. The ID3v2 frame includes references that the software can use to calculate positions in the file. After the frame header is a descriptor of how much the 'frame counter' should increase for every reference. If this value is two then the first reference points out the second frame, the 2nd reference the 4th frame, the 3rd reference the 6th frame etc. In a similar way the 'bytes between reference' and 'milliseconds between reference' points out bytes and milliseconds respectively.
Each reference consists of two parts; a certain number of bits, as defined in 'bits for bytes deviation', that describes the difference between what is said in 'bytes between reference' and the reality and a certain number of bits, as defined in 'bits for milliseconds deviation', that describes the difference between what is said in 'milliseconds between reference' and the reality. The number of bits in every reference, i.e. 'bits for bytes deviation'+'bits for milliseconds deviation', must be a multiple of four. There may only be one "MLLT" frame in each tag.</description>
<string name="Frame ID" id="2959" type="fixed-length">
<fixedvalues>
<fixedvalue name="MLLT" value="MLLT"/>
</fixedvalues>
</string>
<number name="Size" id="2960" type="integer"/>
<number name="MPEG frames between reference" id="2969" type="integer" length="2"/>
<number name="Bytes between reference" id="2970" type="integer" length="3"/>
<number name="Milliseconds between reference" id="2971" type="integer" length="3"/>
<number name="Bits for bytes deviation" id="2972" type="integer" length="1"/>
<number name="Bits for milliseconds dev." id="2973" type="integer" length="1"/>
<structure name="Deviation" id="2974" repeatmin="0" repeatmax="-1">
<number name="in bytes" id="2975" type="integer" length="1"/>
<number name="in milliseconds" id="2976" type="integer" length="1"/>
</structure>
</structure>
<structure name="OWNE Frame - Ownership frame" id="2223" extends="id:2377">
<description>The ownership frame might be used as a reminder of a made transaction or, if signed, as proof. Note that the "USER" and "TOWN" frames are good to use in conjunction with this one. The frame begins, after the frame ID, size and encoding fields, with a 'price payed' field. The first three characters of this field contains the currency used for the transaction, encoded according to ISO-4217 alphabetic currency code. Concatenated to this is the actual price payed, as a numerical string using "." as the decimal separator. Next is an 8 character date string (YYYYMMDD) followed by a string with the name of the seller as the last field in the frame. There may only be one "OWNE" frame in a tag.</description>
<string name="Frame ID" id="2979" type="fixed-length">
<fixedvalues>
<fixedvalue name="OWNE" value="OWNE"/>
</fixedvalues>
</string>
<number name="Size" id="2980" type="integer"/>
<number name="Text encoding" id="2989" type="integer" length="1"/>
<string name="Price payed" id="2990" type="zero-terminated"/>
<string name="Date of purchase" id="2991" type="zero-terminated"/>
<string name="Seller" id="2992" type="fixed-length" length="remaining"/>
</structure>
<structure name="PRIV Frame - Ownership frame" id="2225" extends="id:2377">
<description>This frame is used to contain information from a software producer that its program uses and does not fit into the other frames. The frame consists of an 'Owner identifier' string and the binary data. The 'Owner identifier' is a null-terminated string with a URL containing an email address, or a link to a location where an email address can be found, that belongs to the organisation responsible for the frame. Questions regarding the frame should be sent to the indicated email address. The tag may contain more than one "PRIV" frame but only with different contents. It is recommended to keep the number of "PRIV" frames as low as possible.</description>
<string name="Frame ID" id="2994" type="fixed-length">
<fixedvalues>
<fixedvalue name="PRIV" value="PRIV"/>
</fixedvalues>
</string>
<number name="Size" id="2995" type="integer"/>
<string name="Owner identifier" id="3004" type="zero-terminated"/>
<binary name="The private data" id="3005" length="remaining"/>
</structure>
<structure name="PCNT Frame - Play counter" id="2227" extends="id:2377">
<description>This is simply a counter of the number of times a file has been played. The value is increased by one every time the file begins to play. There may only be one "PCNT" frame in each tag. When the counter reaches all one's, one byte is inserted in front of the counter thus making the counter eight bits bigger. The counter must be at least 32-bits long to begin with.</description>
<string name="Frame ID" id="3007" type="fixed-length">
<fixedvalues>
<fixedvalue name="PCNT" value="PCNT"/>
</fixedvalues>
</string>
<number name="Size" id="3008" type="integer"/>
<number name="Counter" id="3017" type="integer" length="4"/>
</structure>
<structure name="POPM Frame - Popularimeter" id="2229" extends="id:2377">
<description>The purpose of this frame is to specify how good an audio file is. Many interesting applications could be found to this frame such as a playlist that features better audiofiles more often than others or it could be used to profile a person's taste and find other 'good' files by comparing people's profiles. The frame is very simple. It contains the email address to the user, one rating byte and a four byte play counter, intended to be increased with one for every time the file is played. The email is a terminated string. The rating is 1-255 where 1 is worst and 255 is best. 0 is unknown. If no personal counter is wanted it may be omitted. When the counter reaches all one's, one byte is inserted in front of the counter thus making the counter eight bits bigger in the same away as the play counter ("PCNT"). There may be more than one "POPM" frame in each tag, but only one with the same email address.</description>
<string name="Frame ID" id="3019" type="fixed-length">
<fixedvalues>
<fixedvalue name="POPM" value="POPM"/>
</fixedvalues>
</string>
<number name="Size" id="3020" type="integer"/>
<string name="Email to user" id="3029" type="zero-terminated"/>
<number name="Rating" id="3030" type="integer" length="1"/>
<number name="Counter" id="3031" type="integer" length="4"/>
</structure>
<structure name="POSS Frame - Position synchronisation frame" id="2231" extends="id:2377">
<description>This frame delivers information to the listener of how far into the audio stream he picked up; in effect, it states the time offset of the first frame in the stream.#
If this frame is used in the beginning of a file the value is always 0. There may only be one "POSS" frame in each tag.</description>
<string name="Frame ID" id="3033" type="fixed-length">
<fixedvalues>
<fixedvalue name="POSS" value="POSS"/>
</fixedvalues>
</string>
<number name="Size" id="3034" type="integer"/>
<number name="Time stamp format" id="3043" type="integer" length="1">
<fixedvalues>
<fixedvalue name="Absolute time, 32 bit sized, using MPEG frames as unit" value="1"/>
<fixedvalue name="Absolute time, 32 bit sized, using milliseconds as unit" value="2"/>
</fixedvalues>
</number>
</structure>
<structure name="RBUF Frame - Recommended buffer size" id="2233" extends="id:2377">
<description>Sometimes the server from which a audio file is streamed is aware of transmission or coding problems resulting in interruptions in the audio stream. In these cases, the size of the buffer can be recommended by the server using this frame. If the 'embedded info flag' is true (1) then this indicates that an ID3 tag with the maximum size described in 'Buffer size' may occur in the audiostream. In such case the tag should reside between two MPEG frames, if the audio is MPEG encoded. If the position of the next tag is known, 'offset to next tag' may be used. The offset is calculated from the end of tag in which this frame resides to the first byte of the header in the next. This field may be omitted. Embedded tags are generally not recommended since this could render unpredictable behaviour from present software/hardware.
For applications like streaming audio it might be an idea to embed tags into the audio stream though. If the clients connects to individual connections like HTTP and there is a possibility to begin every transmission with a tag, then this tag should include a 'recommended buffer size' frame. If the client is connected to a arbitrary point in the stream, such as radio or multicast, then the 'recommended buffer size' frame should be included in every tag. Every tag that is picked up after the initial/first tag is to be considered as an update of the previous one. E.g. if there is a "TIT2" frame in the first received tag and one in the second tag, then the first should be 'replaced' with the second.
The 'Buffer size' should be kept to a minimum. There may only be one "RBUF" frame in each tag.</description>
<string name="Frame ID" id="3045" type="fixed-length">
<fixedvalues>
<fixedvalue name="RBUF" value="RBUF"/>
</fixedvalues>
</string>
<number name="Size" id="3046" type="integer"/>
<number name="Buffer size" id="3055" type="integer" length="3"/>
<number name="Embedded info flag" id="3056" type="integer" length="1"/>
<number name="Offset to next tag" id="3057" type="integer" length="4"/>
</structure>
<structure name="RVAD Frame - Relative volume adjustment" id="2235" extends="id:2377">
<description>This is a more subjective function than the previous ones. It allows the user to say how much he wants to increase/decrease the volume on each channel while the file is played. The purpose is to be able to align all files to a reference volume, so that you don't have to change the volume constantly. This frame may also be used to balance adjust the audio. If the volume peak levels are known then this could be described with the 'Peak volume right' and 'Peak volume left' field. If Peakvolume is not known these fields could be left zeroed or, if no other data follows, be completely omitted. There may only be one "RVAD" frame in each tag.
In the increment/decrement field bit 0 is used to indicate the right channel and bit 1 is used to indicate the left channel. 1 is increment and 0 is decrement.
The 'bits used for volume description' field is normally $10 (16 bits) for MPEG 2 layer I, II and III and MPEG 2.5. This value may not be $00. The volume is always represented with whole bytes, padded in the beginning (highest bits) when 'bits used for volume description' is not a multiple of eight.
This datablock is then optionally followed by a volume definition for the left and right back channels. If this information is appended to the frame the first two channels will be treated as front channels. In the increment/decrement field bit 2 is used to indicate the right back channel and bit 3 for the left back channel.
If the center channel adjustment is present the following is appended to the existing frame, after the left and right back channels. The center channel is represented by bit 4 in the increase/decrease field.
If the bass channel adjustment is present the following is appended to the existing frame, after the center channel. The bass channel is represented by bit 5 in the increase/decrease field.</description>
<string name="Frame ID" id="3059" type="fixed-length">
<fixedvalues>
<fixedvalue name="RVAD" value="RVAD"/>
</fixedvalues>
</string>
<number name="Size" id="3060" type="integer"/>
<number name="Increment/decrement" id="3069" type="integer" length="1"/>
<number name="BitsUsedForVolumeDescription" id="3070" type="integer" length="1"/>
<number name="Relative volume change, right" id="3071" type="integer" length="BitsUsedForVolumeDescription" lengthunit="bit"/>
<number name="Relative volume change, left" id="3072" type="integer" length="BitsUsedForVolumeDescription" lengthunit="bit"/>
<number name="Peak volume right" id="3073" type="integer" length="BitsUsedForVolumeDescription" lengthunit="bit"/>
<number name="Peak volume left" id="3074" type="integer" length="BitsUsedForVolumeDescription" lengthunit="bit"/>
</structure>
<structure name="RVA2 Frame - Relative volume adjustment (2)" id="2237" extends="id:2377">
<description>This is a more subjective frame than the previous ones. It allows the user to say how much he wants to increase/decrease the volume on each channel when the file is played. The purpose is to be able to align all files to a reference volume, so that you don't have to change the volume constantly. This frame may also be used to balance adjust the audio. The volume adjustment is encoded as a fixed point decibel value, 16 bit signed integer representing (adjustment*512), giving +/- 64 dB with a precision of 0.001953125 dB. E.g. +2 dB is stored as $04 00 and -2 dB is $FC 00. There may be more than one "RVA2" frame in each tag, but only one with the same identification string.
The 'identification' string is used to identify the situation and/or device where this adjustment should apply. The following is then repeated for every channel
Bits representing peak can be any number between 0 and 255. 0 means that there is no peak volume field. The peak volume field is always padded to whole bytes, setting the most significant bits to zero.</description>
<string name="Frame ID" id="3076" type="fixed-length">
<fixedvalues>
<fixedvalue name="RVA2" value="RVA2"/>
</fixedvalues>
</string>
<number name="Size" id="3077" type="integer"/>
<string name="Identification" id="3086" type="zero-terminated">
<description>The 'identification' string is used to identify the situation and/or device where this adjustment should apply.</description>
</string>
<structure name="Channel" id="3087" repeatmin="0" repeatmax="-1">
<number name="Type of channel" id="3088" type="integer" length="1">
<fixedvalues>
<fixedvalue name="Other" value="0"/>
<fixedvalue name="Master volume" value="1"/>
<fixedvalue name="Front right" value="2"/>
<fixedvalue name="Front left" value="3"/>
<fixedvalue name="Back right" value="4"/>
<fixedvalue name="Back left" value="5"/>
<fixedvalue name="Front centre" value="6"/>
<fixedvalue name="Back centre" value="7"/>
<fixedvalue name="Subwoofer" value="8"/>
</fixedvalues>
</number>
<number name="Volume adjustment" id="3089" type="integer" length="2"/>
<number name="BitsRepresentingPeak" id="3090" type="integer" length="1">
<description>Bits representing peak can be any number between 0 and 255. 0 means that there is no peak volume field. The peak volume field is always padded to whole bytes, setting the most significant bits to zero.</description>
</number>
<number name="Peak volume" id="3091" type="integer" length="BitsRepresentingPeak" lengthunit="bit"/>
</structure>
</structure>
<structure name="RVRB Frame - Reverb" id="2239" extends="id:2377">
<description>Yet another subjective one. You may here adjust echoes of different kinds. Reverb left/right is the delay between every bounce in ms. Reverb bounces left/right is the number of bounces that should be made. $FF equals an infinite number of bounces. Feedback is the amount of volume that should be returned to the next echo bounce. $00 is 0%, $FF is 100%. If this value were $7F, there would be 50% volume reduction on the first bounce, 50% of that on the second and so on. Left to left means the sound from the left bounce to be played in the left speaker, while left to right means sound from the left bounce to be played in the right speaker.
'Premix left to right' is the amount of left sound to be mixed in the right before any reverb is applied, where $00 id 0% and $FF is 100%. 'Premix right to left' does the same thing, but right to left. Setting both premix to $FF would result in a mono output (if the reverb is applied symmetric). There may only be one "RVRB" frame in each tag.</description>
<string name="Frame ID" id="3094" type="fixed-length">
<fixedvalues>
<fixedvalue name="RVRB" value="RVRB"/>
</fixedvalues>
</string>
<number name="Size" id="3095" type="integer"/>
<number name="Reverb left (ms)" id="3104" type="integer" length="2"/>
<number name="Reverb right (ms)" id="3105" type="integer" length="2"/>
<number name="Reverb bounces, left" id="3106" type="integer" length="1"/>
<number name="Reverb bounces, right" id="3107" type="integer" length="1"/>
<number name="Reverb feedback, left to left" id="3108" type="integer" length="1"/>
<number name="Reverb feedback, left to right" id="3109" type="integer" length="1"/>
<number name="Reverb feedback, right to right" id="3110" type="integer" length="1"/>
<number name="Reverb feedback, right to left" id="3111" type="integer" length="1"/>
<number name="Premix left to right" id="3112" type="integer" length="1"/>
<number name="Premix right to left" id="3113" type="integer" length="1"/>
</structure>
<structure name="SEEK Frame - Seek frame" id="2241" extends="id:2377">
<description>This frame indicates where other tags in a file/stream can be found. The 'minimum offset to next tag' is calculated from the end of this tag to the beginning of the next. There may only be one 'seek frame' in a tag.</description>
<string name="Frame ID" id="3115" type="fixed-length">
<fixedvalues>
<fixedvalue name="SEEK" value="SEEK"/>
</fixedvalues>
</string>
<number name="Size" id="3116" type="integer"/>
<number name="Minimum offset to next tag" id="3125" type="integer" length="4"/>
</structure>
<structure name="SIGN Frame - Signature frame" id="2243" extends="id:2377">
<description>This frame enables a group of frames, grouped with the 'Group identification registration', to be signed. Although signatures can reside inside the registration frame, it might be desired to store the signature elsewhere, e.g. in watermarks. There may be more than one 'signature frame' in a tag, but no two may be identical.</description>
<string name="Frame ID" id="3127" type="fixed-length">
<fixedvalues>
<fixedvalue name="SIGN" value="SIGN"/>
</fixedvalues>
</string>
<number name="Size" id="3128" type="integer"/>
<number name="Group symbol" id="3137" type="integer" length="1"/>
<binary name="Signature" id="3138" length="remaining"/>
</structure>
<structure name="SYLT Frame - Synchronized lyric/text" id="2245" extends="id:2377">
<description>This is another way of incorporating the words, said or sung lyrics, in the audio file as text, this time, however, in sync with the audio. It might also be used to describing events e.g. occurring on a stage or on the screen in sync with the audio. The header includes a content descriptor, represented with as terminated textstring. If no descriptor is entered, 'Content descriptor' is $00 (00) only.
The text that follows the frame header differs from that of the unsynchronised lyrics/text transcription in one major way. Each syllable (or whatever size of text is considered to be convenient by the encoder) is a null terminated string followed by a time stamp denoting where in the sound file it belongs.
The 'time stamp' is set to zero or the whole sync is omitted if located directly at the beginning of the sound. All time stamps should be sorted in chronological order. The sync can be considered as a validator of the subsequent string.
Newline ($0A) characters are allowed in all "SYLT" frames and should be used after every entry (name, event etc.) in a frame with the content type $03 - $04.
A few considerations regarding whitespace characters: Whitespace separating words should mark the beginning of a new word, thus occurring in front of the first syllable of a new word. This is also valid for new line characters. A syllable followed by a comma should not be broken apart with a sync (both the syllable and the comma should be before the sync).</description>
<string name="Frame ID" id="3140" type="fixed-length">
<fixedvalues>
<fixedvalue name="SYLT" value="SYLT"/>
</fixedvalues>
</string>
<number name="Size" id="3141" type="integer"/>
<number name="Text encoding" id="3150" type="integer" length="1">
<fixedvalues>
<fixedvalue name="ISO-8859-1 character set is used" value="0"/>
<fixedvalue name="Unicode character set is used" value="1"/>
</fixedvalues>
</number>
<string name="Language" id="3151" type="fixed-length" length="3"/>
<number name="Time stamp format" id="3152" type="integer" length="1">
<fixedvalues>
<fixedvalue name="Absolute time, 32 bit sized, using MPEG frames as unit" value="1"/>
<fixedvalue name="Absolute time, 32 bit sized, using milliseconds as unit" value="2"/>
</fixedvalues>
</number>
<number name="Content type" id="3153" type="integer" length="1">
<fixedvalues>
<fixedvalue name="is other" value="0"/>
<fixedvalue name="is lyrics" value="1"/>
<fixedvalue name="is text transcription" value="2"/>
<fixedvalue name="is movement/part name (e.g. "Adagio")" value="3"/>
<fixedvalue name="is events (e.g. "Don Quijote enters the stage")" value="4"/>
<fixedvalue name="is chord (e.g. "Bb F Fsus")" value="5"/>
<fixedvalue name="is trivia/'pop up' information" value="6"/>
</fixedvalues>
</number>
<string name="Content descriptor" id="3154" type="zero-terminated"/>
<structure name="Content" id="3155" repeatmin="0" repeatmax="-1">
<string name="Text" id="3156" type="zero-terminated"/>
<number name="Time stamp" id="3157" type="integer" length="4"/>
</structure>
</structure>
<structure name="SYTC Frame - Synchronized tempo codes" id="2247" extends="id:2377">
<description>For a more accurate description of the tempo of a musical piece this frame might be used. After the header follows one byte describing which time stamp format should be used. Then follows one or more tempo codes. Each tempo code consists of one tempo part and one time part. The tempo is in BPM described with one or two bytes. If the first byte has the value $FF, one more byte follows, which is added to the first giving a range from 2 - 510 BPM, since $00 and $01 is reserved. $00 is used to describe a beat-free time period, which is not the same as a music-free time period. $01 is used to indicate one single beat-stroke followed by a beat-free period.
The tempo descriptor is followed by a time stamp. Every time the tempo in the music changes, a tempo descriptor may indicate this for the player. All tempo descriptors should be sorted in chronological order. The first beat-stroke in a time-period is at the same time as the beat description occurs. There may only be one "SYTC" frame in each tag.</description>
<string name="Frame ID" id="3160" type="fixed-length">
<fixedvalues>
<fixedvalue name="SYTC" value="SYTC"/>
</fixedvalues>
</string>
<number name="Size" id="3161" type="integer"/>
<number name="Time stamp format" id="3170" type="integer" length="1">
<fixedvalues>
<fixedvalue name="Absolute time, 32 bit sized, using MPEG frames as unit" value="1"/>
<fixedvalue name="Absolute time, 32 bit sized, using milliseconds as unit" value="2"/>
</fixedvalues>
</number>
<binary name="Tempo data" id="3171" length="remaining"/>
</structure>
<structure name="ID3v2.3 Text Information Frame" id="3173" extends="id:2377" valueexpression="Encoded String">
<description>The text information frames are the most important frames, containing information like artist, album and more. There may only be one text information frame of its kind in an tag. If the textstring is followed by a termination ($00 (00)) all the following information should be ignored and not be displayed. All text frame identifiers begin with "T". Only text frame identifiers begin with "T", with the exception of the "TXXX" frame.</description>
<string name="Frame ID" id="3174" type="fixed-length"/>
<number name="Size" id="3175" type="integer"/>
<structref name="Encoded String" id="3184" structure="id:2511"/>
</structure>
<structure name="TALB Frame - Album/Movie/Show title" id="2249" extends="id:3173">
<description>The 'Album/Movie/Show title' frame is intended for the title of the recording(/source of sound) which the audio in the file is taken from.</description>
<string name="Frame ID" id="3186" type="fixed-length">
<fixedvalues>
<fixedvalue name="TALB" value="TALB"/>
</fixedvalues>
</string>
</structure>
<structure name="TBPM Frame - BPM (beats per minute)" id="2251" extends="id:3173">
<description>The 'BPM' frame contains the number of beats per minute in the mainpart of the audio. The BPM is an integer and represented as a numerical string.</description>
<string name="Frame ID" id="3198" type="fixed-length">
<fixedvalues>
<fixedvalue name="TBPM" value="TBPM"/>
</fixedvalues>
</string>
</structure>
<structure name="TCOM Frame - Composer" id="2253" extends="id:3173">
<description>The 'Composer(s)' frame is intended for the name of the composer(s). They are seperated with the "/" character.</description>
<string name="Frame ID" id="3210" type="fixed-length">
<fixedvalues>
<fixedvalue name="TCOM" value="TCOM"/>
</fixedvalues>
</string>
</structure>
<structure name="TCON Frame - Content type" id="2255" extends="id:3173">
<description>The 'Content type', which previously was stored as a one byte numeric value only, is now a numeric string. You may use one or several of the types as ID3v1.1 did or, since the category list would be impossible to maintain with accurate and up to date categories, define your own.
References to the ID3v1 genres can be made by, as first byte, enter "(" followed by a number from the genres list (appendix A) and ended with a ")" character. This is optionally followed by a refinement, e.g. "(21)" or "(4)Eurodisco". Several references can be made in the same frame, e.g. "(51)(39)". If the refinement should begin with a "(" character it should be replaced with "((", e.g. "((I can figure out any genre)" or "(55)((I think...)". The following new content types is defined in ID3v2 and is implemented in the same way as the numerig content types, e.g. "(RX)".</description>
<string name="Frame ID" id="3222" type="fixed-length">
<fixedvalues>
<fixedvalue name="TCON" value="TCON"/>
</fixedvalues>
</string>
</structure>
<structure name="TCOP Frame - Copyright message" id="2257" extends="id:3173">
<description>The 'Copyright message' frame, which must begin with a year and a space character (making five characters), is intended for the copyright holder of the original sound, not the audio file itself. The absence of this frame means only that the copyright information is unavailable or has been removed, and must not be interpreted to mean that the sound is public domain. Every time this field is displayed the field must be preceded with "Copyright © ".</description>
<string name="Frame ID" id="3234" type="fixed-length">
<fixedvalues>
<fixedvalue name="TCOP" value="TCOP"/>
</fixedvalues>
</string>
</structure>
<structure name="TDAT Frame - Date" id="2259" extends="id:3173">
<description>The 'Date' frame is a numeric string in the DDMM format containing the date for the recording. This field is always four characters long.</description>
<string name="Frame ID" id="3246" type="fixed-length">
<fixedvalues>
<fixedvalue name="TDAT" value="TDAT"/>
</fixedvalues>
</string>
</structure>
<structure name="TDEN Frame - Encoding time" id="2261" extends="id:3173">
<description>The 'Encoding time' frame contains a timestamp describing when the audio was encoded. Timestamp format is described in the ID3v2 structure document [ID3v2-strct].</description>
<string name="Frame ID" id="3258" type="fixed-length">
<fixedvalues>
<fixedvalue name="TDEN" value="TDEN"/>
</fixedvalues>
</string>
</structure>
<structure name="TDLY Frame - Playlist delay" id="2263" extends="id:3173">
<description>The 'Playlist delay' defines the numbers of milliseconds of silence between every song in a playlist. The player should use the "ETC" frame, if present, to skip initial silence and silence at the end of the audio to match the 'Playlist delay' time. The time is represented as a numeric string.</description>
<string name="Frame ID" id="3270" type="fixed-length">
<fixedvalues>
<fixedvalue name="TDLY" value="TDLY"/>
</fixedvalues>
</string>
</structure>
<structure name="TDOR Frame - Original release time" id="2265" extends="id:3173">
<description>The 'Original release time' frame contains a timestamp describing when the original recording of the audio was released. Timestamp format is described in the ID3v2 structure document [ID3v2-strct].</description>
<string name="Frame ID" id="3282" type="fixed-length">
<fixedvalues>
<fixedvalue name="TDOR" value="TDOR"/>
</fixedvalues>
</string>
</structure>
<structure name="TDRC Frame - Recording time" id="2267" extends="id:3173">
<description>The 'Recording time' frame contains a timestamp describing when the audio was recorded. Timestamp format is described in the ID3v2 structure document [ID3v2-strct].</description>
<string name="Frame ID" id="3294" type="fixed-length">
<fixedvalues>
<fixedvalue name="TDRC" value="TDRC"/>
</fixedvalues>
</string>
</structure>
<structure name="TDRL Frame - Release time" id="2269" extends="id:3173">
<description>The 'Release time' frame contains a timestamp describing when the audio was first released. Timestamp format is described in the ID3v2 structure document [ID3v2-strct].</description>
<string name="Frame ID" id="3306" type="fixed-length">
<fixedvalues>
<fixedvalue name="TDRL" value="TDRL"/>
</fixedvalues>
</string>
</structure>
<structure name="TDTG Frame - Tagging time" id="2271" extends="id:3173">
<description>The 'Tagging time' frame contains a timestamp describing then the audio was tagged. Timestamp format is described in the ID3v2 structure document [ID3v2-strct].</description>
<string name="Frame ID" id="3318" type="fixed-length">
<fixedvalues>
<fixedvalue name="TDTG" value="TDTG"/>
</fixedvalues>
</string>
</structure>
<structure name="TENC Frame - Encoded by" id="2273" extends="id:3173">
<description>The 'Encoded by' frame contains the name of the person or organisation that encoded the audio file. This field may contain a copyright message, if the audio file also is copyrighted by the encoder.</description>
<string name="Frame ID" id="3330" type="fixed-length">
<fixedvalues>
<fixedvalue name="TENC" value="TENC"/>
</fixedvalues>
</string>
</structure>
<structure name="TEXT Frame - Lyricist/Text writer" id="2275" extends="id:3173">
<description>The 'Lyricist(s)/Text writer(s)' frame is intended for the writer(s) of the text or lyrics in the recording. They are seperated with the "/" character.</description>
<string name="Frame ID" id="3342" type="fixed-length">
<fixedvalues>
<fixedvalue name="TEXT" value="TEXT"/>
</fixedvalues>
</string>
</structure>
<structure name="TFLT Frame - File type" id="2277" extends="id:3173">
<description>The 'File type' frame indicates which type of audio this tag defines. The following type and refinements are defined:
MPG MPEG Audio
/1 MPEG 1/2 layer I
/2 MPEG 1/2 layer II
/3 MPEG 1/2 layer III
/2.5 MPEG 2.5
/AAC Advanced audio compression
VQF Transform-domain Weighted Interleave Vector Quantization
PCM Pulse Code Modulated audio
but other types may be used, not for these types though. This is used in a similar way to the predefined types in the "TMED" frame, but without parentheses. If this frame is not present audio type is assumed to be "MPG".</description>
<string name="Frame ID" id="3354" type="fixed-length">
<fixedvalues>
<fixedvalue name="TFLT" value="TFLT"/>
</fixedvalues>
</string>
</structure>
<structure name="TIME Frame - Time" id="2279" extends="id:3173">
<description>The 'Time' frame is a numeric string in the HHMM format containing the time for the recording. This field is always four characters long.</description>
<string name="Frame ID" id="3366" type="fixed-length">
<fixedvalues>
<fixedvalue name="TIME" value="TIME"/>
</fixedvalues>
</string>
</structure>
<structure name="TIPL Frame - Involved people list" id="2281" extends="id:3173">
<description>The 'Involved people list' is very similar to the musician credits list, but maps between functions, like producer, and names.</description>
<string name="Frame ID" id="3378" type="fixed-length">
<fixedvalues>
<fixedvalue name="TIPL" value="TIPL"/>
</fixedvalues>
</string>
</structure>
<structure name="TIT1 Frame - Content group description" id="2283" extends="id:3173">
<description>The 'Content group description' frame is used if the sound belongs to a larger category of sounds/music. For example, classical music is often sorted in different musical sections (e.g. "Piano Concerto", "Weather - Hurricane").</description>
<string name="Frame ID" id="3390" type="fixed-length">
<fixedvalues>
<fixedvalue name="TIT1" value="TIT1"/>
</fixedvalues>
</string>
</structure>
<structure name="TIT2 Frame - Title/songname/content description" id="2285" extends="id:3173">
<description>The 'Title/Songname/Content description' frame is the actual name of the piece (e.g. "Adagio", "Hurricane Donna").</description>
<string name="Frame ID" id="3402" type="fixed-length">
<fixedvalues>
<fixedvalue name="TIT2" value="TIT2"/>
</fixedvalues>
</string>
<string name="Text" id="3413" type="fixed-length"/>
</structure>
<structure name="TIT3 Frame - Subtitle/Description refinement" id="2287" extends="id:3173">
<description>The 'Subtitle/Description refinement' frame is used for information directly related to the contents title (e.g. "Op. 16" or "Performed live at Wembley").</description>
<string name="Frame ID" id="3415" type="fixed-length">
<fixedvalues>
<fixedvalue name="TIT3" value="TIT3"/>
</fixedvalues>
</string>
</structure>
<structure name="TKEY Frame - Initial key" id="2289" extends="id:3173">
<description>The 'Initial key' frame contains the musical key in which the sound starts. It is represented as a string with a maximum length of three characters. The ground keys are represented with "A","B","C","D","E", "F" and "G" and halfkeys represented with "b" and "#". Minor is represented as "m". Example "Cbm". Off key is represented with an "o" only.</description>
<string name="Frame ID" id="3427" type="fixed-length">
<fixedvalues>
<fixedvalue name="TKEY" value="TKEY"/>
</fixedvalues>
</string>
</structure>
<structure name="TLAN Frame - Language(s)" id="2291" extends="id:3173">
<description>The 'Language(s)' frame should contain the languages of the text or lyrics spoken or sung in the audio. The language is represented with three characters according to ISO-639-2. If more than one language is used in the text their language codes should follow according to their usage.</description>
<string name="Frame ID" id="3439" type="fixed-length">
<fixedvalues>
<fixedvalue name="TLAN" value="TLAN"/>
</fixedvalues>
</string>
</structure>
<structure name="TLEN Frame - Length" id="2293" extends="id:3173">
<description>The 'Length' frame contains the length of the audiofile in milliseconds, represented as a numeric string.</description>
<string name="Frame ID" id="3451" type="fixed-length">
<fixedvalues>
<fixedvalue name="TLEN" value="TLEN"/>
</fixedvalues>
</string>
</structure>
<structure name="TMCL Frame - Musician credits list" id="2295" extends="id:3173">
<description>The 'Musician credits list' is intended as a mapping between instruments and the musician that played it. Every odd field is an instrument and every even is an artist or a comma delimited list of artists.</description>
<string name="Frame ID" id="3463" type="fixed-length">
<fixedvalues>
<fixedvalue name="TMCL" value="TMCL"/>
</fixedvalues>
</string>
</structure>
<structure name="TMED Frame - Media type" id="2297" extends="id:3173">
<description>The 'Media type' frame describes from which media the sound originated. This may be a text string or a reference to the predefined media types found in the list below. References are made within "(" and ")" and are optionally followed by a text refinement, e.g. "(MC) with four channels". If a text refinement should begin with a "(" character it should be replaced with "((" in the same way as in the "TCO" frame. Predefined refinements is appended after the media type, e.g. "(CD/A)" or "(VID/PAL/VHS)".</description>
<string name="Frame ID" id="3475" type="fixed-length">
<fixedvalues>
<fixedvalue name="TMED" value="TMED"/>
</fixedvalues>
</string>
</structure>
<structure name="TMOO Frame - Mood" id="2299" extends="id:3173">
<description>The 'Mood' frame is intended to reflect the mood of the audio with a few keywords, e.g. "Romantic" or "Sad".</description>
<string name="Frame ID" id="3487" type="fixed-length">
<fixedvalues>
<fixedvalue name="TMOO" value="TMOO"/>
</fixedvalues>
</string>
</structure>
<structure name="TOAL Frame - Original album/movie/show title" id="2301" extends="id:3173">
<description>The 'Original album/movie/show title' frame is intended for the title of the original recording (or source of sound), if for example the music in the file should be a cover of a previously released song.</description>
<string name="Frame ID" id="3499" type="fixed-length">
<fixedvalues>
<fixedvalue name="TOAL" value="TOAL"/>
</fixedvalues>
</string>
</structure>
<structure name="TOFN Frame - Original filename" id="2303" extends="id:3173">
<description>The 'Original filename' frame contains the preferred filename for the file, since some media doesn't allow the desired length of the filename. The filename is case sensitive and includes its suffix.</description>
<string name="Frame ID" id="3511" type="fixed-length">
<fixedvalues>
<fixedvalue name="TOFN" value="TOFN"/>
</fixedvalues>
</string>
</structure>
<structure name="TOLY Frame - Original lyricist(s)/text writer(s)" id="2305" extends="id:3173">
<description>The 'Original lyricist(s)/text writer(s)' frame is intended for the text writer(s) of the original recording, if for example the music in the file should be a cover of a previously released song. The text writers are seperated with the "/" character.</description>
<string name="Frame ID" id="3523" type="fixed-length">
<fixedvalues>
<fixedvalue name="TOLY" value="TOLY"/>
</fixedvalues>
</string>
</structure>
<structure name="TOPE Frame - Original artist(s)/performer(s)" id="2307" extends="id:3173">
<description>The 'Original artist(s)/performer(s)' frame is intended for the performer(s) of the original recording, if for example the music in the file should be a cover of a previously released song. The performers are seperated with the "/" character.</description>
<string name="Frame ID" id="3535" type="fixed-length">
<fixedvalues>
<fixedvalue name="TOPE" value="TOPE"/>
</fixedvalues>
</string>
</structure>
<structure name="TORY Frame - Original release year" id="2309" extends="id:3173">
<description>The 'Original release year' frame is intended for the year when the original recording, if for example the music in the file should be a cover of a previously released song, was released. The field is formatted as in the "TYER" frame.</description>
<string name="Frame ID" id="3547" type="fixed-length">
<fixedvalues>
<fixedvalue name="TORY" value="TORY"/>
</fixedvalues>
</string>
</structure>
<structure name="TOWN Frame - File owner/licensee" id="2311" extends="id:3173">
<description>The 'File owner/licensee' frame contains the name of the owner or licensee of the file and it's contents.</description>
<string name="Frame ID" id="3559" type="fixed-length">
<fixedvalues>
<fixedvalue name="TOWN" value="TOWN"/>
</fixedvalues>
</string>
</structure>
<structure name="TPE1 Frame - Lead performer(s)/Soloist(s)" id="2313" extends="id:3173">
<description>The 'Lead artist(s)/Lead performer(s)/Soloist(s)/Performing group' is used for the main artist(s). They are seperated with the "/" character.</description>
<string name="Frame ID" id="3571" type="fixed-length">
<fixedvalues>
<fixedvalue name="TPE1" value="TPE1"/>
</fixedvalues>
</string>
</structure>
<structure name="TPE2 Frame - Band/orchestra/accompaniment" id="2315" extends="id:3173">
<description>The 'Band/Orchestra/Accompaniment' frame is used for additional information about the performers in the recording.</description>
<string name="Frame ID" id="3583" type="fixed-length">
<fixedvalues>
<fixedvalue name="TPE2" value="TPE2"/>
</fixedvalues>
</string>
</structure>
<structure name="TPE3 Frame - Conductor/performer refinement" id="2317" extends="id:3173">
<description>The 'Conductor' frame is used for the name of the conductor.</description>
<string name="Frame ID" id="3595" type="fixed-length">
<fixedvalues>
<fixedvalue name="TPE3" value="TPE3"/>
</fixedvalues>
</string>
</structure>
<structure name="TPE4 Frame - Interpreted, remixed, or otherwise modified by" id="2319" extends="id:3173">
<description>The 'Interpreted, remixed, or otherwise modified by' frame contains more information about the people behind a remix and similar interpretations of another existing piece.</description>
<string name="Frame ID" id="3607" type="fixed-length">
<fixedvalues>
<fixedvalue name="TPE4" value="TPE4"/>
</fixedvalues>
</string>
</structure>
<structure name="TPOS Frame - Part of a set" id="2321" extends="id:3173">
<description>The 'Part of a set' frame is a numeric string that describes which part of a set the audio came from. This frame is used if the source described in the "TALB" frame is divided into several mediums, e.g. a double CD. The value may be extended with a "/" character and a numeric string containing the total number of parts in the set. E.g. "1/2".</description>
<string name="Frame ID" id="3619" type="fixed-length">
<fixedvalues>
<fixedvalue name="TPOS" value="TPOS"/>
</fixedvalues>
</string>
</structure>
<structure name="TPRO Frame - Produced notice" id="2325" extends="id:3173">
<description>The 'Produced notice' frame, in which the string must begin with a year and a space character (making five characters), is intended for the production copyright holder of the original sound, not the audio file itself. The absence of this frame means only that the production copyright information is unavailable or has been removed, and must not be interpreted to mean that the audio is public domain. Every time this field is displayed the field must be preceded with "Produced " (P) " ", where (P) is one character showing a P in a circle.</description>
<string name="Frame ID" id="3631" type="fixed-length">
<fixedvalues>
<fixedvalue name="TPRO" value="TPRO"/>
</fixedvalues>
</string>
</structure>
<structure name="TPUB Frame - Publisher" id="2323" extends="id:3173">
<description>The 'Publisher' frame simply contains the name of the label or publisher.</description>
<string name="Frame ID" id="3643" type="fixed-length">
<fixedvalues>
<fixedvalue name="TPUB" value="TPUB"/>
</fixedvalues>
</string>
</structure>
<structure name="TRCK Frame - Track number/Position in set" id="2327" extends="id:3173">
<description>The 'Track number/Position in set' frame is a numeric string containing the order number of the audio-file on its original recording. This may be extended with a "/" character and a numeric string containing the total numer of tracks/elements on the original recording. E.g. "4/9".</description>
<string name="Frame ID" id="3655" type="fixed-length">
<fixedvalues>
<fixedvalue name="TRCK" value="TRCK"/>
</fixedvalues>
</string>
</structure>
<structure name="TRDA Frame - Recording dates" id="2329" extends="id:3173">
<description>The 'Recording dates' frame is a intended to be used as complement to the "TYER", "TDAT" and "TIME" frames. E.g. "4th-7th June, 12th June" in combination with the "TYER" frame.</description>
<string name="Frame ID" id="3667" type="fixed-length">
<fixedvalues>
<fixedvalue name="TRDA" value="TRDA"/>
</fixedvalues>
</string>
</structure>
<structure name="TRSN Frame - Internet radio station name" id="2331" extends="id:3173">
<description>The 'Internet radio station name' frame contains the name of the internet radio station from which the audio is streamed.</description>
<string name="Frame ID" id="3679" type="fixed-length">
<fixedvalues>
<fixedvalue name="TRSN" value="TRSN"/>
</fixedvalues>
</string>
</structure>
<structure name="TRSO Frame - Internet radio station owner" id="2333" extends="id:3173">
<description>The 'Internet radio station owner' frame contains the name of the owner of the internet radio station from which the audio is streamed.</description>
<string name="Frame ID" id="3691" type="fixed-length">
<fixedvalues>
<fixedvalue name="TRSO" value="TRSO"/>
</fixedvalues>
</string>
</structure>
<structure name="TSIZ Frame - Size" id="2335" extends="id:3173">
<description>The 'Size' frame contains the size of the audiofile in bytes, excluding the ID3v2 tag, represented as a numeric string.</description>
<string name="Frame ID" id="3703" type="fixed-length">
<fixedvalues>
<fixedvalue name="TSIZ" value="TSIZ"/>
</fixedvalues>
</string>
</structure>
<structure name="TSOA Frame - Album sort order" id="2337" extends="id:3173">
<description>The 'Album sort order' frame defines a string which should be used instead of the album name (TALB) for sorting purposes. E.g. an album named "A Soundtrack" might preferably be sorted as "Soundtrack".</description>
<string name="Frame ID" id="3715" type="fixed-length">
<fixedvalues>
<fixedvalue name="TSOA" value="TSOA"/>
</fixedvalues>
</string>
</structure>
<structure name="TSOP Frame - Performer sort order" id="2339" extends="id:3173">
<description>The 'Performer sort order' frame defines a string which should be used instead of the performer (TPE2) for sorting purposes.</description>
<string name="Frame ID" id="3727" type="fixed-length">
<fixedvalues>
<fixedvalue name="TSOP" value="TSOP"/>
</fixedvalues>
</string>
</structure>
<structure name="TSOT Frame - Title sort order" id="2341" extends="id:3173">
<description>The 'Title sort order' frame defines a string which should be used instead of the title (TIT2) for sorting purposes.</description>
<string name="Frame ID" id="3739" type="fixed-length">
<fixedvalues>
<fixedvalue name="TSOT" value="TSOT"/>
</fixedvalues>
</string>
</structure>
<structure name="TSRC Frame - ISRC (international standard recording code)" id="2343" extends="id:3173">
<description>The 'ISRC' frame should contain the International Standard Recording Code (ISRC) (12 characters).</description>
<string name="Frame ID" id="3751" type="fixed-length">
<fixedvalues>
<fixedvalue name="TSRC" value="TSRC"/>
</fixedvalues>
</string>
</structure>
<structure name="TSSE Frame - Software/Hardware and settings used for encoding" id="2345" extends="id:3173">
<description>The 'Software/Hardware and settings used for encoding' frame includes the used audio encoder and its settings when the file was encoded. Hardware refers to hardware encoders, not the computer on which a program was run.</description>
<string name="Frame ID" id="3763" type="fixed-length">
<fixedvalues>
<fixedvalue name="TSSE" value="TSSE"/>
</fixedvalues>
</string>
</structure>
<structure name="TSST Frame - Set subtitle" id="2347" extends="id:3173">
<description>The 'Set subtitle' frame is intended for the subtitle of the part of a set this track belongs to.</description>
<string name="Frame ID" id="3775" type="fixed-length">
<fixedvalues>
<fixedvalue name="TSST" value="TSST"/>
</fixedvalues>
</string>
</structure>
<structure name="TYER Frame - Year" id="2349" extends="id:3173">
<description>The 'Year' frame is a numeric string with a year of the recording. This frames is always four characters long (until the year 10000).</description>
<string name="Frame ID" id="3787" type="fixed-length">
<fixedvalues>
<fixedvalue name="TYER" value="TYER"/>
</fixedvalues>
</string>
</structure>
<structure name="TXXX Frame - User defined text information frame" id="2351" extends="id:2377" valueexpression="Value">
<description>This frame is intended for one-string text information concerning the audiofile in a similar way to the other "T"-frames. The frame body consists of a description of the string, represented as a terminated string, followed by the actual string. There may be more than one "TXXX" frame in each tag, but only one with the same description.</description>
<string name="Frame ID" id="3799" type="fixed-length">
<fixedvalues>
<fixedvalue name="TXXX" value="TXXX"/>
</fixedvalues>
</string>
<number name="Size" id="3800" type="integer"/>
<number name="Text encoding" id="3809" type="integer" length="1"/>
<string name="Description" id="3810" type="zero-terminated"/>
<string name="Value" id="3811" type="fixed-length"/>
</structure>
<structure name="UFID Frame - Unique file identifier" id="2353" extends="id:2377" valueexpression="Owner identifier">
<description>This frame's purpose is to be able to identify the audio file in a database that may contain more information relevant to the content. Since standardisation of such a database is beyond this document, all frames begin with a null-terminated string with a URL [URL] containing an email address, or a link to a location where an email address can be found, that belongs to the organisation responsible for this specific database implementation. Questions regarding the database should be sent to the indicated email address. The URL should not be used for the actual database queries. If a $00 is found directly after the 'Frame size' the whole frame should be ignored, and preferably be removed. The 'Owner identifier' is then followed by the actual identifier, which may be up to 64 bytes. There may be more than one "UFI" frame in a tag, but only one with the same 'Owner identifier'.</description>
<string name="Frame ID" id="3813" type="fixed-length">
<fixedvalues>
<fixedvalue name="UFID" value="UFID"/>
</fixedvalues>
</string>
<number name="Size" id="3814" type="integer"/>
<string name="Owner identifier" id="3823" type="zero-terminated"/>
<binary name="Identifier" id="3824" length="remaining"/>
</structure>
<structure name="USER Frame - Terms of use" id="2355" extends="id:2377">
<description>This frame contains a brief description of the terms of use and ownership of the file. More detailed information concerning the legal terms might be available through the "WCOP" frame. Newlines are allowed in the text. There may only be one "USER" frame in a tag.</description>
<string name="Frame ID" id="3826" type="fixed-length">
<fixedvalues>
<fixedvalue name="USER" value="USER"/>
</fixedvalues>
</string>
<number name="Size" id="3827" type="integer"/>
<number name="Text encoding" id="3836" type="integer" length="1"/>
<string name="Language" id="3837" type="fixed-length" length="3"/>
<string name="The actual text" id="3838" type="fixed-length" length="remaining"/>
</structure>
<structure name="USLT Frame - Unsychronized lyric/text transcription" id="2357" extends="id:2377" valueexpression="Lyrics/text">
<description>This frame contains the lyrics of the song or a text transcription of other vocal activities. The head includes an encoding descriptor and a content descriptor. The body consists of the actual text. The 'Content descriptor' is a terminated string. If no descriptor is entered, 'Content descriptor' is $00 (00) only. Newline characters are allowed in the text. There may be more than one 'Unsynchronised lyrics/text transcription' frame in each tag, but only one with the same language and content descriptor.</description>
<string name="Frame ID" id="3840" type="fixed-length">
<fixedvalues>
<fixedvalue name="USLT" value="USLT"/>
</fixedvalues>
</string>
<number name="Size" id="3841" type="integer"/>
<number name="Text encoding" id="3850" type="integer" length="1"/>
<string name="Language" id="3851" type="fixed-length" length="3"/>
<string name="Content descriptor" id="3852" type="zero-terminated"/>
<string name="Lyrics/text" id="3853" type="fixed-length" length="remaining"/>
</structure>
<structure name="ID3v2.3 URL link frame" id="3855" extends="id:2377" valueexpression="URL">
<description>With these frames dynamic data such as webpages with touring information, price information or plain ordinary news can be added to the tag. There may only be one URL link frame of its kind in an tag, except when stated otherwise in the frame description. If the textstring is followed by a termination ($00 (00)) all the following information should be ignored and not be displayed. All URL link frame identifiers begins with "W". Only URL link frame identifiers begins with "W".</description>
<string name="Frame ID" id="3856" type="fixed-length"/>
<number name="Size" id="3857" type="integer"/>
<string name="URL" id="3866" type="fixed-length"/>
</structure>
<structure name="WCOM Frame - Commercial information" id="2359" extends="id:3855">
<description>The 'Commercial information' frame is a URL pointing at a webpage with information such as where the album can be bought. There may be more than one "WCOM" frame in a tag, but not with the same content.</description>
<string name="Frame ID" id="3868" type="fixed-length">
<fixedvalues>
<fixedvalue name="WCOM" value="WCOM"/>
</fixedvalues>
</string>
</structure>
<structure name="WCOP Frame - Copyright/Legal information" id="2361" extends="id:3855">
<description>The 'Copyright/Legal information' frame is a URL pointing at a webpage where the terms of use and ownership of the file is described.</description>
<string name="Frame ID" id="3880" type="fixed-length">
<fixedvalues>
<fixedvalue name="WCOP" value="WCOP"/>
</fixedvalues>
</string>
</structure>
<structure name="WOAF Frame - Official audio file webpage" id="2363" extends="id:3855">
<description>The 'Official audio file webpage' frame is a URL pointing at a file specific webpage.</description>
<string name="Frame ID" id="3892" type="fixed-length">
<fixedvalues>
<fixedvalue name="WOAF" value="WOAF"/>
</fixedvalues>
</string>
</structure>
<structure name="WOAR Frame - Official artist/performer webpage" id="2365" extends="id:3855">
<description>The 'Official artist/performer webpage' frame is a URL pointing at the artists official webpage. There may be more than one "WOAR" frame in a tag if the audio contains more than one performer, but not with the same content.</description>
<string name="Frame ID" id="3904" type="fixed-length">
<fixedvalues>
<fixedvalue name="WOAR" value="WOAR"/>
</fixedvalues>
</string>
</structure>
<structure name="WOAS Frame - Official audio source webpage" id="2367" extends="id:3855">
<description>The 'Official audio source webpage' frame is a URL pointing at the official webpage for the source of the audio file, e.g. a movie.</description>
<string name="Frame ID" id="3916" type="fixed-length">
<fixedvalues>
<fixedvalue name="WOAS" value="WOAS"/>
</fixedvalues>
</string>
</structure>
<structure name="WORS Frame - Official internet radio station homepage" id="2369" extends="id:3855">
<description>The 'Official internet radio station homepage' contains a URL pointing at the homepage of the internet radio station.</description>
<string name="Frame ID" id="3928" type="fixed-length">
<fixedvalues>
<fixedvalue name="WORS" value="WORS"/>
</fixedvalues>
</string>
</structure>
<structure name="WPAY Frame - Payment" id="2371" extends="id:3855">
<description>The 'Payment' frame is a URL pointing at a webpage that will handle the process of paying for this file.</description>
<string name="Frame ID" id="3940" type="fixed-length">
<fixedvalues>
<fixedvalue name="WPAY" value="WPAY"/>
</fixedvalues>
</string>
</structure>
<structure name="WPUB Frame - Publishers official webpage" id="2373" extends="id:3855">
<description>The 'Publishers official webpage' frame is a URL pointing at the official wepage for the publisher.</description>
<string name="Frame ID" id="3952" type="fixed-length">
<fixedvalues>
<fixedvalue name="WPUB" value="WPUB"/>
</fixedvalues>
</string>
</structure>
<structure name="WXXX Frame - User defined URL link frame" id="2375" extends="id:2377" valueexpression="URL">
<description>This frame is intended for URL links concerning the audiofile in a similar way to the other "W"-frames. The frame body consists of a description of the string, represented as a terminated string, followed by the actual URL. The URL is always encoded with ISO-8859-1. There may be more than one "WXXX" frame in each tag, but only one with the same description.</description>
<string name="Frame ID" id="3964" type="fixed-length">
<fixedvalues>
<fixedvalue name="WXXX" value="WXXX"/>
</fixedvalues>
</string>
<number name="Size" id="3965" type="integer"/>
<structref name="Description" id="3974" structure="id:2511"/>
<string name="URL" id="3975" type="fixed-length" length="remaining"/>
</structure>
<structure name="Encoded String" id="2511" encoding="ISO_8859-1:1987" endian="big" signed="no" valueexpression="Switch">
<structure name="Switch" id="3977" order="variable" valueexpression="ISO String">
<structref name="ISO String" id="3979" repeatmin="0" structure="id:3978"/>
<structref name="Unicode String" id="3981" repeatmin="0" structure="id:3980"/>
</structure>
</structure>
<structure name="String" id="3984" encoding="ISO_8859-1:1987" endian="big" signed="no" valueexpression="Text">
<number name="Encoding" mustmatch="yes" id="3985" type="integer" length="1"/>
<string name="Text" id="3986" type="zero-terminated"/>
</structure>
<structure name="ISO String" id="3978" extends="id:3984">
<number name="Encoding" id="3988" type="integer">
<fixedvalues>
<fixedvalue name="ISO-8859-1" value="0"/>
</fixedvalues>
</number>
</structure>
<structure name="Unicode String" id="3980" extends="id:3984">
<number name="Encoding" id="3991" type="integer">
<fixedvalues>
<fixedvalue name="UNICODE" value="1"/>
</fixedvalues>
</number>
<string name="Text" id="3992" type="fixed-length" encoding="UTF-16"/>
</structure>
</grammar>
</ufwb>