mp3file 0.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
data/doc/id3v2.2.0.txt ADDED
@@ -0,0 +1,1658 @@
1
+ Informal standard M. Nilsson
2
+ Document: id3v2-00.txt 26th March 1998
3
+
4
+
5
+ ID3 tag version 2
6
+
7
+ Status of this document
8
+
9
+ This document is an Informal standard and is released so that
10
+ implementors could have a set standard before the formal standard is
11
+ set. The formal standard will use another version number if not
12
+ identical to what is described in this document. The contents in this
13
+ document may change for clarifications but never for added or altered
14
+ functionallity.
15
+
16
+ Distribution of this document is unlimited.
17
+
18
+
19
+ Abstract
20
+
21
+ The recent gain of popularity for MPEG layer III audio files on the
22
+ internet forced a standardised way of storing information about an
23
+ audio file within itself to determinate its origin and contents.
24
+
25
+ Today the most accepted way to do this is with the so called ID3 tag,
26
+ which is simple but very limited and in some cases very unsuitable.
27
+ The ID3 tag has very limited space in every field, very limited
28
+ numbers of fields, not expandable or upgradeable and is placed at the
29
+ end of a the file, which is unsuitable for streaming audio. This draft
30
+ is an attempt to answer these issues with a new version of the ID3
31
+ tag.
32
+
33
+
34
+ 1. Table of contents
35
+
36
+ 2. Conventions in this document
37
+ 3. ID3v2 overview
38
+ 3.1. ID3v2 header
39
+ 3.2. ID3v2 frames overview
40
+ 4. Declared ID3v2 frames
41
+ 4.1. Unique file identifier
42
+ 4.2. Text information frames
43
+ 4.2.1. Text information frames - details
44
+ 4.2.2. User defined text information frame
45
+ 4.3. URL link frames
46
+ 4.3.1. URL link frames - details
47
+ 4.3.2. User defined URL link frame
48
+ 4.4. Involved people list
49
+ 4.5. Music CD Identifier
50
+ 4.6. Event timing codes
51
+ 4.7. MPEG location lookup table
52
+ 4.8. Synced tempo codes
53
+ 4.9. Unsychronised lyrics/text transcription
54
+ 4.10. Synchronised lyrics/text
55
+ 4.11. Comments
56
+ 4.12. Relative volume adjustment
57
+ 4.13. Equalisation
58
+ 4.14. Reverb
59
+ 4.15. Attached picture
60
+ 4.16. General encapsulated object
61
+ 4.17. Play counter
62
+ 4.18. Popularimeter
63
+ 4.19. Recommended buffer size
64
+ 4.20. Encrypted meta frame
65
+ 4.21. Audio encryption
66
+ 4.22. Linked information
67
+ 5. The 'unsynchronisation scheme'
68
+ 6. Copyright
69
+ 7. References
70
+ 8. Appendix
71
+ A. Appendix A - ID3-Tag Specification V1.1
72
+ A.1. Overview
73
+ A.2. ID3v1 Implementation
74
+ A.3. Genre List
75
+ A.4. Track addition - ID3v1.1
76
+ 9. Author's Address
77
+
78
+
79
+ 2. Conventions in this document
80
+
81
+ In the examples, text within "" is a text string exactly as it appears
82
+ in a file. Numbers preceded with $ are hexadecimal and numbers
83
+ preceded with % are binary. $xx is used to indicate a byte with
84
+ unknown content. %x is used to indicate a bit with unknown content.
85
+ The most significant bit (MSB) of a byte is called 'bit 7' and the
86
+ least significant bit (LSB) is called 'bit 0'.
87
+
88
+ A tag is the whole tag described in this document. A frame is a block
89
+ of information in the tag. The tag consists of a header, frames and
90
+ optional padding. A field is a piece of information; one value, a
91
+ string etc. A numeric string is a string that consists of the
92
+ characters 0-9 only.
93
+
94
+
95
+ 3. ID3v2 overview
96
+
97
+ The two biggest design goals were to be able to implement ID3v2
98
+ without disturbing old software too much and that ID3v2 should be
99
+ expandable.
100
+
101
+ The first criterion is met by the simple fact that the MPEG [MPEG]
102
+ decoding software uses a syncsignal, embedded in the audiostream, to
103
+ 'lock on to' the audio. Since the ID3v2 tag doesn't contain a valid
104
+ syncsignal, no software will attempt to play the tag. If, for any
105
+ reason, coincidence make a syncsignal appear within the tag it will be
106
+ taken care of by the 'unsynchronisation scheme' described in section
107
+ 5.
108
+
109
+ The second criterion has made a more noticeable impact on the design
110
+ of the ID3v2 tag. It is constructed as a container for several
111
+ information blocks, called frames, whose format need not be known to
112
+ the software that encounters them. At the start of every frame there
113
+ is an identifier that explains the frames's format and content, and a
114
+ size descriptor that allows software to skip unknown frames.
115
+
116
+ If a total revision of the ID3v2 tag should be needed, there is a
117
+ version number and a size descriptor in the ID3v2 header.
118
+
119
+ The ID3 tag described in this document is mainly targeted to files
120
+ encoded with MPEG-2 layer I, MPEG-2 layer II, MPEG-2 layer III and
121
+ MPEG-2.5, but may work with other types of encoded audio.
122
+
123
+ The bitorder in ID3v2 is most significant bit first (MSB). The
124
+ byteorder in multibyte numbers is most significant byte first (e.g.
125
+ $12345678 would be encoded $12 34 56 78).
126
+
127
+ It is permitted to include padding after all the final frame (at the
128
+ end of the ID3 tag), making the size of all the frames together
129
+ smaller than the size given in the head of the tag. A possible purpose
130
+ of this padding is to allow for adding a few additional frames or
131
+ enlarge existing frames within the tag without having to rewrite the
132
+ entire file. The value of the padding bytes must be $00.
133
+
134
+
135
+ 3.1. ID3v2 header
136
+
137
+ The ID3v2 tag header, which should be the first information in the
138
+ file, is 10 bytes as follows:
139
+
140
+ ID3/file identifier "ID3"
141
+ ID3 version $02 00
142
+ ID3 flags %xx000000
143
+ ID3 size 4 * %0xxxxxxx
144
+
145
+ The first three bytes of the tag are always "ID3" to indicate that
146
+ this is an ID3 tag, directly followed by the two version bytes. The
147
+ first byte of ID3 version is it's major version, while the second byte
148
+ is its revision number. All revisions are backwards compatible while
149
+ major versions are not. If software with ID3v2 and below support
150
+ should encounter version three or higher it should simply ignore the
151
+ whole tag. Version and revision will never be $FF.
152
+
153
+ The first bit (bit 7) in the 'ID3 flags' is indicating whether or not
154
+ unsynchronisation is used (see section 5 for details); a set bit
155
+ indicates usage.
156
+
157
+ The second bit (bit 6) is indicating whether or not compression is
158
+ used; a set bit indicates usage. Since no compression scheme has been
159
+ decided yet, the ID3 decoder (for now) should just ignore the entire
160
+ tag if the compression bit is set.
161
+
162
+ The ID3 tag size is encoded with four bytes where the first bit (bit
163
+ 7) is set to zero in every byte, making a total of 28 bits. The zeroed
164
+ bits are ignored, so a 257 bytes long tag is represented as $00 00 02
165
+ 01.
166
+
167
+ The ID3 tag size is the size of the complete tag after
168
+ unsychronisation, including padding, excluding the header (total tag
169
+ size - 10). The reason to use 28 bits (representing up to 256MB) for
170
+ size description is that we don't want to run out of space here.
171
+
172
+ A ID3v2 tag can be detected with the following pattern:
173
+ $49 44 33 yy yy xx zz zz zz zz
174
+ Where yy is less than $FF, xx is the 'flags' byte and zz is less than
175
+ $80.
176
+
177
+
178
+ 3.2. ID3v2 frames overview
179
+
180
+ The headers of the frames are similar in their construction. They
181
+ consist of one three character identifier (capital A-Z and 0-9) and
182
+ one three byte size field, making a total of six bytes. The header is
183
+ excluded from the size. Identifiers beginning with "X", "Y" and "Z"
184
+ are for experimental use and free for everyone to use. Have in mind
185
+ that someone else might have used the same identifier as you. All
186
+ other identifiers are either used or reserved for future use.
187
+
188
+ The three character frame identifier is followed by a three byte size
189
+ descriptor, making a total header size of six bytes in every frame.
190
+ The size is calculated as framesize excluding frame identifier and
191
+ size descriptor (frame size - 6).
192
+
193
+ There is no fixed order of the frames' appearance in the tag, although
194
+ it is desired that the frames are arranged in order of significance
195
+ concerning the recognition of the file. An example of such order:
196
+ UFI, MCI, TT2 ...
197
+
198
+ A tag must contain at least one frame. A frame must be at least 1 byte
199
+ big, excluding the 6-byte header.
200
+
201
+ If nothing else is said a string is represented as ISO-8859-1
202
+ [ISO-8859-1] characters in the range $20 - $FF. All unicode strings
203
+ [UNICODE] use 16-bit unicode 2.0 (ISO/IEC 10646-1:1993, UCS-2). All
204
+ numeric strings are always encoded as ISO-8859-1. Terminated strings
205
+ are terminated with $00 if encoded with ISO-8859-1 and $00 00 if
206
+ encoded as unicode. If nothing else is said newline character is
207
+ forbidden. In ISO-8859-1 a new line is represented, when allowed, with
208
+ $0A only. Frames that allow different types of text encoding have a
209
+ text encoding description byte directly after the frame size. If
210
+ ISO-8859-1 is used this byte should be $00, if unicode is used it
211
+ should be $01.
212
+
213
+ The three byte language field is used to describe the language of the
214
+ frame's content, according to ISO-639-2 [ISO-639-2].
215
+
216
+ All URLs [URL] may be relative, e.g. "picture.png", "../doc.txt".
217
+
218
+ If a frame is longer than it should be, e.g. having more fields than
219
+ specified in this document, that indicates that additions to the
220
+ frame have been made in a later version of the ID3 standard. This
221
+ is reflected by the revision number in the header of the tag.
222
+
223
+
224
+ 4. Declared ID3v2 frames
225
+
226
+ The following frames are declared in this draft.
227
+
228
+ 4.19 BUF Recommended buffer size
229
+
230
+ 4.17 CNT Play counter
231
+ 4.11 COM Comments
232
+ 4.21 CRA Audio encryption
233
+ 4.20 CRM Encrypted meta frame
234
+
235
+ 4.6 ETC Event timing codes
236
+ 4.13 EQU Equalization
237
+
238
+ 4.16 GEO General encapsulated object
239
+
240
+ 4.4 IPL Involved people list
241
+
242
+ 4.22 LNK Linked information
243
+
244
+ 4.5 MCI Music CD Identifier
245
+ 4.7 MLL MPEG location lookup table
246
+
247
+ 4.15 PIC Attached picture
248
+ 4.18 POP Popularimeter
249
+
250
+ 4.14 REV Reverb
251
+ 4.12 RVA Relative volume adjustment
252
+
253
+ 4.10 SLT Synchronized lyric/text
254
+ 4.8 STC Synced tempo codes
255
+
256
+ 4.2.1 TAL Album/Movie/Show title
257
+ 4.2.1 TBP BPM (Beats Per Minute)
258
+ 4.2.1 TCM Composer
259
+ 4.2.1 TCO Content type
260
+ 4.2.1 TCR Copyright message
261
+ 4.2.1 TDA Date
262
+ 4.2.1 TDY Playlist delay
263
+ 4.2.1 TEN Encoded by
264
+ 4.2.1 TFT File type
265
+ 4.2.1 TIM Time
266
+ 4.2.1 TKE Initial key
267
+ 4.2.1 TLA Language(s)
268
+ 4.2.1 TLE Length
269
+ 4.2.1 TMT Media type
270
+ 4.2.1 TOA Original artist(s)/performer(s)
271
+ 4.2.1 TOF Original filename
272
+ 4.2.1 TOL Original Lyricist(s)/text writer(s)
273
+ 4.2.1 TOR Original release year
274
+ 4.2.1 TOT Original album/Movie/Show title
275
+ 4.2.1 TP1 Lead artist(s)/Lead performer(s)/Soloist(s)/Performing group
276
+ 4.2.1 TP2 Band/Orchestra/Accompaniment
277
+ 4.2.1 TP3 Conductor/Performer refinement
278
+ 4.2.1 TP4 Interpreted, remixed, or otherwise modified by
279
+ 4.2.1 TPA Part of a set
280
+ 4.2.1 TPB Publisher
281
+ 4.2.1 TRC ISRC (International Standard Recording Code)
282
+ 4.2.1 TRD Recording dates
283
+ 4.2.1 TRK Track number/Position in set
284
+ 4.2.1 TSI Size
285
+ 4.2.1 TSS Software/hardware and settings used for encoding
286
+ 4.2.1 TT1 Content group description
287
+ 4.2.1 TT2 Title/Songname/Content description
288
+ 4.2.1 TT3 Subtitle/Description refinement
289
+ 4.2.1 TXT Lyricist/text writer
290
+ 4.2.2 TXX User defined text information frame
291
+ 4.2.1 TYE Year
292
+
293
+ 4.1 UFI Unique file identifier
294
+ 4.9 ULT Unsychronized lyric/text transcription
295
+
296
+ 4.3.1 WAF Official audio file webpage
297
+ 4.3.1 WAR Official artist/performer webpage
298
+ 4.3.1 WAS Official audio source webpage
299
+ 4.3.1 WCM Commercial information
300
+ 4.3.1 WCP Copyright/Legal information
301
+ 4.3.1 WPB Publishers official webpage
302
+ 4.3.2 WXX User defined URL link frame
303
+
304
+
305
+ 4.1. Unique file identifier
306
+
307
+ This frame's purpose is to be able to identify the audio file in a
308
+ database that may contain more information relevant to the content.
309
+ Since standardisation of such a database is beyond this document, all
310
+ frames begin with a null-terminated string with a URL [URL] containing
311
+ an email address, or a link to a location where an email address can
312
+ be found, that belongs to the organisation responsible for this
313
+ specific database implementation. Questions regarding the database
314
+ should be sent to the indicated email address. The URL should not be
315
+ used for the actual database queries. If a $00 is found directly after
316
+ the 'Frame size' the whole frame should be ignored, and preferably be
317
+ removed. The 'Owner identifier' is then followed by the actual
318
+ identifier, which may be up to 64 bytes. There may be more than one
319
+ "UFI" frame in a tag, but only one with the same 'Owner identifier'.
320
+
321
+ Unique file identifier "UFI"
322
+ Frame size $xx xx xx
323
+ Owner identifier <textstring> $00
324
+ Identifier <up to 64 bytes binary data>
325
+
326
+
327
+ 4.2. Text information frames
328
+
329
+ The text information frames are the most important frames, containing
330
+ information like artist, album and more. There may only be one text
331
+ information frame of its kind in an tag. If the textstring is followed
332
+ by a termination ($00 (00)) all the following information should be
333
+ ignored and not be displayed. All the text information frames have the
334
+ following format:
335
+
336
+ Text information identifier "T00" - "TZZ" , excluding "TXX",
337
+ described in 4.2.2.
338
+ Frame size $xx xx xx
339
+ Text encoding $xx
340
+ Information <textstring>
341
+
342
+
343
+ 4.2.1. Text information frames - details
344
+
345
+ TT1
346
+ The 'Content group description' frame is used if the sound belongs to
347
+ a larger category of sounds/music. For example, classical music is
348
+ often sorted in different musical sections (e.g. "Piano Concerto",
349
+ "Weather - Hurricane").
350
+
351
+ TT2
352
+ The 'Title/Songname/Content description' frame is the actual name of
353
+ the piece (e.g. "Adagio", "Hurricane Donna").
354
+
355
+ TT3
356
+ The 'Subtitle/Description refinement' frame is used for information
357
+ directly related to the contents title (e.g. "Op. 16" or "Performed
358
+ live at wembley").
359
+
360
+ TP1
361
+ The 'Lead artist(s)/Lead performer(s)/Soloist(s)/Performing group' is
362
+ used for the main artist(s). They are seperated with the "/"
363
+ character.
364
+
365
+ TP2
366
+ The 'Band/Orchestra/Accompaniment' frame is used for additional
367
+ information about the performers in the recording.
368
+
369
+ TP3
370
+ The 'Conductor' frame is used for the name of the conductor.
371
+
372
+ TP4
373
+ The 'Interpreted, remixed, or otherwise modified by' frame contains
374
+ more information about the people behind a remix and similar
375
+ interpretations of another existing piece.
376
+
377
+ TCM
378
+ The 'Composer(s)' frame is intended for the name of the composer(s).
379
+ They are seperated with the "/" character.
380
+
381
+ TXT
382
+ The 'Lyricist(s)/text writer(s)' frame is intended for the writer(s)
383
+ of the text or lyrics in the recording. They are seperated with the
384
+ "/" character.
385
+
386
+ TLA
387
+ The 'Language(s)' frame should contain the languages of the text or
388
+ lyrics in the audio file. The language is represented with three
389
+ characters according to ISO-639-2. If more than one language is used
390
+ in the text their language codes should follow according to their
391
+ usage.
392
+
393
+ TCO
394
+ The content type, which previously (in ID3v1.1, see appendix A) was
395
+ stored as a one byte numeric value only, is now a numeric string. You
396
+ may use one or several of the types as ID3v1.1 did or, since the
397
+ category list would be impossible to maintain with accurate and up to
398
+ date categories, define your own.
399
+ References to the ID3v1 genres can be made by, as first byte, enter
400
+ "(" followed by a number from the genres list (section A.3.) and
401
+ ended with a ")" character. This is optionally followed by a
402
+ refinement, e.g. "(21)" or "(4)Eurodisco". Several references can be
403
+ made in the same frame, e.g. "(51)(39)". If the refinement should
404
+ begin with a "(" character it should be replaced with "((", e.g. "((I
405
+ can figure out any genre)" or "(55)((I think...)". The following new
406
+ content types is defined in ID3v2 and is implemented in the same way
407
+ as the numerig content types, e.g. "(RX)".
408
+
409
+ RX Remix
410
+ CR Cover
411
+
412
+ TAL
413
+ The 'Album/Movie/Show title' frame is intended for the title of the
414
+ recording(/source of sound) which the audio in the file is taken from.
415
+
416
+ TPA
417
+ The 'Part of a set' frame is a numeric string that describes which
418
+ part of a set the audio came from. This frame is used if the source
419
+ described in the "TAL" frame is divided into several mediums, e.g. a
420
+ double CD. The value may be extended with a "/" character and a
421
+ numeric string containing the total number of parts in the set. E.g.
422
+ "1/2".
423
+
424
+ TRK
425
+ The 'Track number/Position in set' frame is a numeric string
426
+ containing the order number of the audio-file on its original
427
+ recording. This may be extended with a "/" character and a numeric
428
+ string containing the total numer of tracks/elements on the original
429
+ recording. E.g. "4/9".
430
+
431
+ TRC
432
+ The 'ISRC' frame should contian the International Standard Recording
433
+ Code [ISRC].
434
+
435
+ TYE
436
+ The 'Year' frame is a numeric string with a year of the recording.
437
+ This frames is always four characters long (until the year 10000).
438
+
439
+ TDA
440
+ The 'Date' frame is a numeric string in the DDMM format containing
441
+ the date for the recording. This field is always four characters
442
+ long.
443
+
444
+ TIM
445
+ The 'Time' frame is a numeric string in the HHMM format containing
446
+ the time for the recording. This field is always four characters
447
+ long.
448
+
449
+ TRD
450
+ The 'Recording dates' frame is a intended to be used as complement to
451
+ the "TYE", "TDA" and "TIM" frames. E.g. "4th-7th June, 12th June" in
452
+ combination with the "TYE" frame.
453
+
454
+ TMT
455
+ The 'Media type' frame describes from which media the sound
456
+ originated. This may be a textstring or a reference to the predefined
457
+ media types found in the list below. References are made within "("
458
+ and ")" and are optionally followed by a text refinement, e.g. "(MC)
459
+ with four channels". If a text refinement should begin with a "("
460
+ character it should be replaced with "((" in the same way as in the
461
+ "TCO" frame. Predefined refinements is appended after the media type,
462
+ e.g. "(CD/S)" or "(VID/PAL/VHS)".
463
+
464
+ DIG Other digital media
465
+ /A Analog transfer from media
466
+
467
+ ANA Other analog media
468
+ /WAC Wax cylinder
469
+ /8CA 8-track tape cassette
470
+
471
+ CD CD
472
+ /A Analog transfer from media
473
+ /DD DDD
474
+ /AD ADD
475
+ /AA AAD
476
+
477
+ LD Laserdisc
478
+ /A Analog transfer from media
479
+
480
+ TT Turntable records
481
+ /33 33.33 rpm
482
+ /45 45 rpm
483
+ /71 71.29 rpm
484
+ /76 76.59 rpm
485
+ /78 78.26 rpm
486
+ /80 80 rpm
487
+
488
+ MD MiniDisc
489
+ /A Analog transfer from media
490
+
491
+ DAT DAT
492
+ /A Analog transfer from media
493
+ /1 standard, 48 kHz/16 bits, linear
494
+ /2 mode 2, 32 kHz/16 bits, linear
495
+ /3 mode 3, 32 kHz/12 bits, nonlinear, low speed
496
+ /4 mode 4, 32 kHz/12 bits, 4 channels
497
+ /5 mode 5, 44.1 kHz/16 bits, linear
498
+ /6 mode 6, 44.1 kHz/16 bits, 'wide track' play
499
+
500
+ DCC DCC
501
+ /A Analog transfer from media
502
+
503
+ DVD DVD
504
+ /A Analog transfer from media
505
+
506
+ TV Television
507
+ /PAL PAL
508
+ /NTSC NTSC
509
+ /SECAM SECAM
510
+
511
+ VID Video
512
+ /PAL PAL
513
+ /NTSC NTSC
514
+ /SECAM SECAM
515
+ /VHS VHS
516
+ /SVHS S-VHS
517
+ /BETA BETAMAX
518
+
519
+ RAD Radio
520
+ /FM FM
521
+ /AM AM
522
+ /LW LW
523
+ /MW MW
524
+
525
+ TEL Telephone
526
+ /I ISDN
527
+
528
+ MC MC (normal cassette)
529
+ /4 4.75 cm/s (normal speed for a two sided cassette)
530
+ /9 9.5 cm/s
531
+ /I Type I cassette (ferric/normal)
532
+ /II Type II cassette (chrome)
533
+ /III Type III cassette (ferric chrome)
534
+ /IV Type IV cassette (metal)
535
+
536
+ REE Reel
537
+ /9 9.5 cm/s
538
+ /19 19 cm/s
539
+ /38 38 cm/s
540
+ /76 76 cm/s
541
+ /I Type I cassette (ferric/normal)
542
+ /II Type II cassette (chrome)
543
+ /III Type III cassette (ferric chrome)
544
+ /IV Type IV cassette (metal)
545
+
546
+ TFT
547
+ The 'File type' frame indicates which type of audio this tag defines.
548
+ The following type and refinements are defined:
549
+
550
+ MPG MPEG Audio
551
+ /1 MPEG 2 layer I
552
+ /2 MPEG 2 layer II
553
+ /3 MPEG 2 layer III
554
+ /2.5 MPEG 2.5
555
+ /AAC Advanced audio compression
556
+
557
+ but other types may be used, not for these types though. This is used
558
+ in a similar way to the predefined types in the "TMT" frame, but
559
+ without parenthesis. If this frame is not present audio type is
560
+ assumed to be "MPG".
561
+
562
+ TBP
563
+ BPM is short for beats per minute, and is easily computed by
564
+ dividing the number of beats in a musical piece with its length. To
565
+ get a more accurate result, do the BPM calculation on the main-part
566
+ only. To acquire best result measure the time between each beat and
567
+ calculate individual BPM for each beat and use the median value as
568
+ result. BPM is an integer and represented as a numerical string.
569
+
570
+ TCR
571
+ The 'Copyright message' frame, which must begin with a year and a
572
+ space character (making five characters), is intended for the
573
+ copyright holder of the original sound, not the audio file itself. The
574
+ absence of this frame means only that the copyright information is
575
+ unavailable or has been removed, and must not be interpreted to mean
576
+ that the sound is public domain. Every time this field is displayed
577
+ the field must be preceded with "Copyright " (C) " ", where (C) is one
578
+ character showing a C in a circle.
579
+
580
+ TPB
581
+ The 'Publisher' frame simply contains the name of the label or
582
+ publisher.
583
+
584
+ TEN
585
+ The 'Encoded by' frame contains the name of the person or
586
+ organisation that encoded the audio file. This field may contain a
587
+ copyright message, if the audio file also is copyrighted by the
588
+ encoder.
589
+
590
+ TSS
591
+ The 'Software/hardware and settings used for encoding' frame
592
+ includes the used audio encoder and its settings when the file was
593
+ encoded. Hardware refers to hardware encoders, not the computer on
594
+ which a program was run.
595
+
596
+ TOF
597
+ The 'Original filename' frame contains the preferred filename for the
598
+ file, since some media doesn't allow the desired length of the
599
+ filename. The filename is case sensitive and includes its suffix.
600
+
601
+ TLE
602
+ The 'Length' frame contains the length of the audiofile in
603
+ milliseconds, represented as a numeric string.
604
+
605
+ TSI
606
+ The 'Size' frame contains the size of the audiofile in bytes
607
+ excluding the tag, represented as a numeric string.
608
+
609
+ TDY
610
+ The 'Playlist delay' defines the numbers of milliseconds of silence
611
+ between every song in a playlist. The player should use the "ETC"
612
+ frame, if present, to skip initial silence and silence at the end of
613
+ the audio to match the 'Playlist delay' time. The time is represented
614
+ as a numeric string.
615
+
616
+ TKE
617
+ The 'Initial key' frame contains the musical key in which the sound
618
+ starts. It is represented as a string with a maximum length of three
619
+ characters. The ground keys are represented with "A","B","C","D","E",
620
+ "F" and "G" and halfkeys represented with "b" and "#". Minor is
621
+ represented as "m". Example "Cbm". Off key is represented with an "o"
622
+ only.
623
+
624
+ TOT
625
+ The 'Original album/Movie/Show title' frame is intended for the title
626
+ of the original recording(/source of sound), if for example the music
627
+ in the file should be a cover of a previously released song.
628
+
629
+ TOA
630
+ The 'Original artist(s)/performer(s)' frame is intended for the
631
+ performer(s) of the original recording, if for example the music in
632
+ the file should be a cover of a previously released song. The
633
+ performers are seperated with the "/" character.
634
+
635
+ TOL
636
+ The 'Original Lyricist(s)/text writer(s)' frame is intended for the
637
+ text writer(s) of the original recording, if for example the music in
638
+ the file should be a cover of a previously released song. The text
639
+ writers are seperated with the "/" character.
640
+
641
+ TOR
642
+ The 'Original release year' frame is intended for the year when the
643
+ original recording, if for example the music in the file should be a
644
+ cover of a previously released song, was released. The field is
645
+ formatted as in the "TDY" frame.
646
+
647
+
648
+ 4.2.2. User defined text information frame
649
+
650
+ This frame is intended for one-string text information concerning the
651
+ audiofile in a similar way to the other "T"xx frames. The frame body
652
+ consists of a description of the string, represented as a terminated
653
+ string, followed by the actual string. There may be more than one
654
+ "TXX" frame in each tag, but only one with the same description.
655
+
656
+ User defined... "TXX"
657
+ Frame size $xx xx xx
658
+ Text encoding $xx
659
+ Description <textstring> $00 (00)
660
+ Value <textstring>
661
+
662
+
663
+ 4.3. URL link frames
664
+
665
+ With these frames dynamic data such as webpages with touring
666
+ information, price information or plain ordinary news can be added to
667
+ the tag. There may only be one URL [URL] link frame of its kind in an
668
+ tag, except when stated otherwise in the frame description. If the
669
+ textstring is followed by a termination ($00 (00)) all the following
670
+ information should be ignored and not be displayed. All URL link
671
+ frames have the following format:
672
+
673
+ URL link frame "W00" - "WZZ" , excluding "WXX"
674
+ (described in 4.3.2.)
675
+ Frame size $xx xx xx
676
+ URL <textstring>
677
+
678
+
679
+ 4.3.1. URL link frames - details
680
+
681
+ WAF
682
+ The 'Official audio file webpage' frame is a URL pointing at a file
683
+ specific webpage.
684
+
685
+ WAR
686
+ The 'Official artist/performer webpage' frame is a URL pointing at
687
+ the artists official webpage. There may be more than one "WAR" frame
688
+ in a tag if the audio contains more than one performer.
689
+
690
+ WAS
691
+ The 'Official audio source webpage' frame is a URL pointing at the
692
+ official webpage for the source of the audio file, e.g. a movie.
693
+
694
+ WCM
695
+ The 'Commercial information' frame is a URL pointing at a webpage
696
+ with information such as where the album can be bought. There may be
697
+ more than one "WCM" frame in a tag.
698
+
699
+ WCP
700
+ The 'Copyright/Legal information' frame is a URL pointing at a
701
+ webpage where the terms of use and ownership of the file is described.
702
+
703
+ WPB
704
+ The 'Publishers official webpage' frame is a URL pointing at the
705
+ official wepage for the publisher.
706
+
707
+
708
+ 4.3.2. User defined URL link frame
709
+
710
+ This frame is intended for URL [URL] links concerning the audiofile in
711
+ a similar way to the other "W"xx frames. The frame body consists of a
712
+ description of the string, represented as a terminated string,
713
+ followed by the actual URL. The URL is always encoded with ISO-8859-1
714
+ [ISO-8859-1]. There may be more than one "WXX" frame in each tag, but
715
+ only one with the same description.
716
+
717
+ User defined... "WXX"
718
+ Frame size $xx xx xx
719
+ Text encoding $xx
720
+ Description <textstring> $00 (00)
721
+ URL <textstring>
722
+
723
+
724
+ 4.4. Involved people list
725
+
726
+ Since there might be a lot of people contributing to an audio file in
727
+ various ways, such as musicians and technicians, the 'Text
728
+ information frames' are often insufficient to list everyone involved
729
+ in a project. The 'Involved people list' is a frame containing the
730
+ names of those involved, and how they were involved. The body simply
731
+ contains a terminated string with the involvement directly followed by
732
+ a terminated string with the involvee followed by a new involvement
733
+ and so on. There may only be one "IPL" frame in each tag.
734
+
735
+ Involved people list "IPL"
736
+ Frame size $xx xx xx
737
+ Text encoding $xx
738
+ People list strings <textstrings>
739
+
740
+
741
+ 4.5. Music CD Identifier
742
+
743
+ This frame is intended for music that comes from a CD, so that the CD
744
+ can be identified in databases such as the CDDB [CDDB]. The frame
745
+ consists of a binary dump of the Table Of Contents, TOC, from the CD,
746
+ which is a header of 4 bytes and then 8 bytes/track on the CD making a
747
+ maximum of 804 bytes. This frame requires a present and valid "TRK"
748
+ frame. There may only be one "MCI" frame in each tag.
749
+
750
+ Music CD identifier "MCI"
751
+ Frame size $xx xx xx
752
+ CD TOC <binary data>
753
+
754
+
755
+ 4.6. Event timing codes
756
+
757
+ This frame allows synchronisation with key events in a song or sound.
758
+ The head is:
759
+
760
+ Event timing codes "ETC"
761
+ Frame size $xx xx xx
762
+ Time stamp format $xx
763
+
764
+ Where time stamp format is:
765
+
766
+ $01 Absolute time, 32 bit sized, using MPEG [MPEG] frames as unit
767
+ $02 Absolute time, 32 bit sized, using milliseconds as unit
768
+
769
+ Abolute time means that every stamp contains the time from the
770
+ beginning of the file.
771
+
772
+ Followed by a list of key events in the following format:
773
+
774
+ Type of event $xx
775
+ Time stamp $xx (xx ...)
776
+
777
+ The 'Time stamp' is set to zero if directly at the beginning of the
778
+ sound or after the previous event. All events should be sorted in
779
+ chronological order. The type of event is as follows:
780
+
781
+ $00 padding (has no meaning)
782
+ $01 end of initial silence
783
+ $02 intro start
784
+ $03 mainpart start
785
+ $04 outro start
786
+ $05 outro end
787
+ $06 verse begins
788
+ $07 refrain begins
789
+ $08 interlude
790
+ $09 theme start
791
+ $0A variation
792
+ $0B key change
793
+ $0C time change
794
+ $0D unwanted noise (Snap, Crackle & Pop)
795
+
796
+ $0E-$DF reserved for future use
797
+
798
+ $E0-$EF not predefined sync 0-F
799
+
800
+ $F0-$FC reserved for future use
801
+
802
+ $FD audio end (start of silence)
803
+ $FE audio file ends
804
+ $FF one more byte of events follows (all the following bytes with
805
+ the value $FF have the same function)
806
+
807
+ The 'Not predefined sync's ($E0-EF) are for user events. You might
808
+ want to synchronise your music to something, like setting of an
809
+ explosion on-stage, turning on your screensaver etc.
810
+
811
+ There may only be one "ETC" frame in each tag.
812
+
813
+
814
+ 4.7. MPEG location lookup table
815
+
816
+ To increase performance and accuracy of jumps within a MPEG [MPEG]
817
+ audio file, frames with timecodes in different locations in the file
818
+ might be useful. The ID3 frame includes references that the software
819
+ can use to calculate positions in the file. After the frame header is
820
+ a descriptor of how much the 'frame counter' should increase for every
821
+ reference. If this value is two then the first reference points out
822
+ the second frame, the 2nd reference the 4th frame, the 3rd reference
823
+ the 6th frame etc. In a similar way the 'bytes between reference' and
824
+ 'milliseconds between reference' points out bytes and milliseconds
825
+ respectively.
826
+
827
+ Each reference consists of two parts; a certain number of bits, as
828
+ defined in 'bits for bytes deviation', that describes the difference
829
+ between what is said in 'bytes between reference' and the reality and
830
+ a certain number of bits, as defined in 'bits for milliseconds
831
+ deviation', that describes the difference between what is said in
832
+ 'milliseconds between reference' and the reality. The number of bits
833
+ in every reference, i.e. 'bits for bytes deviation'+'bits for
834
+ milliseconds deviation', must be a multiple of four. There may only be
835
+ one "MLL" frame in each tag.
836
+
837
+ Location lookup table "MLL"
838
+ ID3 frame size $xx xx xx
839
+ MPEG frames between reference $xx xx
840
+ Bytes between reference $xx xx xx
841
+ Milliseconds between reference $xx xx xx
842
+ Bits for bytes deviation $xx
843
+ Bits for milliseconds dev. $xx
844
+
845
+ Then for every reference the following data is included;
846
+
847
+ Deviation in bytes %xxx....
848
+ Deviation in milliseconds %xxx....
849
+
850
+
851
+ 4.8. Synced tempo codes
852
+
853
+ For a more accurate description of the tempo of a musical piece this
854
+ frame might be used. After the header follows one byte describing
855
+ which time stamp format should be used. Then follows one or more tempo
856
+ codes. Each tempo code consists of one tempo part and one time part.
857
+ The tempo is in BPM described with one or two bytes. If the first byte
858
+ has the value $FF, one more byte follows, which is added to the first
859
+ giving a range from 2 - 510 BPM, since $00 and $01 is reserved. $00 is
860
+ used to describe a beat-free time period, which is not the same as a
861
+ music-free time period. $01 is used to indicate one single beat-stroke
862
+ followed by a beat-free period.
863
+
864
+ The tempo descriptor is followed by a time stamp. Every time the tempo
865
+ in the music changes, a tempo descriptor may indicate this for the
866
+ player. All tempo descriptors should be sorted in chronological order.
867
+ The first beat-stroke in a time-period is at the same time as the beat
868
+ description occurs. There may only be one "STC" frame in each tag.
869
+
870
+ Synced tempo codes "STC"
871
+ Frame size $xx xx xx
872
+ Time stamp format $xx
873
+ Tempo data <binary data>
874
+
875
+ Where time stamp format is:
876
+
877
+ $01 Absolute time, 32 bit sized, using MPEG [MPEG] frames as unit
878
+ $02 Absolute time, 32 bit sized, using milliseconds as unit
879
+
880
+ Abolute time means that every stamp contains the time from the
881
+ beginning of the file.
882
+
883
+
884
+ 4.9. Unsychronised lyrics/text transcription
885
+
886
+ This frame contains the lyrics of the song or a text transcription of
887
+ other vocal activities. The head includes an encoding descriptor and
888
+ a content descriptor. The body consists of the actual text. The
889
+ 'Content descriptor' is a terminated string. If no descriptor is
890
+ entered, 'Content descriptor' is $00 (00) only. Newline characters
891
+ are allowed in the text. Maximum length for the descriptor is 64
892
+ bytes. There may be more than one lyrics/text frame in each tag, but
893
+ only one with the same language and content descriptor.
894
+
895
+ Unsynced lyrics/text "ULT"
896
+ Frame size $xx xx xx
897
+ Text encoding $xx
898
+ Language $xx xx xx
899
+ Content descriptor <textstring> $00 (00)
900
+ Lyrics/text <textstring>
901
+
902
+
903
+ 4.10. Synchronised lyrics/text
904
+
905
+ This is another way of incorporating the words, said or sung lyrics,
906
+ in the audio file as text, this time, however, in sync with the audio.
907
+ It might also be used to describing events e.g. occurring on a stage
908
+ or on the screen in sync with the audio. The header includes a content
909
+ descriptor, represented with as terminated textstring. If no
910
+ descriptor is entered, 'Content descriptor' is $00 (00) only.
911
+
912
+ Synced lyrics/text "SLT"
913
+ Frame size $xx xx xx
914
+ Text encoding $xx
915
+ Language $xx xx xx
916
+ Time stamp format $xx
917
+ Content type $xx
918
+ Content descriptor <textstring> $00 (00)
919
+
920
+
921
+ Encoding: $00 ISO-8859-1 [ISO-8859-1] character set is used => $00
922
+ is sync identifier.
923
+ $01 Unicode [UNICODE] character set is used => $00 00 is
924
+ sync identifier.
925
+
926
+ Content type: $00 is other
927
+ $01 is lyrics
928
+ $02 is text transcription
929
+ $03 is movement/part name (e.g. "Adagio")
930
+ $04 is events (e.g. "Don Quijote enters the stage")
931
+ $05 is chord (e.g. "Bb F Fsus")
932
+
933
+ Time stamp format is:
934
+
935
+ $01 Absolute time, 32 bit sized, using MPEG [MPEG] frames as unit
936
+ $02 Absolute time, 32 bit sized, using milliseconds as unit
937
+
938
+ Abolute time means that every stamp contains the time from the
939
+ beginning of the file.
940
+
941
+ The text that follows the frame header differs from that of the
942
+ unsynchronised lyrics/text transcription in one major way. Each
943
+ syllable (or whatever size of text is considered to be convenient by
944
+ the encoder) is a null terminated string followed by a time stamp
945
+ denoting where in the sound file it belongs. Each sync thus has the
946
+ following structure:
947
+
948
+ Terminated text to be synced (typically a syllable)
949
+ Sync identifier (terminator to above string) $00 (00)
950
+ Time stamp $xx (xx ...)
951
+
952
+ The 'time stamp' is set to zero or the whole sync is omitted if
953
+ located directly at the beginning of the sound. All time stamps should
954
+ be sorted in chronological order. The sync can be considered as a
955
+ validator of the subsequent string.
956
+
957
+ Newline characters are allowed in all "SLT" frames and should be used
958
+ after every entry (name, event etc.) in a frame with the content type
959
+ $03 - $04.
960
+
961
+ A few considerations regarding whitespace characters: Whitespace
962
+ separating words should mark the beginning of a new word, thus
963
+ occurring in front of the first syllable of a new word. This is also
964
+ valid for new line characters. A syllable followed by a comma should
965
+ not be broken apart with a sync (both the syllable and the comma
966
+ should be before the sync).
967
+
968
+ An example: The "ULT" passage
969
+
970
+ "Strangers in the night" $0A "Exchanging glances"
971
+
972
+ would be "SLT" encoded as:
973
+
974
+ "Strang" $00 xx xx "ers" $00 xx xx " in" $00 xx xx " the" $00 xx xx
975
+ " night" $00 xx xx 0A "Ex" $00 xx xx "chang" $00 xx xx "ing" $00 xx
976
+ xx "glan" $00 xx xx "ces" $00 xx xx
977
+
978
+ There may be more than one "SLT" frame in each tag, but only one with
979
+ the same language and content descriptor.
980
+
981
+
982
+ 4.11. Comments
983
+
984
+ This frame replaces the old 30-character comment field in ID3v1. It
985
+ consists of a frame head followed by encoding, language and content
986
+ descriptors and is ended with the actual comment as a text string.
987
+ Newline characters are allowed in the comment text string. There may
988
+ be more than one comment frame in each tag, but only one with the same
989
+ language and content descriptor.
990
+
991
+ Comment "COM"
992
+ Frame size $xx xx xx
993
+ Text encoding $xx
994
+ Language $xx xx xx
995
+ Short content description <textstring> $00 (00)
996
+ The actual text <textstring>
997
+
998
+
999
+ 4.12. Relative volume adjustment
1000
+
1001
+ This is a more subjective function than the previous ones. It allows
1002
+ the user to say how much he wants to increase/decrease the volume on
1003
+ each channel while the file is played. The purpose is to be able to
1004
+ align all files to a reference volume, so that you don't have to
1005
+ change the volume constantly. This frame may also be used to balance
1006
+ adjust the audio. If the volume peak levels are known then this could
1007
+ be described with the 'Peak volume right' and 'Peak volume left'
1008
+ field. If Peakvolume is not known these fields could be left zeroed
1009
+ or completely omitted. There may only be one "RVA" frame in each
1010
+ tag.
1011
+
1012
+ Relative volume adjustment "RVA"
1013
+ Frame size $xx xx xx
1014
+ Increment/decrement %000000xx
1015
+ Bits used for volume descr. $xx
1016
+ Relative volume change, right $xx xx (xx ...)
1017
+ Relative volume change, left $xx xx (xx ...)
1018
+ Peak volume right $xx xx (xx ...)
1019
+ Peak volume left $xx xx (xx ...)
1020
+
1021
+ In the increment/decrement field bit 0 is used to indicate the right
1022
+ channel and bit 1 is used to indicate the left channel. 1 is
1023
+ increment and 0 is decrement.
1024
+
1025
+ The 'bits used for volume description' field is normally $10 (16 bits)
1026
+ for MPEG 2 layer I, II and III [MPEG] and MPEG 2.5. This value may not
1027
+ be $00. The volume is always represented with whole bytes, padded in
1028
+ the beginning (highest bits) when 'bits used for volume description'
1029
+ is not a multiple of eight.
1030
+
1031
+
1032
+ 4.13. Equalisation
1033
+
1034
+ This is another subjective, alignment frame. It allows the user to
1035
+ predefine an equalisation curve within the audio file. There may only
1036
+ be one "EQU" frame in each tag.
1037
+
1038
+ Equalisation "EQU"
1039
+ Frame size $xx xx xx
1040
+ Adjustment bits $xx
1041
+
1042
+ The 'adjustment bits' field defines the number of bits used for
1043
+ representation of the adjustment. This is normally $10 (16 bits) for
1044
+ MPEG 2 layer I, II and III [MPEG] and MPEG 2.5. This value may not be
1045
+ $00.
1046
+
1047
+ This is followed by 2 bytes + ('adjustment bits' rounded up to the
1048
+ nearest byte) for every equalisation band in the following format,
1049
+ giving a frequency range of 0 - 32767Hz:
1050
+
1051
+ Increment/decrement %x (MSB of the Frequency)
1052
+ Frequency (lower 15 bits)
1053
+ Adjustment $xx (xx ...)
1054
+
1055
+ The increment/decrement bit is 1 for increment and 0 for decrement.
1056
+ The equalisation bands should be ordered increasingly with reference
1057
+ to frequency. All frequencies don't have to be declared. Adjustments
1058
+ with the value $00 should be omitted. A frequency should only be
1059
+ described once in the frame.
1060
+
1061
+
1062
+ 4.14. Reverb
1063
+
1064
+ Yet another subjective one. You may here adjust echoes of different
1065
+ kinds. Reverb left/right is the delay between every bounce in ms.
1066
+ Reverb bounces left/right is the number of bounces that should be
1067
+ made. $FF equals an infinite number of bounces. Feedback is the amount
1068
+ of volume that should be returned to the next echo bounce. $00 is 0%,
1069
+ $FF is 100%. If this value were $7F, there would be 50% volume
1070
+ reduction on the first bounce, yet 50% on the second and so on. Left
1071
+ to left means the sound from the left bounce to be played in the left
1072
+ speaker, while left to right means sound from the left bounce to be
1073
+ played in the right speaker.
1074
+
1075
+ 'Premix left to right' is the amount of left sound to be mixed in the
1076
+ right before any reverb is applied, where $00 id 0% and $FF is 100%.
1077
+ 'Premix right to left' does the same thing, but right to left. Setting
1078
+ both premix to $FF would result in a mono output (if the reverb is
1079
+ applied symmetric). There may only be one "REV" frame in each tag.
1080
+
1081
+ Reverb settings "REV"
1082
+ Frame size $00 00 0C
1083
+ Reverb left (ms) $xx xx
1084
+ Reverb right (ms) $xx xx
1085
+ Reverb bounces, left $xx
1086
+ Reverb bounces, right $xx
1087
+ Reverb feedback, left to left $xx
1088
+ Reverb feedback, left to right $xx
1089
+ Reverb feedback, right to right $xx
1090
+ Reverb feedback, right to left $xx
1091
+ Premix left to right $xx
1092
+ Premix right to left $xx
1093
+
1094
+
1095
+ 4.15. Attached picture
1096
+
1097
+ This frame contains a picture directly related to the audio file.
1098
+ Image format is preferably "PNG" [PNG] or "JPG" [JFIF]. Description
1099
+ is a short description of the picture, represented as a terminated
1100
+ textstring. The description has a maximum length of 64 characters,
1101
+ but may be empty. There may be several pictures attached to one file,
1102
+ each in their individual "PIC" frame, but only one with the same
1103
+ content descriptor. There may only be one picture with the picture
1104
+ type declared as picture type $01 and $02 respectively. There is a
1105
+ possibility to put only a link to the image file by using the 'image
1106
+ format' "-->" and having a complete URL [URL] instead of picture data.
1107
+ The use of linked files should however be used restrictively since
1108
+ there is the risk of separation of files.
1109
+
1110
+ Attached picture "PIC"
1111
+ Frame size $xx xx xx
1112
+ Text encoding $xx
1113
+ Image format $xx xx xx
1114
+ Picture type $xx
1115
+ Description <textstring> $00 (00)
1116
+ Picture data <binary data>
1117
+
1118
+
1119
+ Picture type: $00 Other
1120
+ $01 32x32 pixels 'file icon' (PNG only)
1121
+ $02 Other file icon
1122
+ $03 Cover (front)
1123
+ $04 Cover (back)
1124
+ $05 Leaflet page
1125
+ $06 Media (e.g. lable side of CD)
1126
+ $07 Lead artist/lead performer/soloist
1127
+ $08 Artist/performer
1128
+ $09 Conductor
1129
+ $0A Band/Orchestra
1130
+ $0B Composer
1131
+ $0C Lyricist/text writer
1132
+ $0D Recording Location
1133
+ $0E During recording
1134
+ $0F During performance
1135
+ $10 Movie/video screen capture
1136
+ $11 A bright coloured fish
1137
+ $12 Illustration
1138
+ $13 Band/artist logotype
1139
+ $14 Publisher/Studio logotype
1140
+
1141
+
1142
+ 4.16. General encapsulated object
1143
+
1144
+ In this frame any type of file can be encapsulated. After the header,
1145
+ 'Frame size' and 'Encoding' follows 'MIME type' [MIME] and 'Filename'
1146
+ for the encapsulated object, both represented as terminated strings
1147
+ encoded with ISO 8859-1 [ISO-8859-1]. The filename is case sensitive.
1148
+ Then follows a content description as terminated string, encoded as
1149
+ 'Encoding'. The last thing in the frame is the actual object. The
1150
+ first two strings may be omitted, leaving only their terminations.
1151
+ MIME type is always an ISO-8859-1 text string. There may be more than
1152
+ one "GEO" frame in each tag, but only one with the same content
1153
+ descriptor.
1154
+
1155
+ General encapsulated object "GEO"
1156
+ Frame size $xx xx xx
1157
+ Text encoding $xx
1158
+ MIME type <textstring> $00
1159
+ Filename <textstring> $00 (00)
1160
+ Content description <textstring> $00 (00)
1161
+ Encapsulated object <binary data>
1162
+
1163
+
1164
+ 4.17. Play counter
1165
+
1166
+ This is simply a counter of the number of times a file has been
1167
+ played. The value is increased by one every time the file begins to
1168
+ play. There may only be one "CNT" frame in each tag. When the counter
1169
+ reaches all one's, one byte is inserted in front of the counter thus
1170
+ making the counter eight bits bigger. The counter must be at least
1171
+ 32-bits long to begin with.
1172
+
1173
+ Play counter "CNT"
1174
+ Frame size $xx xx xx
1175
+ Counter $xx xx xx xx (xx ...)
1176
+
1177
+
1178
+ 4.18. Popularimeter
1179
+
1180
+ The purpose of this frame is to specify how good an audio file is.
1181
+ Many interesting applications could be found to this frame such as a
1182
+ playlist that features better audiofiles more often than others or it
1183
+ could be used to profile a persons taste and find other 'good' files
1184
+ by comparing people's profiles. The frame is very simple. It contains
1185
+ the email address to the user, one rating byte and a four byte play
1186
+ counter, intended to be increased with one for every time the file is
1187
+ played. The email is a terminated string. The rating is 1-255 where
1188
+ 1 is worst and 255 is best. 0 is unknown. If no personal counter is
1189
+ wanted it may be omitted. When the counter reaches all one's, one
1190
+ byte is inserted in front of the counter thus making the counter
1191
+ eight bits bigger in the same away as the play counter ("CNT").
1192
+ There may be more than one "POP" frame in each tag, but only one with
1193
+ the same email address.
1194
+
1195
+ Popularimeter "POP"
1196
+ Frame size $xx xx xx
1197
+ Email to user <textstring> $00
1198
+ Rating $xx
1199
+ Counter $xx xx xx xx (xx ...)
1200
+
1201
+
1202
+ 4.19. Recommended buffer size
1203
+
1204
+ Sometimes the server from which a audio file is streamed is aware of
1205
+ transmission or coding problems resulting in interruptions in the
1206
+ audio stream. In these cases, the size of the buffer can be
1207
+ recommended by the server using this frame. If the 'embedded info
1208
+ flag' is true (1) then this indicates that an ID3 tag with the
1209
+ maximum size described in 'Buffer size' may occur in the audiostream.
1210
+ In such case the tag should reside between two MPEG [MPEG] frames, if
1211
+ the audio is MPEG encoded. If the position of the next tag is known,
1212
+ 'offset to next tag' may be used. The offset is calculated from the
1213
+ end of tag in which this frame resides to the first byte of the header
1214
+ in the next. This field may be omitted. Embedded tags is currently not
1215
+ recommended since this could render unpredictable behaviour from
1216
+ present software/hardware. The 'Buffer size' should be kept to a
1217
+ minimum. There may only be one "BUF" frame in each tag.
1218
+
1219
+ Recommended buffer size "BUF"
1220
+ Frame size $xx xx xx
1221
+ Buffer size $xx xx xx
1222
+ Embedded info flag %0000000x
1223
+ Offset to next tag $xx xx xx xx
1224
+
1225
+
1226
+ 4.20. Encrypted meta frame
1227
+
1228
+ This frame contains one or more encrypted frames. This enables
1229
+ protection of copyrighted information such as pictures and text, that
1230
+ people might want to pay extra for. Since standardisation of such an
1231
+ encryption scheme is beyond this document, all "CRM" frames begin with
1232
+ a terminated string with a URL [URL] containing an email address, or a
1233
+ link to a location where an email adress can be found, that belongs to
1234
+ the organisation responsible for this specific encrypted meta frame.
1235
+
1236
+ Questions regarding the encrypted frame should be sent to the
1237
+ indicated email address. If a $00 is found directly after the 'Frame
1238
+ size', the whole frame should be ignored, and preferably be removed.
1239
+ The 'Owner identifier' is then followed by a short content description
1240
+ and explanation as to why it's encrypted. After the
1241
+ 'content/explanation' description, the actual encrypted block follows.
1242
+
1243
+ When an ID3v2 decoder encounters a "CRM" frame, it should send the
1244
+ datablock to the 'plugin' with the corresponding 'owner identifier'
1245
+ and expect to receive either a datablock with one or several ID3v2
1246
+ frames after each other or an error. There may be more than one "CRM"
1247
+ frames in a tag, but only one with the same 'owner identifier'.
1248
+
1249
+ Encrypted meta frame "CRM"
1250
+ Frame size $xx xx xx
1251
+ Owner identifier <textstring> $00 (00)
1252
+ Content/explanation <textstring> $00 (00)
1253
+ Encrypted datablock <binary data>
1254
+
1255
+
1256
+ 4.21. Audio encryption
1257
+
1258
+ This frame indicates if the actual audio stream is encrypted, and by
1259
+ whom. Since standardisation of such encrypion scheme is beyond this
1260
+ document, all "CRA" frames begin with a terminated string with a
1261
+ URL containing an email address, or a link to a location where an
1262
+ email address can be found, that belongs to the organisation
1263
+ responsible for this specific encrypted audio file. Questions
1264
+ regarding the encrypted audio should be sent to the email address
1265
+ specified. If a $00 is found directly after the 'Frame size' and the
1266
+ audiofile indeed is encrypted, the whole file may be considered
1267
+ useless.
1268
+
1269
+ After the 'Owner identifier', a pointer to an unencrypted part of the
1270
+ audio can be specified. The 'Preview start' and 'Preview length' is
1271
+ described in frames. If no part is unencrypted, these fields should be
1272
+ left zeroed. After the 'preview length' field follows optionally a
1273
+ datablock required for decryption of the audio. There may be more than
1274
+ one "CRA" frames in a tag, but only one with the same 'Owner
1275
+ identifier'.
1276
+
1277
+ Audio encryption "CRA"
1278
+ Frame size $xx xx xx
1279
+ Owner identifier <textstring> $00 (00)
1280
+ Preview start $xx xx
1281
+ Preview length $xx xx
1282
+ Encryption info <binary data>
1283
+
1284
+
1285
+ 4.22. Linked information
1286
+
1287
+ To keep space waste as low as possible this frame may be used to link
1288
+ information from another ID3v2 tag that might reside in another audio
1289
+ file or alone in a binary file. It is recommended that this method is
1290
+ only used when the files are stored on a CD-ROM or other circumstances
1291
+ when the risk of file seperation is low. The frame contains a frame
1292
+ identifier, which is the frame that should be linked into this tag, a
1293
+ URL [URL] field, where a reference to the file where the frame is
1294
+ given, and additional ID data, if needed. Data should be retrieved
1295
+ from the first tag found in the file to which this link points. There
1296
+ may be more than one "LNK" frame in a tag, but only one with the same
1297
+ contents. A linked frame is to be considered as part of the tag and
1298
+ has the same restrictions as if it was a physical part of the tag
1299
+ (i.e. only one "REV" frame allowed, whether it's linked or not).
1300
+
1301
+ Linked information "LNK"
1302
+ Frame size $xx xx xx
1303
+ Frame identifier $xx xx xx
1304
+ URL <textstring> $00 (00)
1305
+ Additional ID data <textstring(s)>
1306
+
1307
+ Frames that may be linked and need no additional data are "IPL",
1308
+ "MCI", "ETC", "LLT", "STC", "RVA", "EQU", "REV", "BUF", the text
1309
+ information frames and the URL link frames.
1310
+
1311
+ The "TXX", "PIC", "GEO", "CRM" and "CRA" frames may be linked with the
1312
+ content descriptor as additional ID data.
1313
+
1314
+ The "COM", "SLT" and "ULT" frames may be linked with three bytes of
1315
+ language descriptor directly followed by a content descriptor as
1316
+ additional ID data.
1317
+
1318
+
1319
+ 5. The 'unsynchronisation scheme'
1320
+
1321
+ The only purpose of the 'unsychronisation scheme' is to make the ID3v2
1322
+ tag as compatible as possible with existing software. There is no use
1323
+ in 'unsynchronising' tags if the file is only to be processed by new
1324
+ software. Unsynchronisation may only be made with MPEG 2 layer I, II
1325
+ and III and MPEG 2.5 files.
1326
+
1327
+ Whenever a false synchronisation is found within the tag, one zeroed
1328
+ byte is inserted after the first false synchronisation byte. The
1329
+ format of a correct sync that should be altered by ID3 encoders is as
1330
+ follows:
1331
+
1332
+ %11111111 111xxxxx
1333
+
1334
+ And should be replaced with:
1335
+
1336
+ %11111111 00000000 111xxxxx
1337
+
1338
+ This has the side effect that all $FF 00 combinations have to be
1339
+ altered, so they won't be affected by the decoding process. Therefore
1340
+ all the $FF 00 combinations have to be replaced with the $FF 00 00
1341
+ combination during the unsynchonisation.
1342
+
1343
+ To indicate usage of the unsynchronisation, the first bit in 'ID3
1344
+ flags' should be set. This bit should only be set if the tag
1345
+ contained a, now corrected, false synchronisation. The bit should
1346
+ only be clear if the tag does not contain any false synchronisations.
1347
+
1348
+ Do bear in mind, that if a compression scheme is used by the encoder,
1349
+ the unsyncronisation scheme should be applied *afterwards*. When
1350
+ decoding a compressed, 'unsyncronised' file, the 'unsyncronisation
1351
+ scheme' should be parsed first, compression afterwards.
1352
+
1353
+
1354
+ 6. Copyright
1355
+
1356
+ Copyright (C) Martin Nilsson 1998. All Rights Reserved.
1357
+
1358
+ This document and translations of it may be copied and furnished to
1359
+ others, and derivative works that comment on or otherwise explain it
1360
+ or assist in its implementation may be prepared, copied, published
1361
+ and distributed, in whole or in part, without restriction of any
1362
+ kind, provided that a reference to this document is included on all
1363
+ such copies and derivative works. However, this document itself may
1364
+ not be modified in any way and reissued as the original document.
1365
+
1366
+ The limited permissions granted above are perpetual and will not be
1367
+ revoked.
1368
+
1369
+ This document and the information contained herein is provided on an
1370
+ "AS IS" basis and THE AUTHORS DISCLAIMS ALL WARRANTIES, EXPRESS OR
1371
+ IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE
1372
+ INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
1373
+ WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
1374
+
1375
+
1376
+ 7. References
1377
+
1378
+ [CDDB] Compact Disc Data Base
1379
+
1380
+ <url:http://www.cddb.com>
1381
+
1382
+ [ISO-639-2] ISO/FDIS 639-2.
1383
+ Codes for the representation of names of languages, Part 2: Alpha-3
1384
+ code. Technical committee / subcommittee: TC 37 / SC 2
1385
+
1386
+ [ISO-8859-1] ISO/IEC DIS 8859-1.
1387
+ 8-bit single-byte coded graphic character sets, Part 1: Latin
1388
+ alphabet No. 1. Technical committee / subcommittee: JTC 1 / SC 2
1389
+
1390
+ [ISRC] ISO 3901:1986
1391
+ International Standard Recording Code (ISRC).
1392
+ Technical committee / subcommittee: TC 46 / SC 9
1393
+
1394
+ [JFIF] JPEG File Interchange Format, version 1.02
1395
+
1396
+ <url:http://www.w3.org/Graphics/JPEG/jfif.txt>
1397
+
1398
+ [MIME] Freed, N. and N. Borenstein, "Multipurpose Internet Mail
1399
+ Extensions (MIME) Part One: Format of Internet Message Bodies",
1400
+ RFC 2045, November 1996.
1401
+
1402
+ <url:ftp://ftp.isi.edu/in-notes/rfc2045.txt>
1403
+
1404
+ [MPEG] ISO/IEC 11172-3:1993.
1405
+ Coding of moving pictures and associated audio for digital storage
1406
+ media at up to about 1,5 Mbit/s, Part 3: Audio.
1407
+ Technical committee / subcommittee: JTC 1 / SC 29
1408
+ and
1409
+ ISO/IEC 13818-3:1995
1410
+ Generic coding of moving pictures and associated audio information,
1411
+ Part 3: Audio.
1412
+ Technical committee / subcommittee: JTC 1 / SC 29
1413
+ and
1414
+ ISO/IEC DIS 13818-3
1415
+ Generic coding of moving pictures and associated audio information,
1416
+ Part 3: Audio (Revision of ISO/IEC 13818-3:1995)
1417
+
1418
+
1419
+ [PNG] Portable Network Graphics, version 1.0
1420
+
1421
+ <url:http://www.w3.org/TR/REC-png-multi.html>
1422
+
1423
+ [UNICODE] ISO/IEC 10646-1:1993.
1424
+ Universal Multiple-Octet Coded Character Set (UCS), Part 1:
1425
+ Architecture and Basic Multilingual Plane. Technical committee
1426
+ / subcommittee: JTC 1 / SC 2
1427
+
1428
+ <url:http://www.unicode.org>
1429
+
1430
+ [URL] T. Berners-Lee, L. Masinter & M. McCahill, "Uniform Resource
1431
+ Locators (URL).", RFC 1738, December 1994.
1432
+
1433
+ <url:ftp://ftp.isi.edu/in-notes/rfc1738.txt>
1434
+
1435
+
1436
+ 8. Appendix
1437
+
1438
+
1439
+ A. Appendix A - ID3-Tag Specification V1.1
1440
+
1441
+ ID3-Tag Specification V1.1 (12 dec 1997) by Michael Mutschler
1442
+ <amiga2@info2.rus.uni-stuttgart.de>, edited for space and clarity
1443
+ reasons.
1444
+
1445
+
1446
+ A.1. Overview
1447
+
1448
+
1449
+ The ID3-Tag is an information field for MPEG Layer 3 audio files.
1450
+ Since a standalone MP3 doesn't provide a method of storing other
1451
+ information than those directly needed for replay reasons, the
1452
+ ID3-tag was invented by Eric Kemp in 1996.
1453
+
1454
+ A revision from ID3v1 to ID3v1.1 was made by Michael Mutschler to
1455
+ support track number information is described in A.4.
1456
+
1457
+
1458
+ A.2. ID3v1 Implementation
1459
+
1460
+ The Information is stored in the last 128 bytes of an MP3. The Tag
1461
+ has got the following fields, and the offsets given here, are from
1462
+ 0-127.
1463
+
1464
+ Field Length Offsets
1465
+ Tag 3 0-2
1466
+ Songname 30 3-32
1467
+ Artist 30 33-62
1468
+ Album 30 63-92
1469
+ Year 4 93-96
1470
+ Comment 30 97-126
1471
+ Genre 1 127
1472
+
1473
+
1474
+ The string-fields contain ASCII-data, coded in ISO-Latin 1 codepage.
1475
+ Strings which are smaller than the field length are padded with zero-
1476
+ bytes.
1477
+
1478
+ Tag: The tag is valid if this field contains the string "TAG". This
1479
+ has to be uppercase!
1480
+
1481
+ Songname: This field contains the title of the MP3 (string as
1482
+ above).
1483
+
1484
+ Artist: This field contains the artist of the MP3 (string as above).
1485
+
1486
+ Album: this field contains the album where the MP3 comes from
1487
+ (string as above).
1488
+
1489
+ Year: this field contains the year when this song has originally
1490
+ been released (string as above).
1491
+
1492
+ Comment: this field contains a comment for the MP3 (string as
1493
+ above). Revision to this field has been made in ID3v1.1. See
1494
+ A.4.
1495
+
1496
+ Genre: this byte contains the offset of a genre in a predefined
1497
+ list the byte is treated as an unsigned byte. The offset is
1498
+ starting from 0. See A.3.
1499
+
1500
+
1501
+ A.3. Genre List
1502
+
1503
+ The following genres is defined in ID3v1
1504
+
1505
+ 0.Blues
1506
+ 1.Classic Rock
1507
+ 2.Country
1508
+ 3.Dance
1509
+ 4.Disco
1510
+ 5.Funk
1511
+ 6.Grunge
1512
+ 7.Hip-Hop
1513
+ 8.Jazz
1514
+ 9.Metal
1515
+ 10.New Age
1516
+ 11.Oldies
1517
+ 12.Other
1518
+ 13.Pop
1519
+ 14.R&B
1520
+ 15.Rap
1521
+ 16.Reggae
1522
+ 17.Rock
1523
+ 18.Techno
1524
+ 19.Industrial
1525
+ 20.Alternative
1526
+ 21.Ska
1527
+ 22.Death Metal
1528
+ 23.Pranks
1529
+ 24.Soundtrack
1530
+ 25.Euro-Techno
1531
+ 26.Ambient
1532
+ 27.Trip-Hop
1533
+ 28.Vocal
1534
+ 29.Jazz+Funk
1535
+ 30.Fusion
1536
+ 31.Trance
1537
+ 32.Classical
1538
+ 33.Instrumental
1539
+ 34.Acid
1540
+ 35.House
1541
+ 36.Game
1542
+ 37.Sound Clip
1543
+ 38.Gospel
1544
+ 39.Noise
1545
+ 40.AlternRock
1546
+ 41.Bass
1547
+ 42.Soul
1548
+ 43.Punk
1549
+ 44.Space
1550
+ 45.Meditative
1551
+ 46.Instrumental Pop
1552
+ 47.Instrumental Rock
1553
+ 48.Ethnic
1554
+ 49.Gothic
1555
+ 50.Darkwave
1556
+ 51.Techno-Industrial
1557
+ 52.Electronic
1558
+ 53.Pop-Folk
1559
+ 54.Eurodance
1560
+ 55.Dream
1561
+ 56.Southern Rock
1562
+ 57.Comedy
1563
+ 58.Cult
1564
+ 59.Gangsta
1565
+ 60.Top 40
1566
+ 61.Christian Rap
1567
+ 62.Pop/Funk
1568
+ 63.Jungle
1569
+ 64.Native American
1570
+ 65.Cabaret
1571
+ 66.New Wave
1572
+ 67.Psychadelic
1573
+ 68.Rave
1574
+ 69.Showtunes
1575
+ 70.Trailer
1576
+ 71.Lo-Fi
1577
+ 72.Tribal
1578
+ 73.Acid Punk
1579
+ 74.Acid Jazz
1580
+ 75.Polka
1581
+ 76.Retro
1582
+ 77.Musical
1583
+ 78.Rock & Roll
1584
+ 79.Hard Rock
1585
+
1586
+ The following genres are Winamp extensions
1587
+
1588
+ 80.Folk
1589
+ 81.Folk-Rock
1590
+ 82.National Folk
1591
+ 83.Swing
1592
+ 84.Fast Fusion
1593
+ 85.Bebob
1594
+ 86.Latin
1595
+ 87.Revival
1596
+ 88.Celtic
1597
+ 89.Bluegrass
1598
+ 90.Avantgarde
1599
+ 91.Gothic Rock
1600
+ 92.Progressive Rock
1601
+ 93.Psychedelic Rock
1602
+ 94.Symphonic Rock
1603
+ 95.Slow Rock
1604
+ 96.Big Band
1605
+ 97.Chorus
1606
+ 98.Easy Listening
1607
+ 99.Acoustic
1608
+ 100.Humour
1609
+ 101.Speech
1610
+ 102.Chanson
1611
+ 103.Opera
1612
+ 104.Chamber Music
1613
+ 105.Sonata
1614
+ 106.Symphony
1615
+ 107.Booty Bass
1616
+ 108.Primus
1617
+ 109.Porn Groove
1618
+ 110.Satire
1619
+ 111.Slow Jam
1620
+ 112.Club
1621
+ 113.Tango
1622
+ 114.Samba
1623
+ 115.Folklore
1624
+ 116.Ballad
1625
+ 117.Power Ballad
1626
+ 118.Rhythmic Soul
1627
+ 119.Freestyle
1628
+ 120.Duet
1629
+ 121.Punk Rock
1630
+ 122.Drum Solo
1631
+ 123.A capella
1632
+ 124.Euro-House
1633
+ 125.Dance Hall
1634
+
1635
+
1636
+ A.4. Track addition - ID3v1.1
1637
+
1638
+ In ID3v1.1, Michael Mutschler revised the specification of the
1639
+ comment field in order to implement the track number. The new format
1640
+ of the comment field is a 28 character string followed by a mandatory
1641
+ null ($00) character and the original album tracknumber stored as an
1642
+ unsigned byte-size integer. In such cases where the 29th byte is not
1643
+ the null character or when the 30th is a null character, the
1644
+ tracknumber is to be considered undefined.
1645
+
1646
+
1647
+ 9. Author's Address
1648
+
1649
+ Martin Nilsson
1650
+ Rydsv�gen 246 C. 30
1651
+ S-584 34 Link�ping
1652
+ Sweden
1653
+
1654
+ Email: nilsson at id3.org
1655
+
1656
+ Co-authors:
1657
+
1658
+ Johan Sundstr�m Email: johan at id3.org