id3v2.4.0-frames.txt 62 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734
  1. $Id: id3v2.4.0-frames.txt,v 1.1 2003/07/27 18:28:34 id3 Exp $
  2. Informal standard M. Nilsson
  3. Document: id3v2.4.0-frames.txt 1st November 2000
  4. ID3 tag version 2.4.0 - Native Frames
  5. Status of this document
  6. This document is an informal standard and replaces the ID3v2.3.0
  7. standard [ID3v2]. A formal standard will use another revision number
  8. even if the content is identical to document. The contents in this
  9. document may change for clarifications but never for added or altered
  10. functionallity.
  11. Distribution of this document is unlimited.
  12. Abstract
  13. This document describes the frames natively supported by ID3v2.4.0,
  14. which is a revised version of the ID3v2 informal standard [ID3v2.3.0]
  15. version 2.3.0. The ID3v2 offers a flexible way of storing audio meta
  16. information within audio file itself. The information may be
  17. technical information, such as equalisation curves, as well as title,
  18. performer, copyright etc.
  19. ID3v2.4.0 is meant to be as close as possible to ID3v2.3.0 in order
  20. to allow for implementations to be revised as easily as possible.
  21. 1. Table of contents
  22. 2. Conventions in this document
  23. 3. Default flags
  24. 4. Declared ID3v2 frames
  25. 4.1. Unique file identifier
  26. 4.2. Text information frames
  27. 4.2.1. Identification frames
  28. 4.2.2. Involved persons frames
  29. 4.2.3. Derived and subjective properties frames
  30. 4.2.4. Rights and license frames
  31. 4.2.5. Other text frames
  32. 4.2.6. User defined text information frame
  33. 4.3. URL link frames
  34. 4.3.1. URL link frames - details
  35. 4.3.2. User defined URL link frame
  36. 4.4. Music CD Identifier
  37. 4.5. Event timing codes
  38. 4.6. MPEG location lookup table
  39. 4.7. Synced tempo codes
  40. 4.8. Unsynchronised lyrics/text transcription
  41. 4.9. Synchronised lyrics/text
  42. 4.10. Comments
  43. 4.11. Relative volume adjustment (2)
  44. 4.12. Equalisation (2)
  45. 4.13. Reverb
  46. 4.14. Attached picture
  47. 4.15. General encapsulated object
  48. 4.16. Play counter
  49. 4.17. Popularimeter
  50. 4.18. Recommended buffer size
  51. 4.19. Audio encryption
  52. 4.20. Linked information
  53. 4.21. Position synchronisation frame
  54. 4.22. Terms of use
  55. 4.23. Ownership frame
  56. 4.24. Commercial frame
  57. 4.25. Encryption method registration
  58. 4.26. Group identification registration
  59. 4.27. Private frame
  60. 4.28. Signature frame
  61. 4.29. Seek frame
  62. 4.30. Audio seek point index
  63. 5. Copyright
  64. 6. References
  65. 7. Appendix
  66. A. Appendix A - Genre List from ID3v1
  67. 8. Author's Address
  68. 2. Conventions in this document
  69. Text within "" is a text string exactly as it appears in a tag.
  70. Numbers preceded with $ are hexadecimal and numbers preceded with %
  71. are binary. $xx is used to indicate a byte with unknown content. %x
  72. is used to indicate a bit with unknown content. The most significant
  73. bit (MSB) of a byte is called 'bit 7' and the least significant bit
  74. (LSB) is called 'bit 0'.
  75. A tag is the whole tag described the ID3v2 main structure document
  76. [ID3v2-strct]. A frame is a block of information in the tag. The tag
  77. consists of a header, frames and optional padding. A field is a piece
  78. of information; one value, a string etc. A numeric string is a string
  79. that consists of the characters "0123456789" only.
  80. The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
  81. "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
  82. document are to be interpreted as described in RFC 2119 [KEYWORDS].
  83. 3. Default flags
  84. The default settings for the frames described in this document can be
  85. divided into the following classes. The flags may be set differently
  86. if found more suitable by the software.
  87. 1. Discarded if tag is altered, discarded if file is altered.
  88. None.
  89. 2. Discarded if tag is altered, preserved if file is altered.
  90. None.
  91. 3. Preserved if tag is altered, discarded if file is altered.
  92. ASPI, AENC, ETCO, EQU2, MLLT, POSS, SEEK, SYLT, SYTC, RVA2, TENC,
  93. TLEN
  94. 4. Preserved if tag is altered, preserved if file is altered.
  95. The rest of the frames.
  96. 4. Declared ID3v2 frames
  97. The following frames are declared in this draft.
  98. 4.19 AENC Audio encryption
  99. 4.14 APIC Attached picture
  100. 4.30 ASPI Audio seek point index
  101. 4.10 COMM Comments
  102. 4.24 COMR Commercial frame
  103. 4.25 ENCR Encryption method registration
  104. 4.12 EQU2 Equalisation (2)
  105. 4.5 ETCO Event timing codes
  106. 4.15 GEOB General encapsulated object
  107. 4.26 GRID Group identification registration
  108. 4.20 LINK Linked information
  109. 4.4 MCDI Music CD identifier
  110. 4.6 MLLT MPEG location lookup table
  111. 4.23 OWNE Ownership frame
  112. 4.27 PRIV Private frame
  113. 4.16 PCNT Play counter
  114. 4.17 POPM Popularimeter
  115. 4.21 POSS Position synchronisation frame
  116. 4.18 RBUF Recommended buffer size
  117. 4.11 RVA2 Relative volume adjustment (2)
  118. 4.13 RVRB Reverb
  119. 4.29 SEEK Seek frame
  120. 4.28 SIGN Signature frame
  121. 4.9 SYLT Synchronised lyric/text
  122. 4.7 SYTC Synchronised tempo codes
  123. 4.2.1 TALB Album/Movie/Show title
  124. 4.2.3 TBPM BPM (beats per minute)
  125. 4.2.2 TCOM Composer
  126. 4.2.3 TCON Content type
  127. 4.2.4 TCOP Copyright message
  128. 4.2.5 TDEN Encoding time
  129. 4.2.5 TDLY Playlist delay
  130. 4.2.5 TDOR Original release time
  131. 4.2.5 TDRC Recording time
  132. 4.2.5 TDRL Release time
  133. 4.2.5 TDTG Tagging time
  134. 4.2.2 TENC Encoded by
  135. 4.2.2 TEXT Lyricist/Text writer
  136. 4.2.3 TFLT File type
  137. 4.2.2 TIPL Involved people list
  138. 4.2.1 TIT1 Content group description
  139. 4.2.1 TIT2 Title/songname/content description
  140. 4.2.1 TIT3 Subtitle/Description refinement
  141. 4.2.3 TKEY Initial key
  142. 4.2.3 TLAN Language(s)
  143. 4.2.3 TLEN Length
  144. 4.2.2 TMCL Musician credits list
  145. 4.2.3 TMED Media type
  146. 4.2.3 TMOO Mood
  147. 4.2.1 TOAL Original album/movie/show title
  148. 4.2.5 TOFN Original filename
  149. 4.2.2 TOLY Original lyricist(s)/text writer(s)
  150. 4.2.2 TOPE Original artist(s)/performer(s)
  151. 4.2.4 TOWN File owner/licensee
  152. 4.2.2 TPE1 Lead performer(s)/Soloist(s)
  153. 4.2.2 TPE2 Band/orchestra/accompaniment
  154. 4.2.2 TPE3 Conductor/performer refinement
  155. 4.2.2 TPE4 Interpreted, remixed, or otherwise modified by
  156. 4.2.1 TPOS Part of a set
  157. 4.2.4 TPRO Produced notice
  158. 4.2.4 TPUB Publisher
  159. 4.2.1 TRCK Track number/Position in set
  160. 4.2.4 TRSN Internet radio station name
  161. 4.2.4 TRSO Internet radio station owner
  162. 4.2.5 TSOA Album sort order
  163. 4.2.5 TSOP Performer sort order
  164. 4.2.5 TSOT Title sort order
  165. 4.2.1 TSRC ISRC (international standard recording code)
  166. 4.2.5 TSSE Software/Hardware and settings used for encoding
  167. 4.2.1 TSST Set subtitle
  168. 4.2.2 TXXX User defined text information frame
  169. 4.1 UFID Unique file identifier
  170. 4.22 USER Terms of use
  171. 4.8 USLT Unsynchronised lyric/text transcription
  172. 4.3.1 WCOM Commercial information
  173. 4.3.1 WCOP Copyright/Legal information
  174. 4.3.1 WOAF Official audio file webpage
  175. 4.3.1 WOAR Official artist/performer webpage
  176. 4.3.1 WOAS Official audio source webpage
  177. 4.3.1 WORS Official Internet radio station homepage
  178. 4.3.1 WPAY Payment
  179. 4.3.1 WPUB Publishers official webpage
  180. 4.3.2 WXXX User defined URL link frame
  181. 4.1. Unique file identifier
  182. This frame's purpose is to be able to identify the audio file in a
  183. database, that may provide more information relevant to the content.
  184. Since standardisation of such a database is beyond this document, all
  185. UFID frames begin with an 'owner identifier' field. It is a null-
  186. terminated string with a URL [URL] containing an email address, or a
  187. link to a location where an email address can be found, that belongs
  188. to the organisation responsible for this specific database
  189. implementation. Questions regarding the database should be sent to
  190. the indicated email address. The URL should not be used for the
  191. actual database queries. The string
  192. "http://www.id3.org/dummy/ufid.html" should be used for tests. The
  193. 'Owner identifier' must be non-empty (more than just a termination).
  194. The 'Owner identifier' is then followed by the actual identifier,
  195. which may be up to 64 bytes. There may be more than one "UFID" frame
  196. in a tag, but only one with the same 'Owner identifier'.
  197. <Header for 'Unique file identifier', ID: "UFID">
  198. Owner identifier <text string> $00
  199. Identifier <up to 64 bytes binary data>
  200. 4.2. Text information frames
  201. The text information frames are often the most important frames,
  202. containing information like artist, album and more. There may only be
  203. one text information frame of its kind in an tag. All text
  204. information frames supports multiple strings, stored as a null
  205. separated list, where null is reperesented by the termination code
  206. for the charater encoding. All text frame identifiers begin with "T".
  207. Only text frame identifiers begin with "T", with the exception of the
  208. "TXXX" frame. All the text information frames have the following
  209. format:
  210. <Header for 'Text information frame', ID: "T000" - "TZZZ",
  211. excluding "TXXX" described in 4.2.6.>
  212. Text encoding $xx
  213. Information <text string(s) according to encoding>
  214. 4.2.1. Identification frames
  215. TIT1
  216. The 'Content group description' frame is used if the sound belongs to
  217. a larger category of sounds/music. For example, classical music is
  218. often sorted in different musical sections (e.g. "Piano Concerto",
  219. "Weather - Hurricane").
  220. TIT2
  221. The 'Title/Songname/Content description' frame is the actual name of
  222. the piece (e.g. "Adagio", "Hurricane Donna").
  223. TIT3
  224. The 'Subtitle/Description refinement' frame is used for information
  225. directly related to the contents title (e.g. "Op. 16" or "Performed
  226. live at Wembley").
  227. TALB
  228. The 'Album/Movie/Show title' frame is intended for the title of the
  229. recording (or source of sound) from which the audio in the file is
  230. taken.
  231. TOAL
  232. The 'Original album/movie/show title' frame is intended for the title
  233. of the original recording (or source of sound), if for example the
  234. music in the file should be a cover of a previously released song.
  235. TRCK
  236. The 'Track number/Position in set' frame is a numeric string
  237. containing the order number of the audio-file on its original
  238. recording. This MAY be extended with a "/" character and a numeric
  239. string containing the total number of tracks/elements on the original
  240. recording. E.g. "4/9".
  241. TPOS
  242. The 'Part of a set' frame is a numeric string that describes which
  243. part of a set the audio came from. This frame is used if the source
  244. described in the "TALB" frame is divided into several mediums, e.g. a
  245. double CD. The value MAY be extended with a "/" character and a
  246. numeric string containing the total number of parts in the set. E.g.
  247. "1/2".
  248. TSST
  249. The 'Set subtitle' frame is intended for the subtitle of the part of
  250. a set this track belongs to.
  251. TSRC
  252. The 'ISRC' frame should contain the International Standard Recording
  253. Code [ISRC] (12 characters).
  254. 4.2.2. Involved persons frames
  255. TPE1
  256. The 'Lead artist/Lead performer/Soloist/Performing group' is
  257. used for the main artist.
  258. TPE2
  259. The 'Band/Orchestra/Accompaniment' frame is used for additional
  260. information about the performers in the recording.
  261. TPE3
  262. The 'Conductor' frame is used for the name of the conductor.
  263. TPE4
  264. The 'Interpreted, remixed, or otherwise modified by' frame contains
  265. more information about the people behind a remix and similar
  266. interpretations of another existing piece.
  267. TOPE
  268. The 'Original artist/performer' frame is intended for the performer
  269. of the original recording, if for example the music in the file
  270. should be a cover of a previously released song.
  271. TEXT
  272. The 'Lyricist/Text writer' frame is intended for the writer of the
  273. text or lyrics in the recording.
  274. TOLY
  275. The 'Original lyricist/text writer' frame is intended for the
  276. text writer of the original recording, if for example the music in
  277. the file should be a cover of a previously released song.
  278. TCOM
  279. The 'Composer' frame is intended for the name of the composer.
  280. TMCL
  281. The 'Musician credits list' is intended as a mapping between
  282. instruments and the musician that played it. Every odd field is an
  283. instrument and every even is an artist or a comma delimited list of
  284. artists.
  285. TIPL
  286. The 'Involved people list' is very similar to the musician credits
  287. list, but maps between functions, like producer, and names.
  288. TENC
  289. The 'Encoded by' frame contains the name of the person or
  290. organisation that encoded the audio file. This field may contain a
  291. copyright message, if the audio file also is copyrighted by the
  292. encoder.
  293. 4.2.3. Derived and subjective properties frames
  294. TBPM
  295. The 'BPM' frame contains the number of beats per minute in the
  296. main part of the audio. The BPM is an integer and represented as a
  297. numerical string.
  298. TLEN
  299. The 'Length' frame contains the length of the audio file in
  300. milliseconds, represented as a numeric string.
  301. TKEY
  302. The 'Initial key' frame contains the musical key in which the sound
  303. starts. It is represented as a string with a maximum length of three
  304. characters. The ground keys are represented with "A","B","C","D","E",
  305. "F" and "G" and halfkeys represented with "b" and "#". Minor is
  306. represented as "m", e.g. "Dbm" $00. Off key is represented with an
  307. "o" only.
  308. TLAN
  309. The 'Language' frame should contain the languages of the text or
  310. lyrics spoken or sung in the audio. The language is represented with
  311. three characters according to ISO-639-2 [ISO-639-2]. If more than one
  312. language is used in the text their language codes should follow
  313. according to the amount of their usage, e.g. "eng" $00 "sve" $00.
  314. TCON
  315. The 'Content type', which ID3v1 was stored as a one byte numeric
  316. value only, is now a string. You may use one or several of the ID3v1
  317. types as numerical strings, or, since the category list would be
  318. impossible to maintain with accurate and up to date categories,
  319. define your own. Example: "21" $00 "Eurodisco" $00
  320. You may also use any of the following keywords:
  321. RX Remix
  322. CR Cover
  323. TFLT
  324. The 'File type' frame indicates which type of audio this tag defines.
  325. The following types and refinements are defined:
  326. MIME MIME type follows
  327. MPG MPEG Audio
  328. /1 MPEG 1/2 layer I
  329. /2 MPEG 1/2 layer II
  330. /3 MPEG 1/2 layer III
  331. /2.5 MPEG 2.5
  332. /AAC Advanced audio compression
  333. VQF Transform-domain Weighted Interleave Vector Quantisation
  334. PCM Pulse Code Modulated audio
  335. but other types may be used, but not for these types though. This is
  336. used in a similar way to the predefined types in the "TMED" frame,
  337. but without parentheses. If this frame is not present audio type is
  338. assumed to be "MPG".
  339. TMED
  340. The 'Media type' frame describes from which media the sound
  341. originated. This may be a text string or a reference to the
  342. predefined media types found in the list below. Example:
  343. "VID/PAL/VHS" $00.
  344. DIG Other digital media
  345. /A Analogue transfer from media
  346. ANA Other analogue media
  347. /WAC Wax cylinder
  348. /8CA 8-track tape cassette
  349. CD CD
  350. /A Analogue transfer from media
  351. /DD DDD
  352. /AD ADD
  353. /AA AAD
  354. LD Laserdisc
  355. TT Turntable records
  356. /33 33.33 rpm
  357. /45 45 rpm
  358. /71 71.29 rpm
  359. /76 76.59 rpm
  360. /78 78.26 rpm
  361. /80 80 rpm
  362. MD MiniDisc
  363. /A Analogue transfer from media
  364. DAT DAT
  365. /A Analogue transfer from media
  366. /1 standard, 48 kHz/16 bits, linear
  367. /2 mode 2, 32 kHz/16 bits, linear
  368. /3 mode 3, 32 kHz/12 bits, non-linear, low speed
  369. /4 mode 4, 32 kHz/12 bits, 4 channels
  370. /5 mode 5, 44.1 kHz/16 bits, linear
  371. /6 mode 6, 44.1 kHz/16 bits, 'wide track' play
  372. DCC DCC
  373. /A Analogue transfer from media
  374. DVD DVD
  375. /A Analogue transfer from media
  376. TV Television
  377. /PAL PAL
  378. /NTSC NTSC
  379. /SECAM SECAM
  380. VID Video
  381. /PAL PAL
  382. /NTSC NTSC
  383. /SECAM SECAM
  384. /VHS VHS
  385. /SVHS S-VHS
  386. /BETA BETAMAX
  387. RAD Radio
  388. /FM FM
  389. /AM AM
  390. /LW LW
  391. /MW MW
  392. TEL Telephone
  393. /I ISDN
  394. MC MC (normal cassette)
  395. /4 4.75 cm/s (normal speed for a two sided cassette)
  396. /9 9.5 cm/s
  397. /I Type I cassette (ferric/normal)
  398. /II Type II cassette (chrome)
  399. /III Type III cassette (ferric chrome)
  400. /IV Type IV cassette (metal)
  401. REE Reel
  402. /9 9.5 cm/s
  403. /19 19 cm/s
  404. /38 38 cm/s
  405. /76 76 cm/s
  406. /I Type I cassette (ferric/normal)
  407. /II Type II cassette (chrome)
  408. /III Type III cassette (ferric chrome)
  409. /IV Type IV cassette (metal)
  410. TMOO
  411. The 'Mood' frame is intended to reflect the mood of the audio with a
  412. few keywords, e.g. "Romantic" or "Sad".
  413. 4.2.4. Rights and license frames
  414. TCOP
  415. The 'Copyright message' frame, in which the string must begin with a
  416. year and a space character (making five characters), is intended for
  417. the copyright holder of the original sound, not the audio file
  418. itself. The absence of this frame means only that the copyright
  419. information is unavailable or has been removed, and must not be
  420. interpreted to mean that the audio is public domain. Every time this
  421. field is displayed the field must be preceded with "Copyright " (C) "
  422. ", where (C) is one character showing a C in a circle.
  423. TPRO
  424. The 'Produced notice' frame, in which the string must begin with a
  425. year and a space character (making five characters), is intended for
  426. the production copyright holder of the original sound, not the audio
  427. file itself. The absence of this frame means only that the production
  428. copyright information is unavailable or has been removed, and must
  429. not be interpreted to mean that the audio is public domain. Every
  430. time this field is displayed the field must be preceded with
  431. "Produced " (P) " ", where (P) is one character showing a P in a
  432. circle.
  433. TPUB
  434. The 'Publisher' frame simply contains the name of the label or
  435. publisher.
  436. TOWN
  437. The 'File owner/licensee' frame contains the name of the owner or
  438. licensee of the file and it's contents.
  439. TRSN
  440. The 'Internet radio station name' frame contains the name of the
  441. internet radio station from which the audio is streamed.
  442. TRSO
  443. The 'Internet radio station owner' frame contains the name of the
  444. owner of the internet radio station from which the audio is
  445. streamed.
  446. 4.2.5. Other text frames
  447. TOFN
  448. The 'Original filename' frame contains the preferred filename for the
  449. file, since some media doesn't allow the desired length of the
  450. filename. The filename is case sensitive and includes its suffix.
  451. TDLY
  452. The 'Playlist delay' defines the numbers of milliseconds of silence
  453. that should be inserted before this audio. The value zero indicates
  454. that this is a part of a multifile audio track that should be played
  455. continuously.
  456. TDEN
  457. The 'Encoding time' frame contains a timestamp describing when the
  458. audio was encoded. Timestamp format is described in the ID3v2
  459. structure document [ID3v2-strct].
  460. TDOR
  461. The 'Original release time' frame contains a timestamp describing
  462. when the original recording of the audio was released. Timestamp
  463. format is described in the ID3v2 structure document [ID3v2-strct].
  464. TDRC
  465. The 'Recording time' frame contains a timestamp describing when the
  466. audio was recorded. Timestamp format is described in the ID3v2
  467. structure document [ID3v2-strct].
  468. TDRL
  469. The 'Release time' frame contains a timestamp describing when the
  470. audio was first released. Timestamp format is described in the ID3v2
  471. structure document [ID3v2-strct].
  472. TDTG
  473. The 'Tagging time' frame contains a timestamp describing then the
  474. audio was tagged. Timestamp format is described in the ID3v2
  475. structure document [ID3v2-strct].
  476. TSSE
  477. The 'Software/Hardware and settings used for encoding' frame
  478. includes the used audio encoder and its settings when the file was
  479. encoded. Hardware refers to hardware encoders, not the computer on
  480. which a program was run.
  481. TSOA
  482. The 'Album sort order' frame defines a string which should be used
  483. instead of the album name (TALB) for sorting purposes. E.g. an album
  484. named "A Soundtrack" might preferably be sorted as "Soundtrack".
  485. TSOP
  486. The 'Performer sort order' frame defines a string which should be
  487. used instead of the performer (TPE2) for sorting purposes.
  488. TSOT
  489. The 'Title sort order' frame defines a string which should be used
  490. instead of the title (TIT2) for sorting purposes.
  491. 4.2.6. User defined text information frame
  492. This frame is intended for one-string text information concerning the
  493. audio file in a similar way to the other "T"-frames. The frame body
  494. consists of a description of the string, represented as a terminated
  495. string, followed by the actual string. There may be more than one
  496. "TXXX" frame in each tag, but only one with the same description.
  497. <Header for 'User defined text information frame', ID: "TXXX">
  498. Text encoding $xx
  499. Description <text string according to encoding> $00 (00)
  500. Value <text string according to encoding>
  501. 4.3. URL link frames
  502. With these frames dynamic data such as webpages with touring
  503. information, price information or plain ordinary news can be added to
  504. the tag. There may only be one URL [URL] link frame of its kind in an
  505. tag, except when stated otherwise in the frame description. If the
  506. text string is followed by a string termination, all the following
  507. information should be ignored and not be displayed. All URL link
  508. frame identifiers begins with "W". Only URL link frame identifiers
  509. begins with "W", except for "WXXX". All URL link frames have the
  510. following format:
  511. <Header for 'URL link frame', ID: "W000" - "WZZZ", excluding "WXXX"
  512. described in 4.3.2.>
  513. URL <text string>
  514. 4.3.1. URL link frames - details
  515. WCOM
  516. The 'Commercial information' frame is a URL pointing at a webpage
  517. with information such as where the album can be bought. There may be
  518. more than one "WCOM" frame in a tag, but not with the same content.
  519. WCOP
  520. The 'Copyright/Legal information' frame is a URL pointing at a
  521. webpage where the terms of use and ownership of the file is
  522. described.
  523. WOAF
  524. The 'Official audio file webpage' frame is a URL pointing at a file
  525. specific webpage.
  526. WOAR
  527. The 'Official artist/performer webpage' frame is a URL pointing at
  528. the artists official webpage. There may be more than one "WOAR" frame
  529. in a tag if the audio contains more than one performer, but not with
  530. the same content.
  531. WOAS
  532. The 'Official audio source webpage' frame is a URL pointing at the
  533. official webpage for the source of the audio file, e.g. a movie.
  534. WORS
  535. The 'Official Internet radio station homepage' contains a URL
  536. pointing at the homepage of the internet radio station.
  537. WPAY
  538. The 'Payment' frame is a URL pointing at a webpage that will handle
  539. the process of paying for this file.
  540. WPUB
  541. The 'Publishers official webpage' frame is a URL pointing at the
  542. official webpage for the publisher.
  543. 4.3.2. User defined URL link frame
  544. This frame is intended for URL [URL] links concerning the audio file
  545. in a similar way to the other "W"-frames. The frame body consists
  546. of a description of the string, represented as a terminated string,
  547. followed by the actual URL. The URL is always encoded with ISO-8859-1
  548. [ISO-8859-1]. There may be more than one "WXXX" frame in each tag,
  549. but only one with the same description.
  550. <Header for 'User defined URL link frame', ID: "WXXX">
  551. Text encoding $xx
  552. Description <text string according to encoding> $00 (00)
  553. URL <text string>
  554. 4.4. Music CD identifier
  555. This frame is intended for music that comes from a CD, so that the CD
  556. can be identified in databases such as the CDDB [CDDB]. The frame
  557. consists of a binary dump of the Table Of Contents, TOC, from the CD,
  558. which is a header of 4 bytes and then 8 bytes/track on the CD plus 8
  559. bytes for the 'lead out', making a maximum of 804 bytes. The offset
  560. to the beginning of every track on the CD should be described with a
  561. four bytes absolute CD-frame address per track, and not with absolute
  562. time. When this frame is used the presence of a valid "TRCK" frame is
  563. REQUIRED, even if the CD's only got one track. It is recommended that
  564. this frame is always added to tags originating from CDs. There may
  565. only be one "MCDI" frame in each tag.
  566. <Header for 'Music CD identifier', ID: "MCDI">
  567. CD TOC <binary data>
  568. 4.5. Event timing codes
  569. This frame allows synchronisation with key events in the audio. The
  570. header is:
  571. <Header for 'Event timing codes', ID: "ETCO">
  572. Time stamp format $xx
  573. Where time stamp format is:
  574. $01 Absolute time, 32 bit sized, using MPEG [MPEG] frames as unit
  575. $02 Absolute time, 32 bit sized, using milliseconds as unit
  576. Absolute time means that every stamp contains the time from the
  577. beginning of the file.
  578. Followed by a list of key events in the following format:
  579. Type of event $xx
  580. Time stamp $xx (xx ...)
  581. The 'Time stamp' is set to zero if directly at the beginning of the
  582. sound or after the previous event. All events MUST be sorted in
  583. chronological order. The type of event is as follows:
  584. $00 padding (has no meaning)
  585. $01 end of initial silence
  586. $02 intro start
  587. $03 main part start
  588. $04 outro start
  589. $05 outro end
  590. $06 verse start
  591. $07 refrain start
  592. $08 interlude start
  593. $09 theme start
  594. $0A variation start
  595. $0B key change
  596. $0C time change
  597. $0D momentary unwanted noise (Snap, Crackle & Pop)
  598. $0E sustained noise
  599. $0F sustained noise end
  600. $10 intro end
  601. $11 main part end
  602. $12 verse end
  603. $13 refrain end
  604. $14 theme end
  605. $15 profanity
  606. $16 profanity end
  607. $17-$DF reserved for future use
  608. $E0-$EF not predefined synch 0-F
  609. $F0-$FC reserved for future use
  610. $FD audio end (start of silence)
  611. $FE audio file ends
  612. $FF one more byte of events follows (all the following bytes with
  613. the value $FF have the same function)
  614. Terminating the start events such as "intro start" is OPTIONAL. The
  615. 'Not predefined synch's ($E0-EF) are for user events. You might want
  616. to synchronise your music to something, like setting off an explosion
  617. on-stage, activating a screensaver etc.
  618. There may only be one "ETCO" frame in each tag.
  619. 4.6. MPEG location lookup table
  620. To increase performance and accuracy of jumps within a MPEG [MPEG]
  621. audio file, frames with time codes in different locations in the file
  622. might be useful. This ID3v2 frame includes references that the
  623. software can use to calculate positions in the file. After the frame
  624. header follows a descriptor of how much the 'frame counter' should be
  625. increased for every reference. If this value is two then the first
  626. reference points out the second frame, the 2nd reference the 4th
  627. frame, the 3rd reference the 6th frame etc. In a similar way the
  628. 'bytes between reference' and 'milliseconds between reference' points
  629. out bytes and milliseconds respectively.
  630. Each reference consists of two parts; a certain number of bits, as
  631. defined in 'bits for bytes deviation', that describes the difference
  632. between what is said in 'bytes between reference' and the reality and
  633. a certain number of bits, as defined in 'bits for milliseconds
  634. deviation', that describes the difference between what is said in
  635. 'milliseconds between reference' and the reality. The number of bits
  636. in every reference, i.e. 'bits for bytes deviation'+'bits for
  637. milliseconds deviation', must be a multiple of four. There may only
  638. be one "MLLT" frame in each tag.
  639. <Header for 'Location lookup table', ID: "MLLT">
  640. MPEG frames between reference $xx xx
  641. Bytes between reference $xx xx xx
  642. Milliseconds between reference $xx xx xx
  643. Bits for bytes deviation $xx
  644. Bits for milliseconds dev. $xx
  645. Then for every reference the following data is included;
  646. Deviation in bytes %xxx....
  647. Deviation in milliseconds %xxx....
  648. 4.7. Synchronised tempo codes
  649. For a more accurate description of the tempo of a musical piece, this
  650. frame might be used. After the header follows one byte describing
  651. which time stamp format should be used. Then follows one or more
  652. tempo codes. Each tempo code consists of one tempo part and one time
  653. part. The tempo is in BPM described with one or two bytes. If the
  654. first byte has the value $FF, one more byte follows, which is added
  655. to the first giving a range from 2 - 510 BPM, since $00 and $01 is
  656. reserved. $00 is used to describe a beat-free time period, which is
  657. not the same as a music-free time period. $01 is used to indicate one
  658. single beat-stroke followed by a beat-free period.
  659. The tempo descriptor is followed by a time stamp. Every time the
  660. tempo in the music changes, a tempo descriptor may indicate this for
  661. the player. All tempo descriptors MUST be sorted in chronological
  662. order. The first beat-stroke in a time-period is at the same time as
  663. the beat description occurs. There may only be one "SYTC" frame in
  664. each tag.
  665. <Header for 'Synchronised tempo codes', ID: "SYTC">
  666. Time stamp format $xx
  667. Tempo data <binary data>
  668. Where time stamp format is:
  669. $01 Absolute time, 32 bit sized, using MPEG [MPEG] frames as unit
  670. $02 Absolute time, 32 bit sized, using milliseconds as unit
  671. Absolute time means that every stamp contains the time from the
  672. beginning of the file.
  673. 4.8. Unsynchronised lyrics/text transcription
  674. This frame contains the lyrics of the song or a text transcription of
  675. other vocal activities. The head includes an encoding descriptor and
  676. a content descriptor. The body consists of the actual text. The
  677. 'Content descriptor' is a terminated string. If no descriptor is
  678. entered, 'Content descriptor' is $00 (00) only. Newline characters
  679. are allowed in the text. There may be more than one 'Unsynchronised
  680. lyrics/text transcription' frame in each tag, but only one with the
  681. same language and content descriptor.
  682. <Header for 'Unsynchronised lyrics/text transcription', ID: "USLT">
  683. Text encoding $xx
  684. Language $xx xx xx
  685. Content descriptor <text string according to encoding> $00 (00)
  686. Lyrics/text <full text string according to encoding>
  687. 4.9. Synchronised lyrics/text
  688. This is another way of incorporating the words, said or sung lyrics,
  689. in the audio file as text, this time, however, in sync with the
  690. audio. It might also be used to describing events e.g. occurring on a
  691. stage or on the screen in sync with the audio. The header includes a
  692. content descriptor, represented with as terminated text string. If no
  693. descriptor is entered, 'Content descriptor' is $00 (00) only.
  694. <Header for 'Synchronised lyrics/text', ID: "SYLT">
  695. Text encoding $xx
  696. Language $xx xx xx
  697. Time stamp format $xx
  698. Content type $xx
  699. Content descriptor <text string according to encoding> $00 (00)
  700. Content type: $00 is other
  701. $01 is lyrics
  702. $02 is text transcription
  703. $03 is movement/part name (e.g. "Adagio")
  704. $04 is events (e.g. "Don Quijote enters the stage")
  705. $05 is chord (e.g. "Bb F Fsus")
  706. $06 is trivia/'pop up' information
  707. $07 is URLs to webpages
  708. $08 is URLs to images
  709. Time stamp format:
  710. $01 Absolute time, 32 bit sized, using MPEG [MPEG] frames as unit
  711. $02 Absolute time, 32 bit sized, using milliseconds as unit
  712. Absolute time means that every stamp contains the time from the
  713. beginning of the file.
  714. The text that follows the frame header differs from that of the
  715. unsynchronised lyrics/text transcription in one major way. Each
  716. syllable (or whatever size of text is considered to be convenient by
  717. the encoder) is a null terminated string followed by a time stamp
  718. denoting where in the sound file it belongs. Each sync thus has the
  719. following structure:
  720. Terminated text to be synced (typically a syllable)
  721. Sync identifier (terminator to above string) $00 (00)
  722. Time stamp $xx (xx ...)
  723. The 'time stamp' is set to zero or the whole sync is omitted if
  724. located directly at the beginning of the sound. All time stamps
  725. should be sorted in chronological order. The sync can be considered
  726. as a validator of the subsequent string.
  727. Newline characters are allowed in all "SYLT" frames and MUST be used
  728. after every entry (name, event etc.) in a frame with the content type
  729. $03 - $04.
  730. A few considerations regarding whitespace characters: Whitespace
  731. separating words should mark the beginning of a new word, thus
  732. occurring in front of the first syllable of a new word. This is also
  733. valid for new line characters. A syllable followed by a comma should
  734. not be broken apart with a sync (both the syllable and the comma
  735. should be before the sync).
  736. An example: The "USLT" passage
  737. "Strangers in the night" $0A "Exchanging glances"
  738. would be "SYLT" encoded as:
  739. "Strang" $00 xx xx "ers" $00 xx xx " in" $00 xx xx " the" $00 xx xx
  740. " night" $00 xx xx 0A "Ex" $00 xx xx "chang" $00 xx xx "ing" $00 xx
  741. xx "glan" $00 xx xx "ces" $00 xx xx
  742. There may be more than one "SYLT" frame in each tag, but only one
  743. with the same language and content descriptor.
  744. 4.10. Comments
  745. This frame is intended for any kind of full text information that
  746. does not fit in any other frame. It consists of a frame header
  747. followed by encoding, language and content descriptors and is ended
  748. with the actual comment as a text string. Newline characters are
  749. allowed in the comment text string. There may be more than one
  750. comment frame in each tag, but only one with the same language and
  751. content descriptor.
  752. <Header for 'Comment', ID: "COMM">
  753. Text encoding $xx
  754. Language $xx xx xx
  755. Short content descrip. <text string according to encoding> $00 (00)
  756. The actual text <full text string according to encoding>
  757. 4.11. Relative volume adjustment (2)
  758. This is a more subjective frame than the previous ones. It allows the
  759. user to say how much he wants to increase/decrease the volume on each
  760. channel when the file is played. The purpose is to be able to align
  761. all files to a reference volume, so that you don't have to change the
  762. volume constantly. This frame may also be used to balance adjust the
  763. audio. The volume adjustment is encoded as a fixed point decibel
  764. value, 16 bit signed integer representing (adjustment*512), giving
  765. +/- 64 dB with a precision of 0.001953125 dB. E.g. +2 dB is stored as
  766. $04 00 and -2 dB is $FC 00. There may be more than one "RVA2" frame
  767. in each tag, but only one with the same identification string.
  768. <Header for 'Relative volume adjustment (2)', ID: "RVA2">
  769. Identification <text string> $00
  770. The 'identification' string is used to identify the situation and/or
  771. device where this adjustment should apply. The following is then
  772. repeated for every channel
  773. Type of channel $xx
  774. Volume adjustment $xx xx
  775. Bits representing peak $xx
  776. Peak volume $xx (xx ...)
  777. Type of channel: $00 Other
  778. $01 Master volume
  779. $02 Front right
  780. $03 Front left
  781. $04 Back right
  782. $05 Back left
  783. $06 Front centre
  784. $07 Back centre
  785. $08 Subwoofer
  786. Bits representing peak can be any number between 0 and 255. 0 means
  787. that there is no peak volume field. The peak volume field is always
  788. padded to whole bytes, setting the most significant bits to zero.
  789. 4.12. Equalisation (2)
  790. This is another subjective, alignment frame. It allows the user to
  791. predefine an equalisation curve within the audio file. There may be
  792. more than one "EQU2" frame in each tag, but only one with the same
  793. identification string.
  794. <Header of 'Equalisation (2)', ID: "EQU2">
  795. Interpolation method $xx
  796. Identification <text string> $00
  797. The 'interpolation method' describes which method is preferred when
  798. an interpolation between the adjustment point that follows. The
  799. following methods are currently defined:
  800. $00 Band
  801. No interpolation is made. A jump from one adjustment level to
  802. another occurs in the middle between two adjustment points.
  803. $01 Linear
  804. Interpolation between adjustment points is linear.
  805. The 'identification' string is used to identify the situation and/or
  806. device where this adjustment should apply. The following is then
  807. repeated for every adjustment point
  808. Frequency $xx xx
  809. Volume adjustment $xx xx
  810. The frequency is stored in units of 1/2 Hz, giving it a range from 0
  811. to 32767 Hz.
  812. The volume adjustment is encoded as a fixed point decibel value, 16
  813. bit signed integer representing (adjustment*512), giving +/- 64 dB
  814. with a precision of 0.001953125 dB. E.g. +2 dB is stored as $04 00
  815. and -2 dB is $FC 00.
  816. Adjustment points should be ordered by frequency and one frequency
  817. should only be described once in the frame.
  818. 4.13. Reverb
  819. Yet another subjective frame, with which you can adjust echoes of
  820. different kinds. Reverb left/right is the delay between every bounce
  821. in ms. Reverb bounces left/right is the number of bounces that should
  822. be made. $FF equals an infinite number of bounces. Feedback is the
  823. amount of volume that should be returned to the next echo bounce. $00
  824. is 0%, $FF is 100%. If this value were $7F, there would be 50% volume
  825. reduction on the first bounce, 50% of that on the second and so on.
  826. Left to left means the sound from the left bounce to be played in the
  827. left speaker, while left to right means sound from the left bounce to
  828. be played in the right speaker.
  829. 'Premix left to right' is the amount of left sound to be mixed in the
  830. right before any reverb is applied, where $00 id 0% and $FF is 100%.
  831. 'Premix right to left' does the same thing, but right to left.
  832. Setting both premix to $FF would result in a mono output (if the
  833. reverb is applied symmetric). There may only be one "RVRB" frame in
  834. each tag.
  835. <Header for 'Reverb', ID: "RVRB">
  836. Reverb left (ms) $xx xx
  837. Reverb right (ms) $xx xx
  838. Reverb bounces, left $xx
  839. Reverb bounces, right $xx
  840. Reverb feedback, left to left $xx
  841. Reverb feedback, left to right $xx
  842. Reverb feedback, right to right $xx
  843. Reverb feedback, right to left $xx
  844. Premix left to right $xx
  845. Premix right to left $xx
  846. 4.14. Attached picture
  847. This frame contains a picture directly related to the audio file.
  848. Image format is the MIME type and subtype [MIME] for the image. In
  849. the event that the MIME media type name is omitted, "image/" will be
  850. implied. The "image/png" [PNG] or "image/jpeg" [JFIF] picture format
  851. should be used when interoperability is wanted. Description is a
  852. short description of the picture, represented as a terminated
  853. text string. There may be several pictures attached to one file, each
  854. in their individual "APIC" frame, but only one with the same content
  855. descriptor. There may only be one picture with the picture type
  856. declared as picture type $01 and $02 respectively. There is the
  857. possibility to put only a link to the image file by using the 'MIME
  858. type' "-->" and having a complete URL [URL] instead of picture data.
  859. The use of linked files should however be used sparingly since there
  860. is the risk of separation of files.
  861. <Header for 'Attached picture', ID: "APIC">
  862. Text encoding $xx
  863. MIME type <text string> $00
  864. Picture type $xx
  865. Description <text string according to encoding> $00 (00)
  866. Picture data <binary data>
  867. Picture type: $00 Other
  868. $01 32x32 pixels 'file icon' (PNG only)
  869. $02 Other file icon
  870. $03 Cover (front)
  871. $04 Cover (back)
  872. $05 Leaflet page
  873. $06 Media (e.g. label side of CD)
  874. $07 Lead artist/lead performer/soloist
  875. $08 Artist/performer
  876. $09 Conductor
  877. $0A Band/Orchestra
  878. $0B Composer
  879. $0C Lyricist/text writer
  880. $0D Recording Location
  881. $0E During recording
  882. $0F During performance
  883. $10 Movie/video screen capture
  884. $11 A bright coloured fish
  885. $12 Illustration
  886. $13 Band/artist logotype
  887. $14 Publisher/Studio logotype
  888. 4.15. General encapsulated object
  889. In this frame any type of file can be encapsulated. After the header,
  890. 'Frame size' and 'Encoding' follows 'MIME type' [MIME] represented as
  891. as a terminated string encoded with ISO 8859-1 [ISO-8859-1]. The
  892. filename is case sensitive and is encoded as 'Encoding'. Then follows
  893. a content description as terminated string, encoded as 'Encoding'.
  894. The last thing in the frame is the actual object. The first two
  895. strings may be omitted, leaving only their terminations. MIME type is
  896. always an ISO-8859-1 text string. There may be more than one "GEOB"
  897. frame in each tag, but only one with the same content descriptor.
  898. <Header for 'General encapsulated object', ID: "GEOB">
  899. Text encoding $xx
  900. MIME type <text string> $00
  901. Filename <text string according to encoding> $00 (00)
  902. Content description <text string according to encoding> $00 (00)
  903. Encapsulated object <binary data>
  904. 4.16. Play counter
  905. This is simply a counter of the number of times a file has been
  906. played. The value is increased by one every time the file begins to
  907. play. There may only be one "PCNT" frame in each tag. When the
  908. counter reaches all one's, one byte is inserted in front of the
  909. counter thus making the counter eight bits bigger. The counter must
  910. be at least 32-bits long to begin with.
  911. <Header for 'Play counter', ID: "PCNT">
  912. Counter $xx xx xx xx (xx ...)
  913. 4.17. Popularimeter
  914. The purpose of this frame is to specify how good an audio file is.
  915. Many interesting applications could be found to this frame such as a
  916. playlist that features better audio files more often than others or
  917. it could be used to profile a person's taste and find other 'good'
  918. files by comparing people's profiles. The frame contains the email
  919. address to the user, one rating byte and a four byte play counter,
  920. intended to be increased with one for every time the file is played.
  921. The email is a terminated string. The rating is 1-255 where 1 is
  922. worst and 255 is best. 0 is unknown. If no personal counter is wanted
  923. it may be omitted. When the counter reaches all one's, one byte is
  924. inserted in front of the counter thus making the counter eight bits
  925. bigger in the same away as the play counter ("PCNT"). There may be
  926. more than one "POPM" frame in each tag, but only one with the same
  927. email address.
  928. <Header for 'Popularimeter', ID: "POPM">
  929. Email to user <text string> $00
  930. Rating $xx
  931. Counter $xx xx xx xx (xx ...)
  932. 4.18. Recommended buffer size
  933. Sometimes the server from which an audio file is streamed is aware of
  934. transmission or coding problems resulting in interruptions in the
  935. audio stream. In these cases, the size of the buffer can be
  936. recommended by the server using this frame. If the 'embedded info
  937. flag' is true (1) then this indicates that an ID3 tag with the
  938. maximum size described in 'Buffer size' may occur in the audio
  939. stream. In such case the tag should reside between two MPEG [MPEG]
  940. frames, if the audio is MPEG encoded. If the position of the next tag
  941. is known, 'offset to next tag' may be used. The offset is calculated
  942. from the end of tag in which this frame resides to the first byte of
  943. the header in the next. This field may be omitted. Embedded tags are
  944. generally not recommended since this could render unpredictable
  945. behaviour from present software/hardware.
  946. For applications like streaming audio it might be an idea to embed
  947. tags into the audio stream though. If the clients connects to
  948. individual connections like HTTP and there is a possibility to begin
  949. every transmission with a tag, then this tag should include a
  950. 'recommended buffer size' frame. If the client is connected to a
  951. arbitrary point in the stream, such as radio or multicast, then the
  952. 'recommended buffer size' frame SHOULD be included in every tag.
  953. The 'Buffer size' should be kept to a minimum. There may only be one
  954. "RBUF" frame in each tag.
  955. <Header for 'Recommended buffer size', ID: "RBUF">
  956. Buffer size $xx xx xx
  957. Embedded info flag %0000000x
  958. Offset to next tag $xx xx xx xx
  959. 4.19. Audio encryption
  960. This frame indicates if the actual audio stream is encrypted, and by
  961. whom. Since standardisation of such encryption scheme is beyond this
  962. document, all "AENC" frames begin with a terminated string with a
  963. URL containing an email address, or a link to a location where an
  964. email address can be found, that belongs to the organisation
  965. responsible for this specific encrypted audio file. Questions
  966. regarding the encrypted audio should be sent to the email address
  967. specified. If a $00 is found directly after the 'Frame size' and the
  968. audio file indeed is encrypted, the whole file may be considered
  969. useless.
  970. After the 'Owner identifier', a pointer to an unencrypted part of the
  971. audio can be specified. The 'Preview start' and 'Preview length' is
  972. described in frames. If no part is unencrypted, these fields should
  973. be left zeroed. After the 'preview length' field follows optionally a
  974. data block required for decryption of the audio. There may be more
  975. than one "AENC" frames in a tag, but only one with the same 'Owner
  976. identifier'.
  977. <Header for 'Audio encryption', ID: "AENC">
  978. Owner identifier <text string> $00
  979. Preview start $xx xx
  980. Preview length $xx xx
  981. Encryption info <binary data>
  982. 4.20. Linked information
  983. To keep information duplication as low as possible this frame may be
  984. used to link information from another ID3v2 tag that might reside in
  985. another audio file or alone in a binary file. It is RECOMMENDED that
  986. this method is only used when the files are stored on a CD-ROM or
  987. other circumstances when the risk of file separation is low. The
  988. frame contains a frame identifier, which is the frame that should be
  989. linked into this tag, a URL [URL] field, where a reference to the
  990. file where the frame is given, and additional ID data, if needed.
  991. Data should be retrieved from the first tag found in the file to
  992. which this link points. There may be more than one "LINK" frame in a
  993. tag, but only one with the same contents. A linked frame is to be
  994. considered as part of the tag and has the same restrictions as if it
  995. was a physical part of the tag (i.e. only one "RVRB" frame allowed,
  996. whether it's linked or not).
  997. <Header for 'Linked information', ID: "LINK">
  998. Frame identifier $xx xx xx xx
  999. URL <text string> $00
  1000. ID and additional data <text string(s)>
  1001. Frames that may be linked and need no additional data are "ASPI",
  1002. "ETCO", "EQU2", "MCID", "MLLT", "OWNE", "RVA2", "RVRB", "SYTC", the
  1003. text information frames and the URL link frames.
  1004. The "AENC", "APIC", "GEOB" and "TXXX" frames may be linked with
  1005. the content descriptor as additional ID data.
  1006. The "USER" frame may be linked with the language field as additional
  1007. ID data.
  1008. The "PRIV" frame may be linked with the owner identifier as
  1009. additional ID data.
  1010. The "COMM", "SYLT" and "USLT" frames may be linked with three bytes
  1011. of language descriptor directly followed by a content descriptor as
  1012. additional ID data.
  1013. 4.21. Position synchronisation frame
  1014. This frame delivers information to the listener of how far into the
  1015. audio stream he picked up; in effect, it states the time offset from
  1016. the first frame in the stream. The frame layout is:
  1017. <Head for 'Position synchronisation', ID: "POSS">
  1018. Time stamp format $xx
  1019. Position $xx (xx ...)
  1020. Where time stamp format is:
  1021. $01 Absolute time, 32 bit sized, using MPEG frames as unit
  1022. $02 Absolute time, 32 bit sized, using milliseconds as unit
  1023. and position is where in the audio the listener starts to receive,
  1024. i.e. the beginning of the next frame. If this frame is used in the
  1025. beginning of a file the value is always 0. There may only be one
  1026. "POSS" frame in each tag.
  1027. 4.22. Terms of use frame
  1028. This frame contains a brief description of the terms of use and
  1029. ownership of the file. More detailed information concerning the legal
  1030. terms might be available through the "WCOP" frame. Newlines are
  1031. allowed in the text. There may be more than one 'Terms of use' frame
  1032. in a tag, but only one with the same 'Language'.
  1033. <Header for 'Terms of use frame', ID: "USER">
  1034. Text encoding $xx
  1035. Language $xx xx xx
  1036. The actual text <text string according to encoding>
  1037. 4.23. Ownership frame
  1038. The ownership frame might be used as a reminder of a made transaction
  1039. or, if signed, as proof. Note that the "USER" and "TOWN" frames are
  1040. good to use in conjunction with this one. The frame begins, after the
  1041. frame ID, size and encoding fields, with a 'price paid' field. The
  1042. first three characters of this field contains the currency used for
  1043. the transaction, encoded according to ISO 4217 [ISO-4217] alphabetic
  1044. currency code. Concatenated to this is the actual price paid, as a
  1045. numerical string using "." as the decimal separator. Next is an 8
  1046. character date string (YYYYMMDD) followed by a string with the name
  1047. of the seller as the last field in the frame. There may only be one
  1048. "OWNE" frame in a tag.
  1049. <Header for 'Ownership frame', ID: "OWNE">
  1050. Text encoding $xx
  1051. Price paid <text string> $00
  1052. Date of purch. <text string>
  1053. Seller <text string according to encoding>
  1054. 4.24. Commercial frame
  1055. This frame enables several competing offers in the same tag by
  1056. bundling all needed information. That makes this frame rather complex
  1057. but it's an easier solution than if one tries to achieve the same
  1058. result with several frames. The frame begins, after the frame ID,
  1059. size and encoding fields, with a price string field. A price is
  1060. constructed by one three character currency code, encoded according
  1061. to ISO 4217 [ISO-4217] alphabetic currency code, followed by a
  1062. numerical value where "." is used as decimal separator. In the price
  1063. string several prices may be concatenated, separated by a "/"
  1064. character, but there may only be one currency of each type.
  1065. The price string is followed by an 8 character date string in the
  1066. format YYYYMMDD, describing for how long the price is valid. After
  1067. that is a contact URL, with which the user can contact the seller,
  1068. followed by a one byte 'received as' field. It describes how the
  1069. audio is delivered when bought according to the following list:
  1070. $00 Other
  1071. $01 Standard CD album with other songs
  1072. $02 Compressed audio on CD
  1073. $03 File over the Internet
  1074. $04 Stream over the Internet
  1075. $05 As note sheets
  1076. $06 As note sheets in a book with other sheets
  1077. $07 Music on other media
  1078. $08 Non-musical merchandise
  1079. Next follows a terminated string with the name of the seller followed
  1080. by a terminated string with a short description of the product. The
  1081. last thing is the ability to include a company logotype. The first of
  1082. them is the 'Picture MIME type' field containing information about
  1083. which picture format is used. In the event that the MIME media type
  1084. name is omitted, "image/" will be implied. Currently only "image/png"
  1085. and "image/jpeg" are allowed. This format string is followed by the
  1086. binary picture data. This two last fields may be omitted if no
  1087. picture is attached. There may be more than one 'commercial frame' in
  1088. a tag, but no two may be identical.
  1089. <Header for 'Commercial frame', ID: "COMR">
  1090. Text encoding $xx
  1091. Price string <text string> $00
  1092. Valid until <text string>
  1093. Contact URL <text string> $00
  1094. Received as $xx
  1095. Name of seller <text string according to encoding> $00 (00)
  1096. Description <text string according to encoding> $00 (00)
  1097. Picture MIME type <string> $00
  1098. Seller logo <binary data>
  1099. 4.25. Encryption method registration
  1100. To identify with which method a frame has been encrypted the
  1101. encryption method must be registered in the tag with this frame. The
  1102. 'Owner identifier' is a null-terminated string with a URL [URL]
  1103. containing an email address, or a link to a location where an email
  1104. address can be found, that belongs to the organisation responsible
  1105. for this specific encryption method. Questions regarding the
  1106. encryption method should be sent to the indicated email address. The
  1107. 'Method symbol' contains a value that is associated with this method
  1108. throughout the whole tag, in the range $80-F0. All other values are
  1109. reserved. The 'Method symbol' may optionally be followed by
  1110. encryption specific data. There may be several "ENCR" frames in a tag
  1111. but only one containing the same symbol and only one containing the
  1112. same owner identifier. The method must be used somewhere in the tag.
  1113. See the description of the frame encryption flag in the ID3v2
  1114. structure document [ID3v2-strct] for more information.
  1115. <Header for 'Encryption method registration', ID: "ENCR">
  1116. Owner identifier <text string> $00
  1117. Method symbol $xx
  1118. Encryption data <binary data>
  1119. 4.26. Group identification registration
  1120. This frame enables grouping of otherwise unrelated frames. This can
  1121. be used when some frames are to be signed. To identify which frames
  1122. belongs to a set of frames a group identifier must be registered in
  1123. the tag with this frame. The 'Owner identifier' is a null-terminated
  1124. string with a URL [URL] containing an email address, or a link to a
  1125. location where an email address can be found, that belongs to the
  1126. organisation responsible for this grouping. Questions regarding the
  1127. grouping should be sent to the indicated email address. The 'Group
  1128. symbol' contains a value that associates the frame with this group
  1129. throughout the whole tag, in the range $80-F0. All other values are
  1130. reserved. The 'Group symbol' may optionally be followed by some group
  1131. specific data, e.g. a digital signature. There may be several "GRID"
  1132. frames in a tag but only one containing the same symbol and only one
  1133. containing the same owner identifier. The group symbol must be used
  1134. somewhere in the tag. See the description of the frame grouping flag
  1135. in the ID3v2 structure document [ID3v2-strct] for more information.
  1136. <Header for 'Group ID registration', ID: "GRID">
  1137. Owner identifier <text string> $00
  1138. Group symbol $xx
  1139. Group dependent data <binary data>
  1140. 4.27. Private frame
  1141. This frame is used to contain information from a software producer
  1142. that its program uses and does not fit into the other frames. The
  1143. frame consists of an 'Owner identifier' string and the binary data.
  1144. The 'Owner identifier' is a null-terminated string with a URL [URL]
  1145. containing an email address, or a link to a location where an email
  1146. address can be found, that belongs to the organisation responsible
  1147. for the frame. Questions regarding the frame should be sent to the
  1148. indicated email address. The tag may contain more than one "PRIV"
  1149. frame but only with different contents.
  1150. <Header for 'Private frame', ID: "PRIV">
  1151. Owner identifier <text string> $00
  1152. The private data <binary data>
  1153. 4.28. Signature frame
  1154. This frame enables a group of frames, grouped with the 'Group
  1155. identification registration', to be signed. Although signatures can
  1156. reside inside the registration frame, it might be desired to store
  1157. the signature elsewhere, e.g. in watermarks. There may be more than
  1158. one 'signature frame' in a tag, but no two may be identical.
  1159. <Header for 'Signature frame', ID: "SIGN">
  1160. Group symbol $xx
  1161. Signature <binary data>
  1162. 4.29. Seek frame
  1163. This frame indicates where other tags in a file/stream can be found.
  1164. The 'minimum offset to next tag' is calculated from the end of this
  1165. tag to the beginning of the next. There may only be one 'seek frame'
  1166. in a tag.
  1167. <Header for 'Seek frame', ID: "SEEK">
  1168. Minimum offset to next tag $xx xx xx xx
  1169. 4.30. Audio seek point index
  1170. Audio files with variable bit rates are intrinsically difficult to
  1171. deal with in the case of seeking within the file. The ASPI frame
  1172. makes seeking easier by providing a list a seek points within the
  1173. audio file. The seek points are a fractional offset within the audio
  1174. data, providing a starting point from which to find an appropriate
  1175. point to start decoding. The presence of an ASPI frame requires the
  1176. existence of a TLEN frame, indicating the duration of the file in
  1177. milliseconds. There may only be one 'audio seek point index' frame in
  1178. a tag.
  1179. <Header for 'Seek Point Index', ID: "ASPI">
  1180. Indexed data start (S) $xx xx xx xx
  1181. Indexed data length (L) $xx xx xx xx
  1182. Number of index points (N) $xx xx
  1183. Bits per index point (b) $xx
  1184. Then for every index point the following data is included;
  1185. Fraction at index (Fi) $xx (xx)
  1186. 'Indexed data start' is a byte offset from the beginning of the file.
  1187. 'Indexed data length' is the byte length of the audio data being
  1188. indexed. 'Number of index points' is the number of index points, as
  1189. the name implies. The recommended number is 100. 'Bits per index
  1190. point' is 8 or 16, depending on the chosen precision. 8 bits works
  1191. well for short files (less than 5 minutes of audio), while 16 bits is
  1192. advantageous for long files. 'Fraction at index' is the numerator of
  1193. the fraction representing a relative position in the data. The
  1194. denominator is 2 to the power of b.
  1195. Here are the algorithms to be used in the calculation. The known data
  1196. must be the offset of the start of the indexed data (S), the offset
  1197. of the end of the indexed data (E), the number of index points (N),
  1198. the offset at index i (Oi). We calculate the fraction at index i
  1199. (Fi).
  1200. Oi is the offset of the frame whose start is soonest after the point
  1201. for which the time offset is (i/N * duration).
  1202. The frame data should be calculated as follows:
  1203. Fi = Oi/L * 2^b (rounded down to the nearest integer)
  1204. Offset calculation should be calculated as follows from data in the
  1205. frame:
  1206. Oi = (Fi/2^b)*L (rounded up to the nearest integer)
  1207. 5. Copyright
  1208. Copyright (C) Martin Nilsson 2000. All Rights Reserved.
  1209. This document and translations of it may be copied and furnished to
  1210. others, and derivative works that comment on or otherwise explain it
  1211. or assist in its implementation may be prepared, copied, published
  1212. and distributed, in whole or in part, without restriction of any
  1213. kind, provided that a reference to this document is included on all
  1214. such copies and derivative works. However, this document itself may
  1215. not be modified in any way and reissued as the original document.
  1216. The limited permissions granted above are perpetual and will not be
  1217. revoked.
  1218. This document and the information contained herein is provided on an
  1219. "AS IS" basis and THE AUTHORS DISCLAIMS ALL WARRANTIES, EXPRESS OR
  1220. IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF
  1221. THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
  1222. WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
  1223. 6. References
  1224. [CDDB] Compact Disc Data Base
  1225. <url:http://www.cddb.com>
  1226. [ID3v2.3.0] Martin Nilsson, "ID3v2 informal standard".
  1227. <url:http://www.id3.org/id3v2.3.0.txt>
  1228. [ID3v2-strct] Martin Nilsson,
  1229. "ID3 tag version 2.4.0 - Main Structure"
  1230. <url:http//www.id3.org/id3v2.4.0-structure.txt>
  1231. [ISO-639-2] ISO/FDIS 639-2.
  1232. Codes for the representation of names of languages, Part 2: Alpha-3
  1233. code. Technical committee / subcommittee: TC 37 / SC 2
  1234. [ISO-4217] ISO 4217:1995.
  1235. Codes for the representation of currencies and funds.
  1236. Technical committee / subcommittee: TC 68
  1237. [ISO-8859-1] ISO/IEC DIS 8859-1.
  1238. 8-bit single-byte coded graphic character sets, Part 1: Latin
  1239. alphabet No. 1. Technical committee / subcommittee: JTC 1 / SC 2
  1240. [ISRC] ISO 3901:1986
  1241. International Standard Recording Code (ISRC).
  1242. Technical committee / subcommittee: TC 46 / SC 9
  1243. [JFIF] JPEG File Interchange Format, version 1.02
  1244. <url:http://www.w3.org/Graphics/JPEG/jfif.txt>
  1245. [KEYWORDS] S. Bradner, 'Key words for use in RFCs to Indicate
  1246. Requirement Levels', RFC 2119, March 1997.
  1247. <url:ftp://ftp.isi.edu/in-notes/rfc2119.txt>
  1248. [MIME] Freed, N. and N. Borenstein, "Multipurpose Internet Mail
  1249. Extensions (MIME) Part One: Format of Internet Message Bodies",
  1250. RFC 2045, November 1996.
  1251. <url:ftp://ftp.isi.edu/in-notes/rfc2045.txt>
  1252. [MPEG] ISO/IEC 11172-3:1993.
  1253. Coding of moving pictures and associated audio for digital storage
  1254. media at up to about 1,5 Mbit/s, Part 3: Audio.
  1255. Technical committee / subcommittee: JTC 1 / SC 29
  1256. and
  1257. ISO/IEC 13818-3:1995
  1258. Generic coding of moving pictures and associated audio information,
  1259. Part 3: Audio.
  1260. Technical committee / subcommittee: JTC 1 / SC 29
  1261. and
  1262. ISO/IEC DIS 13818-3
  1263. Generic coding of moving pictures and associated audio information,
  1264. Part 3: Audio (Revision of ISO/IEC 13818-3:1995)
  1265. [PNG] Portable Network Graphics, version 1.0
  1266. <url:http://www.w3.org/TR/REC-png-multi.html>
  1267. [URL] T. Berners-Lee, L. Masinter & M. McCahill, "Uniform Resource
  1268. Locators (URL).", RFC 1738, December 1994.
  1269. <url:ftp://ftp.isi.edu/in-notes/rfc1738.txt>
  1270. [ZLIB] P. Deutsch, Aladdin Enterprises & J-L. Gailly, "ZLIB
  1271. Compressed
  1272. Data Format Specification version 3.3", RFC 1950, May 1996.
  1273. <url:ftp://ftp.isi.edu/in-notes/rfc1950.txt>
  1274. 7. Appendix
  1275. A. Appendix A - Genre List from ID3v1
  1276. The following genres is defined in ID3v1
  1277. 0.Blues
  1278. 1.Classic Rock
  1279. 2.Country
  1280. 3.Dance
  1281. 4.Disco
  1282. 5.Funk
  1283. 6.Grunge
  1284. 7.Hip-Hop
  1285. 8.Jazz
  1286. 9.Metal
  1287. 10.New Age
  1288. 11.Oldies
  1289. 12.Other
  1290. 13.Pop
  1291. 14.R&B
  1292. 15.Rap
  1293. 16.Reggae
  1294. 17.Rock
  1295. 18.Techno
  1296. 19.Industrial
  1297. 20.Alternative
  1298. 21.Ska
  1299. 22.Death Metal
  1300. 23.Pranks
  1301. 24.Soundtrack
  1302. 25.Euro-Techno
  1303. 26.Ambient
  1304. 27.Trip-Hop
  1305. 28.Vocal
  1306. 29.Jazz+Funk
  1307. 30.Fusion
  1308. 31.Trance
  1309. 32.Classical
  1310. 33.Instrumental
  1311. 34.Acid
  1312. 35.House
  1313. 36.Game
  1314. 37.Sound Clip
  1315. 38.Gospel
  1316. 39.Noise
  1317. 40.AlternRock
  1318. 41.Bass
  1319. 42.Soul
  1320. 43.Punk
  1321. 44.Space
  1322. 45.Meditative
  1323. 46.Instrumental Pop
  1324. 47.Instrumental Rock
  1325. 48.Ethnic
  1326. 49.Gothic
  1327. 50.Darkwave
  1328. 51.Techno-Industrial
  1329. 52.Electronic
  1330. 53.Pop-Folk
  1331. 54.Eurodance
  1332. 55.Dream
  1333. 56.Southern Rock
  1334. 57.Comedy
  1335. 58.Cult
  1336. 59.Gangsta
  1337. 60.Top 40
  1338. 61.Christian Rap
  1339. 62.Pop/Funk
  1340. 63.Jungle
  1341. 64.Native American
  1342. 65.Cabaret
  1343. 66.New Wave
  1344. 67.Psychedelic
  1345. 68.Rave
  1346. 69.Showtunes
  1347. 70.Trailer
  1348. 71.Lo-Fi
  1349. 72.Tribal
  1350. 73.Acid Punk
  1351. 74.Acid Jazz
  1352. 75.Polka
  1353. 76.Retro
  1354. 77.Musical
  1355. 78.Rock & Roll
  1356. 79.Hard Rock
  1357. 8. Author's Address
  1358. Written by
  1359. Martin Nilsson
  1360. Rydsv�gen 246 C. 30
  1361. SE-584 34 Link�ping
  1362. Sweden
  1363. Email: nilsson at id3.org