4.2.1 TOFN Original filename
divided into the following classes. The flags may be set differently
MPG MPEG Audio
as flexible and expandable as possible.
recording. E.g. "4/9".
the introducuction of 'false syncsignals'.
allowed, with $0A only. Frames that allow different types of text
but only one with the same description.
the file should be a cover of a previously released song. The text
$05 is chord (e.g. "Bb F Fsus")
This frame contains a picture directly related to the audio file.
This frame is intended for music that comes from a CD, so that the CD
WCOM
URL
5. The 'unsynchronisation scheme'
27.Trip-Hop
Buffer size $xx xx xx
This frame allows synchronisation with key events in a song or sound.
field.
4) Add /D ID3LIB_LINKOPTION=3 to your project options (settings, C/C++ tab) (*note this is a different option than above)
are not subject to encryption or compression.
The limited permissions granted above are perpetual and will not be
4.10. Synchronised lyrics/text
syncsignal, no software will attempt to play the tag. If, for any
and "image/jpeg" are allowed. This format string is followed by the
URL containing an email address, or a link to a location where an
48.Ethnic
If a total revision of the ID3v2 tag should be needed, there is a
descriptor is entered, 'Content descriptor' is $00 (00) only.
4.2.1 TPUB Publisher
i - Compression
TSSE
/AA AAD
[JFIF] JPEG File Interchange Format, version 1.02
0 Frame should be preserved.
The use of linked files should however be used sparingly since there
their usage.
9. Author's Address
[ISRC] ISO 3901:1986
denoting where in the sound file it belongs. Each sync thus has the
padded in the beginning (highest bits) when 'bits used for volume
Owner identifier
16-bit unicode 2.0 (ISO/IEC 10646-1:1993, UCS-2). Unicode strings
60.Top 40
/A Analog transfer from media
is sync identifier.
4.Disco
The 'Official internet radio station homepage' contains a URL
does not fit in any other frame. It consists of a frame header
followed by an extended header. The extended header is described in
The second criterion has made a more noticeable impact on the design
21.Ska
the value $FF have the same function)
center channel is represented by bit 4 in the increase/decrease
3.2. ID3v2 extended header
Position $xx (xx ...)
36.Game
original recording, if for example the music in the file should be a
Some flags indicates that the frame header is extended with
[PNG] Portable Network Graphics, version 1.0
section 3.2.
format YYYYMMDD, describing for how long the price is valid. After
byte big, excluding the header.
4.16. General encapsulated object
4.2.1 TYER Year
Group dependent data
This frame allows synchronisation with key events in a song or sound.
each tag.
Time stamp format $xx
predefine an equalisation curve within the audio file. There may only
bytes for the 'lead out' making a maximum of 804 bytes. The offset to
various ways, such as musicians and technicians, the 'Text
4.13 EQUA Equalization
TYER
/9 9.5 cm/s
4.2.2. User defined text information frame
32.Classical
equalisation curve in the reading software should be interpolated
"http://www.id3.org/dummy/ufid.html" should be used for tests.
Name of seller
1 Frame should be discarded.
TRSO
If none you try work, revert to C)
or, if no other data follows, be completely omitted. There may only
bytes for the 'lead out' making a maximum of 804 bytes. The offset to
frame header:
Language $xx xx xx
114.Samba
Type of event $xx
type declared as picture type $01 and $02 respectively. There is the
byte order.
3) make your project dependend on id3lib, and make id3lib dependend on zlib
this is an ID3v2 tag, directly followed by the two version bytes. The
41.Bass
4.23. Terms of use
"http://www.id3.org/dummy/ufid.html" should be used for tests.
symbol' contains a value that associates the frame with this group
"1/2".
TSRC
Reverb feedback, right to left $xx
Position $xx (xx ...)
Language $xx xx xx
'Premix right to left' does the same thing, but right to left.
TKEY
8) dump id3lib.dll in your programs project dir.
/SECAM SECAM
$01 Unicode [UNICODE] character set is used => $00 00 is
35.House
Description
The 'Part of a set' frame is a numeric string that describes which
cover of a previously released song, was released. The field is
responsible for this specific encrypted audio file. Questions
counter reaches all one's, one byte is inserted in front of the
Bits for milliseconds dev. $xx
software with ID3v2.2.0 and below support should encounter version
With these frames dynamic data such as webpages with touring
103.Opera
MIME type
Unicode strings which are NULL-terminated may have the Unicode BOM
68.Rave
header is a descriptor of how much the 'frame counter' should
4.26. Encryption method registration
frame in each tag, but only one with the same content descriptor.
counter thus making the counter eight bits bigger. The counter must
Adjustment bits $xx
The 'Year' frame is a numeric string with a year of the recording.
includes the used audio encoder and its settings when the file was
behaviour from present software/hardware.
different programs may require different 'nodefaultlib' 's, or none at all, these worked for me.
long.
120.Duet
TPOS
its origin and contents. The information may be technical
possibility to put only a link to the image file by using the 'MIME
$0E During recording
[CDDB] Compact Disc Data Base
be one "MLLT" frame in each tag.
Abolute time means that every stamp contains the time from the
content types is defined in ID3v2 and is implemented in the same way
ID and additional data
Increment/decrement %x (MSB of the Frequency)
37.Sound Clip
Short content descrip.
TPE2
equalisation curve in the reading software should be interpolated
The 'Lead artist(s)/Lead performer(s)/Soloist(s)/Performing group' is
refinement, e.g. "(21)" or "(4)Eurodisco". Several references can be
stage or on the screen in sync with the audio. The header includes a
representation of the adjustment. This is normally $10 (16 bits) for
mean that the sound is public domain. Every time this field is
$01 is lyrics
WOAR
the player. All tempo descriptors should be sorted in chronological
4.21. Linked information
1.Classic Rock
exception of the "TXXX" frame. All the text information frames have
TEXT
"MCID", "ETCO", "MLLT", "SYTC", "RVAD", "EQUA", "RVRB", "RBUF", the
4.2.1 TRDA Recording dates
is used it should be $01. Strings dependent on encoding is
None.
Deviation in bytes %xxx....
[ISO-8859-1] ISO/IEC DIS 8859-1.
official wepage for the publisher.
Next follows a terminated string with the name of the seller followed
predefined media types found in the list below. References are made
Software that isn't told otherwise may safely remove such frames. The
copyright message, if the audio file also is copyrighted by the
Text encoding $xx
123.Acapella
with a "(" character it should be replaced with "((" in the same way
The equalisation bands should be ordered increasingly with reference
reason, coincidence make a syncsignal appear within the tag it will
TOAL
the file should be a cover of a previously released song. The
unknown flag is set in the first byte the frame may not be changed
/2 MPEG 1/2 layer II
"AS IS" basis and THE AUTHORS DISCLAIMS ALL WARRANTIES, EXPRESS OR
i.e. the beginning of the next frame. If this frame is used in the
4.2.1 TPE1 Lead performer(s)/Soloist(s)
of the text or lyrics in the recording. They are seperated with the
Language $xx xx xx
the event that the MIME media type name is omitted, "image/" will be
back channel and bit 3 for the left back channel.
Then for every reference the following data is included;
42.Soul
This flag tells the software what to do with this frame if it is
Contact URL
4.2.1. Text information frames - details
throughout the whole tag. Values below $80 are reserved. The 'Group
URL
'milliseconds between reference' and the reality. The number of bits
time. This frame requires a present and valid "TRCK" frame, even if
but if you got it working on Borland or other compilers, drop me a mail, or better, add a patch
Rating $xx
The 'Original album/movie/show title' frame is intended for the title
string containing the total numer of tracks/elements on the original
[ISO-8859-1] ISO/IEC DIS 8859-1.
is used it should be $01. Strings dependent on encoding is
[JFIF] JPEG File Interchange Format, version 1.02
URL containing an email address, or a link to a location where an
$01 Unicode [UNICODE] character set is used => $00 00 is
The absence of this frame means only that the copyright information
descriptor is entered, 'Content descriptor' is $00 (00) only.
The header is:
REE Reel
$04 is events (e.g. "Don Quijote enters the stage")
To increase performance and accuracy of jumps within a MPEG [MPEG]
Terminating the start events such as "intro start" is not required.
Text encoding $xx
Size $xx xx xx xx
useless.
Bits for bytes deviation $xx
$49 44 33 yy yy xx zz zz zz zz
4.2.1 TCOP Copyright message
27.Trip-Hop
file or alone in a binary file. It is recommended that this method is
Text encoding $xx
3.3.2. Default flags
Text encoding $xx
/AA AAD
channel and bit 1 is used to indicate the left channel. 1 is
not the same as a music-free time period. $01 is used to indicate one
kinds. Reverb left/right is the delay between every bounce in ms.
as a numeric string.
28.Vocal
mainpart of the audio. The BPM is an integer and represented as a
The 'Time stamp' is set to zero if directly at the beginning of the
$04 is events (e.g. "Don Quijote enters the stage")
without parentheses. If this frame is not present audio type is
and distributed, in whole or in part, without restriction of any
$13 refrain end
space character (making five characters), is intended for the
interpretations of another existing piece.
Size of padding $xx xx xx xx
if found more suitable by the software.
publisher.
representation of the adjustment. This is normally $10 (16 bits) for
reference points out the second frame, the 2nd reference the 4th
5.Funk
LD Laserdisc
In the frame header the size descriptor is followed by two flags
42.Soul
section 5.
$09 theme start
frame consists of an 'Owner identifier' string and the binary data.
milliseconds deviation', must be a multiple of four. There may only
The 'Publishers official webpage' frame is a URL pointing at the
This frame contains a picture directly related to the audio file.
$01 Standard CD album with other songs
$15-$DF reserved for future use
Terminating the start events such as "intro start" is not required.
4.2.1 TBPM BPM (beats per minute)
4.3.1 WOAS Official audio source webpage
4.13 EQUA Equalization
Coding of moving pictures and associated audio for digital storage
described.
The 'Copyright message' frame, which must begin with a year and a
/III Type III cassette (ferric chrome)
numerical value where "." is used as decimal seperator. In the price
"1/2".
DIG Other digital media
Document: id3v2.3.0.txt 3rd February 1999
0 Frame is not compressed.
'Premix right to left' does the same thing, but right to left.
picture is to attach.
Peak volume left $xx xx (xx ...)
The text that follows the frame header differs from that of the
indicated email address. The tag may contain more than one "PRIV"
WOAR
4.3.2. User defined URL link frame
but may be empty. There may be several pictures attached to one file,
A tag must contain at least one frame. A frame must be at least 1
9) distribute your program including id3lib.dll
described.
4.3.1 WOAS Official audio source webpage
which uses the allready compiled dll.
audio file, frames with timecodes in different locations in the file
with the actual comment as a text string. Newline characters are
4.17 PCNT Play counter
the beat description occurs. There may only be one "SYTC" frame in
4.24. Ownership frame
Value
numeric string containing the total number of parts in the set. E.g.
the tag. There may only be one URL [URL] link frame of its kind in an
without parentheses. If this frame is not present audio type is
followed by the actual URL. The URL is always encoded with ISO-8859-1
location where an email address can be found, that belongs to the
4.3.1 WCOM Commercial information
maximum size described in 'Buffer size' may occur in the audiostream.
string several prices may be concatenated, seperated by a "/"
4.11. Comments
All numeric strings and URLs [URL] are always encoded as ISO-8859-1.
header in the same order as the flags indicating the additions. I.e.
How to start
retrieved from the first tag found in the file to which this link
$09 Conductor
$15-$DF reserved for future use
Description
This has the side effect that all $FF 00 combinations have to be
the process of paying for this file.
involvement and so on. There may only be one "IPLS" frame in each
followed by a one byte 'received as' field. It describes how the
frame ID, size and encoding fields, with a 'price payed' field. The
Newline ($0A) characters are allowed in all "SYLT" frames and should
/BETA BETAMAX
additional ID data.
cover of a previously released song, was released. The field is
containing an email address, or a link to a location where an email
allowed, with $0A only. Frames that allow different types of text
$14 theme end
reason, coincidence make a syncsignal appear within the tag it will
73.Acid Punk
each in their individual "APIC" frame, but only one with the same
is an identifier that explains the frames' format and content, and a
information like artist, album and more. There may only be one text
flags are set that might mean that the tag is not readable for a
Description
"/" character.
as the numerig content types, e.g. "(RX)".
ended with a ")" character. This is optionally followed by a
publisher.
CD CD
Content type: $00 is other
or, if signed, as proof. Note that the "USER" and "TOWN" frames are
The private data
field. If Peakvolume is not known these fields could be left zeroed
A tag must contain at least one frame. A frame must be at least 1
consists of a binary dump of the Table Of Contents, TOC, from the CD,
its origin and contents. The information may be technical
bits) for MPEG 2 layer I, II and III [MPEG] and MPEG 2.5. This value
The 'Year' frame is a numeric string with a year of the recording.
different programs may require different 'nodefaultlib' 's, or none at all, these worked for me.
kinds of alterations, including adding more padding and reordering
69.Showtunes
TOLY
3. Preserved if tag is altered, discarded if file is altered.
48.Ethnic
$0B key change
The 'Original filename' frame contains the preferred filename for the
implied. The "image/png" [PNG] or "image/jpeg" [JFIF] picture format
4.18. Popularimeter
without the bit cleared. If an unknown flag is set in the second byte
4.2.1. Text information frames - details
3.3.1. Frame header flags
predefine an equalisation curve within the audio file. There may only
grouping should be sent to the indicated email address. The 'Group
/I ISDN
The equalisation bands should be ordered increasingly with reference
This has the side effect that all $FF 00 combinations have to be
the file should be a cover of a previously released song. The text
"TXXX" frame in each tag, but only one with the same description.
PCM Pulse Code Modulated audio
the beat description occurs. There may only be one "SYTC" frame in
Counter $xx xx xx xx (xx ...)
/LW LW
$08 interlude start
The 'Original lyricist(s)/text writer(s)' frame is intended for the
includes the used audio encoder and its settings when the file was
are not subject to encryption or compression.
Email to user
information, such as title, performer, copyright etc.
TLEN
Reverb bounces, right $xx
frame header. Every frame with the same group identifier belongs
The 'bits used for volume description' field is normally $10 (16
4.28. Private frame
The 'adjustment bits' field defines the number of bits used for
represented as
Document: id3v2.3.0.txt 3rd February 1999
See section 3.3.1, flag j for more information.
here: http://sourceforge.net/tracker/?group_id=979&atid=300979 with the (e.g.) borland project files.
Encoding: $00 ISO-8859-1 [ISO-8859-1] character set is used => $00
79.Hard Rock
81.Folk-Rock
byteorder in multibyte numbers is most significant byte first (e.g.
1 Frame is encrypted.
string according to encoding> if newlines are allowed. Any empty
Reverb feedback, right to left $xx
numeric string containing the total number of parts in the set. E.g.
the same content.
4.14 RVRB Reverb
1.Classic Rock
The second criterion has made a more noticeable impact on the design
4.2.1 TSIZ Size
(representing up to 256MB) are used in the size description to avoid
organisation that encoded the audio file. This field may contain a
4.17 PCNT Play counter
106.Symphony
description' is not a multiple of eight.
same symbol and only one containing the same owner identifier. The
of language descriptor directly followed by a content descriptor as
4. Declared ID3v2 frames
If the last byte in the tag is $FF, and there is a need to eliminate
With these frames dynamic data such as webpages with touring
16.Reggae
(C) is one character showing a C in a circle.
used for the main artist(s). They are seperated with the "/"
109.Porn Groove
for this specific encryption method. Questions regarding the
with unknown content. %x is used to indicate a bit with unknown
4.16 GEOB General encapsulated object
2. Conventions in this document
giving a frequency range of 0 - 32767Hz:
This frame contains the lyrics of the song or a text transcription of
The 'Internet radio station owner' frame contains the name of the
and free for everyone to use, without the need to set the
There is no fixed order of the frames' appearance in the tag,
This is another way of incorporating the words, said or sung lyrics,
different programs may require different 'nodefaultlib' 's, or none at all, these worked for me.
frame have been made in a later version of the ID3v2 standard. This
30.Fusion
This flag tells the software what to do with this frame if it is
4.2.1 TPE2 Band/orchestra/accompaniment
Description
by new software. Unsynchronisation may only be made with MPEG 2 layer
Distribution of this document is unlimited.
TRSO
content. The most significant bit (MSB) of a byte is called 'bit 7'
The second bit (bit 6) indicates whether or not the header is
4.7. MPEG location lookup table
currently only three flags are used.
but it's an easier solution than if one tries to achieve the same
"OWNE" frame in a tag.
The 'Date' frame is a numeric string in the DDMM format containing
TV Television
its origin and contents. The information may be technical
e.g. "(MC) with four channels". If a text refinement should begin
Size of padding $xx xx xx xx
information about encryption method registration.
Text encoding $xx
The three byte language field is used to describe the language of the
0 Frame should be preserved.
with unknown content. %x is used to indicate a bit with unknown
The equalisation bands should be ordered increasingly with reference
Architecture and Basic Multilingual Plane.
$0D momentary unwanted noise (Snap, Crackle & Pop)
the audio is MPEG encoded. If the position of the next tag is known,
Time stamp format $xx
/3 mode 3, 32 kHz/12 bits, nonlinear, low speed
83.Swing
Time stamp format $xx
99.Acoustic
/FM FM
$01 Absolute time, 32 bit sized, using MPEG [MPEG] frames as unit
$0A Band/Orchestra
in a similar way to the predefined types in the "TMED" frame, but
11.Oldies
/I Type I cassette (ferric/normal)
performer(s) of the original recording, if for example the music in
c - Experimental indicator
significance concerning the recognition of the file. An example of
format YYYYMMDD, describing for how long the price is valid. After
URL
The bitorder in ID3v2 is most significant bit first (MSB). The
Filename
part of the tag and has the same restrictions as if it was a physical
throughout the whole tag. Values below $80 are reserved. The 'Group
3.3.1. Frame header flags
Where time stamp format is:
40.AlternRock
appears in a file. Numbers preceded with $ are hexadecimal and
location where an email address can be found, that belongs to the
/AAC Advanced audio compression
in the audio file as text, this time, however, in sync with the
may be several "ENCR" frames in a tag but only one containing the
Content type $xx
the software that encounters them. At the start of every frame there
followed by a termination ($00 (00)) all the following information
center channel is represented by bit 4 in the increase/decrease
break something, e.g. a signature. If the contents are changed,
containing an email address, or a link to a location where an email
64.Native American
file or alone in a binary file. It is recommended that this method is
[ISO-8859-1] characters in the range $20 - $FF. Such strings are
The 'bits used for volume description' field is normally $10 (16
4.6. Event timing codes
database that may contain more information relevant to the content.
might be useful. The ID3v2 frame includes references that the
Before you compile, you'll need to rename id3lib/config.h.win32 to id3lib/config.h
This is simply a counter of the number of times a file has been
containing an email address, or a link to a location where an email
$08 Non-musical merchandise
no use in 'unsynchronising' tags if the file is only to be processed
should be ignored and not be displayed. All text frame identifiers
frame header. Every frame with the same group identifier belongs
3. ID3v2 overview
The 'Time stamp' is set to zero if directly at the beginning of the
may be several "ENCR" frames in a tag but only one containing the
performers are seperated with the "/" character.
URL
/1 MPEG 1/2 layer I
be one "MLLT" frame in each tag.
which picture format is used. In the event that the MIME media type
Information
/4 mode 4, 32 kHz/12 bits, 4 channels
TT Turntable records
120.Duet
4) Add /D ID3LIB_LINKOPTION=3 to your project options (settings, C/C++ tab) (*note this is a different option than above)
Description
the frame.
The 'Official artist/performer webpage' frame is a URL pointing at
Locators (URL).", RFC 1738, December 1994.
Picture type $xx
live at Wembley").
first byte has the value $FF, one more byte follows, which is added
music in the file should be a cover of a previously released song.
4.2.1 TOLY Original lyricist(s)/text writer(s)
/FM FM
TRDA
numbers preceded with % are binary. $xx is used to indicate a byte
grouping should be sent to the indicated email address. The 'Group
DAT DAT
specified in this document, that indicates that additions to the
92.Progressive Rock
allowed in the comment text string. There may be more than one
frame, if present, to skip initial silence and silence at the end of
These are the directories you'll be needing:
chronological order. The type of event is as follows:
email address can be found, that belongs to the organisation
follows.
information should be ignored and not be displayed. All URL link
represented as $00 00 02 01.
4.27 GRID Group identification registration
The second bit (bit 6) indicates whether or not the header is
/A Analog transfer from media
4.8. Synced tempo codes
[ISO-8859-1] ISO/IEC DIS 8859-1.
information, such as title, performer, copyright etc.
unsychronisation, including padding, excluding the header but not
but if you got it working on Borland or other compilers, drop me a mail, or better, add a patch
x - CRC data present
The 'Recording dates' frame is a intended to be used as complement to
the encoder) is a null terminated string followed by a time stamp
4.7 MLLT MPEG location lookup table
recommended by the server using this frame. If the 'embedded info
4.5. Music CD Identifier
The 'Interpreted, remixed, or otherwise modified by' frame contains
URL
the tag. There may only be one URL [URL] link frame of its kind in an
subsequent frequencies. A frequency should only be described once in
described in frames. If no part is unencrypted, these fields should
/2 MPEG 1/2 layer II
decoding a compressed, 'unsynchronised' file, the 'unsynchronisation
4.3.1. URL link frames - details
The rest of the frames.
4.19. Recommended buffer size
1) Rename config.h.win32 to config.h
divided into the following classes. The flags may be set differently
"/" character.
5. The 'unsynchronisation scheme'
The 'adjustment bits' field defines the number of bits used for
/33 33.33 rpm
Bytes between reference $xx xx xx
$0F During performance
here: http://sourceforge.net/tracker/?group_id=979&atid=300979 with the (e.g.) borland project files.
$FD audio end (start of silence)
96.Big Band
Where time stamp format is:
$01 Absolute time, 32 bit sized, using MPEG [MPEG] frames as unit
increment and 0 is decrement.
/A Analog transfer from media
/9 9.5 cm/s
44.Space
not be modified in any way and reissued as the original document.
82.National Folk
To identify with which method a frame has been encrypted the
58.Cult
$0B key change
The following type and refinements are defined:
content. The most significant bit (MSB) of a byte is called 'bit 7'
the beat description occurs. There may only be one "SYTC" frame in
(C) is one character showing a C in a circle.
35.House
The 'Lyricist(s)/Text writer(s)' frame is intended for the writer(s)
The 'Content group description' frame is used if the sound belongs to
4.3.1 WCOM Commercial information
The first criterion is met by the simple fact that the MPEG [MPEG]
People list strings
4.2.1 TFLT File type
the transaction, encoded according to ISO 4217 [ISO-4217] alphabetic
The first one (id3lib/prj) creates the standard dll (no COM interface)
79.Hard Rock
The absence of this frame means only that the copyright information
TEXT
type' "-->" and having a complete URL [URL] instead of picture data.
The ID3v2 tag header, which should be the first information in the
transmission or coding problems resulting in interruptions in the
as flexible and expandable as possible.
Terminated strings are terminated with $00 if encoded with ISO-8859-1
in combination with the "TYER" frame.
Seller logo
4.27. Group identification registration
or assist in its implementation may be prepared, copied, published
Compiling on win32:
without the bit cleared. If an unknown flag is set in the second byte
file, is 10 bytes as follows:
byte order.
as the numerig content types, e.g. "(RX)".
frame is intended to be read only. Changing the contents might
The 'Year' frame is a numeric string with a year of the recording.
The "COMM", "SYLT" and "USLT" frames may be linked with three bytes
official wepage for the publisher.
The frame ID made out of the characters capital A-Z and 0-9.
The 'Publishers official webpage' frame is a URL pointing at the
all the $FF 00 combinations have to be replaced with the $FF 00 00
refinement, e.g. "(21)" or "(4)Eurodisco". Several references can be
The text that follows the frame header differs from that of the
is reflected by the revision number in the header of the tag.
excluding the extended header (total tag size - 10). Only 28 bits
120.Duet
Email to user
Text encoding $xx
for more information.
encoder.
/DD DDD
significant bit (bit 7) is set to zero in every byte, making a total
$12345678 would be encoded $12 34 56 78).
the signature, the bit should be cleared.
/2 mode 2, 32 kHz/16 bits, linear
[ISO-639-2] ISO/FDIS 639-2.
xx "glan" $00 xx xx "ces" $00 xx xx
k - Grouping identity
123.Acapella
/LW LW
TDAT
Content description
Whenever a false synchronisation is found within the tag, one zeroed
be taken care of by the 'unsynchronisation scheme' described in
TPE2
4.2.2. User defined text information frame
3) make your project dependend on id3lib, and make id3lib dependend on zlib
The 'Subtitle/Description refinement' frame is used for information
playlist that features better audiofiles more often than others or it
string containing the total numer of tracks/elements on the original
The bitorder in ID3v2 is most significant bit first (MSB). The
A tag must contain at least one frame. A frame must be at least 1
attributes of the tag. These attributes are currently defined as
to the existing frame, after the center channel. The bass channel is
The 'Content type', which previously was stored as a one byte numeric
In the increment/decrement field bit 0 is used to indicate the right
The 'Playlist delay' defines the numbers of milliseconds of silence
Price payed
Position $xx (xx ...)
'Premix right to left' does the same thing, but right to left.
organisation responsible for this grouping. Questions regarding the
[ID3v2] Martin Nilsson, "ID3v2 informal standard".
encoder.
involvement and so on. There may only be one "IPLS" frame in each
The 'Original filename' frame contains the preferred filename for the
tag.
Where time stamp format is:
A. Appendix A - Genre List from ID3v1
Picture data
$08 Artist/performer
name is omitted, "image/" will be implied. Currently only "image/png"
content. The most significant bit (MSB) of a byte is called 'bit 7'
/A Analog transfer from media
their usage.
/AD ADD
information frame of its kind in an tag. If the textstring is
be used after every entry (name, event etc.) in a frame with the
want to synchronise your music to something, like setting of an
different programs may require different 'nodefaultlib' 's, or none at all, these worked for me.
Content descriptor
MIME type
4.2.1 TPUB Publisher
padding, i.e. the frames and only the frames.
In the examples, text within "" is a text string exactly as it
'status messages' and the second byte is for encoding purposes. If an
4.19. Recommended buffer size
/3 mode 3, 32 kHz/12 bits, nonlinear, low speed
52.Electronic
In this frame any type of file can be encapsulated. After the header,
The third one is not too much tested, it was created outside this project but
long.
$01 Unicode [UNICODE] character set is used => $00 00 is
subsequent frequencies. A frequency should only be described once in
implied. The "image/png" [PNG] or "image/jpeg" [JFIF] picture format
licensee of the file and it's contents.
WCOM
Content descriptor
constructed by one three character currency code, encoded according
0 Frame should be preserved.
VQF Transform-domain Weighted Interleave Vector Quantization
4.2.1 TIT3 Subtitle/Description refinement
3.3.1. Frame header flags
The equalisation bands should be ordered increasingly with reference
120.Duet
$03 File over the Internet
34.Acid
7.Hip-Hop
4.2.1 TPE1 Lead performer(s)/Soloist(s)
i.e. the beginning of the next frame. If this frame is used in the
for more information.
How to start
c - Experimental indicator
string, followed by the actual string. There may be more than one
allowed, with $0A only. Frames that allow different types of text
in a tag, but only one with the same 'Owner identifier'.
beginning of a file the value is always 0. There may only be one
B)***Your project wants to link id3lib static, and has mfc linked dynamic or has no MFC:
byteorder in multibyte numbers is most significant byte first (e.g.
header in the same order as the flags indicating the additions. I.e.
represented by bit 5 in the increase/decrease field.
a certain number of bits, as defined in 'bits for milliseconds
information, such as equalisation curves, as well as related meta
/I Type I cassette (ferric/normal)
The version is followed by one the ID3v2 flags field, of which
significance concerning the recognition of the file. An example of
54.Eurodance
a content descriptor. The body consists of the actual text. The
circumstances when the risk of file seperation is low. The frame
4.2.1 TEXT Lyricist/Text writer
here: http://sourceforge.net/tracker/?group_id=979&atid=300979 with the (e.g.) borland project files.
same language and content descriptor.
encoded with MPEG-1/2 layer I, MPEG-1/2 layer II, MPEG-1/2 layer III
It is permitted to include padding after all the final frame (at the
implementors could have a set standard before a formal standard is
begin with "T". Only text frame identifiers begin with "T", with the
80.Folk
as the numerig content types, e.g. "(RX)".
$14 theme end
additional information. This information will be added to the frame
Frame identifier $xx xx xx
/SECAM SECAM
4.26. Encryption method registration
"Weather - Hurricane").
ID3v2 version $03 00
information about encryption method registration.
four bytes absolute CD-frame address per track, and not with absolute
81.Folk-Rock
must begin with the Unicode BOM ($FF FE or $FE FF) to identify the
in the frame header size but are included in the 'frame size' field,
byte is inserted after the first false synchronisation byte. The
How to start
4.15 APIC Attached picture
header in the same order as the flags indicating the additions. I.e.
(debug) /nodefaultlib:"MSVCRTD" or(release) /nodefaultlib:"MSVCRT"
69.Showtunes
A tag must contain at least one frame. A frame must be at least 1
information like artist, album and more. There may only be one text
4.3.1. URL link frames - details
4.2.1 TLAN Language(s)
frames begin with a null-terminated string with a URL [URL]
of information in the tag. The tag consists of a header, frames and
the event that the MIME media type name is omitted, "image/" will be
the software that encounters them. At the start of every frame there
(debug) /nodefaultlib:"libcmtd" or(release) /nodefaultlib:"libcmt"
TOPE
4.23. Terms of use
4.18 POPM Popularimeter
7) Try to compile, and see if you need any of the following:
In the examples, text within "" is a text string exactly as it
Owner identifier
B)***Your project wants to link id3lib static, and has mfc linked dynamic or has no MFC:
Each reference consists of two parts; a certain number of bits, as
Frames that may be linked and need no additional data are "IPLS",
pointing at the homepage of the internet radio station.
4.18 POPM Popularimeter
the audio is MPEG encoded. If the position of the next tag is known,
$02 Absolute time, 32 bit sized, using milliseconds as unit
beginning of a file the value is always 0. There may only be one
The 'File owner/licensee' frame contains the name of the owner or
4.1. Unique file identifier
(debug) /nodefaultlib:"MSVCRTD" or(release) /nodefaultlib:"MSVCRT"
to the first giving a range from 2 - 510 BPM, since $00 and $01 is
size excluding frame header (frame size - 10).
the unsynchronisation scheme should be applied *afterwards*. When
The 'bits used for volume description' field is normally $10 (16
7. References
$15-$DF reserved for future use
17.Rock
Owner identifier
consists of a description of the string, represented as a terminated
4.27. Group identification registration
c - Read only
by new software. Unsynchronisation may only be made with MPEG 2 layer
TDLY
The purpose of this frame is to specify how good an audio file is.
indicates usage.
a digital signature. There may be several "GRID" frames in a tag but
WORS
The extended header contains information that is not vital to the
$03 File over the Internet
"AS IS" basis and THE AUTHORS DISCLAIMS ALL WARRANTIES, EXPRESS OR
5. The 'unsynchronisation scheme'
Preview length $xx xx
a certain number of bits, as defined in 'bits for milliseconds
apply when the audio is completely replaced with other audio data.
containing an email address, or a link to a location where an email
must begin with the Unicode BOM ($FF FE or $FE FF) to identify the
In the examples, text within "" is a text string exactly as it
is used it should be $01. Strings dependent on encoding is
98.Easy Listening
To increase performance and accuracy of jumps within a MPEG [MPEG]
In the frame header the size descriptor is followed by two flags
4.24 OWNE Ownership frame
significance concerning the recognition of the file. An example of
followed by encoding, language and content descriptors and is ended
followed by a Unicode NULL ($FF FE 00 00 or $FE FF 00 00).
to the existing frame, after the left and right back channels. The
WOAF
Bits for bytes deviation $xx
$09 theme start
There is no fixed order of the frames' appearance in the tag,
and MPEG-2.5, but may work with other types of encoded audio.
TIT3
described in frames. If no part is unencrypted, these fields should
$00.
The 'Length' frame contains the length of the audiofile in
111.Slow Jam
TYER
encryption method should be sent to the indicated email address. The
/I Type I cassette (ferric/normal)
number of "PRIV" frames as low as possible.
4.14. Reverb
4.1 UFID Unique file identifier
valid for new line characters. A syllable followed by a comma should
33.Instrumental
[URL] T. Berners-Lee, L. Masinter & M. McCahill, "Uniform Resource
number of "PRIV" frames as low as possible.
correct parsing of the tag information, hence the extended header is
For a more accurate description of the tempo of a musical piece this
Filename
includes the used audio encoder and its settings when the file was
audio stream he picked up; in effect, it states the time offset of
"TXXX" frame in each tag, but only one with the same description.
/I
contains a frame identifier, which is the frame that should be linked
5) Add the following include dirs to your program:
the frame is given, and additional ID data, if needed. Data should be
%x0000000 00000000
each tag.
'lock on to' the audio. Since the ID3v2 tag doesn't contain a valid
either used or reserved for future use.
43.Punk
The second bit (bit 6) indicates whether or not the header is
comment frame in each tag, but only one with the same language and
4.25. Commercial frame
4.10. Synchronised lyrics/text
are not subject to encryption or compression.
to the same group.
[ISO-8859-1]. There may be more than one "WXXX" frame in each tag,
Also in there is a file called Id3lib.pas which has the interface to the dll
4.2. Text information frames
Software that isn't told otherwise may safely remove such frames. The
Reverb feedback, right to right $xx
MIME type
Text encoding $xx
'offset to next tag' may be used. The offset is calculated from the
but it's an easier solution than if one tries to achieve the same
frames or enlarge existing frames within the tag without having to
Filename
8. Appendix
frame ID, size and encoding fields, with a 'price payed' field. The
44.Space
2) include prj/id3lib.dsp and zlib/prj/zlib.dsp to your workspace (*note this is a different id3lib than above)
but other types may be used, not for these types though. This is used
beginning of the file.
no use in 'unsynchronising' tags if the file is only to be processed
unsychronisation, including padding, excluding the header but not
102.Chanson
but other types may be used, not for these types though. This is used
4.13 EQUA Equalization
beginning of the file.
The 'Owner identifier' is a null-terminated string with a URL [URL]
37.Sound Clip
CD CD
2. Conventions in this document
(debug) /nodefaultlib:"msvcprtd" or(release) /nodefaultlib:"msvcprt"
$09 theme start
19.Industrial
Many interesting applications could be found to this frame such as a
must begin with the Unicode BOM ($FF FE or $FE FF) to identify the
Text encoding $xx
This flag tells the software what to do with this frame if it is
Since standardisation of such a database is beyond this document, all
4.28. Private frame
87.Revival
is 0%, $FF is 100%. If this value were $7F, there would be 50% volume
frame header. Every frame with the same group identifier belongs
grouping should be sent to the indicated email address. The 'Group
Time stamp format $xx
The 'Internet radio station owner' frame contains the name of the
picture is to attach.
4.8 SYTC Synchronized tempo codes
implied. The "image/png" [PNG] or "image/jpeg" [JFIF] picture format
the following format:
'lock on to' the audio. Since the ID3v2 tag doesn't contain a valid
email address can be found, that belongs to the organisation
4.3.2. User defined URL link frame
/AA AAD
Language $xx xx xx
Preview start $xx xx
Reverb feedback, left to left $xx
TPE3
information blocks, called frames, whose format need not be known to
(representing up to 256MB) are used in the size description to avoid
4.3.1 WOAR Official artist/performer webpage
Yet another subjective one. You may here adjust echoes of different
wanted it may be omitted. When the counter reaches all one's, one
in a similar way to the predefined types in the "TMED" frame, but
37.Sound Clip
purpose of this padding is to allow for adding a few additional
although it is desired that the frames are arranged in order of
TKEY
3. ID3v2 overview
4.2.1 TRSN Internet radio station name
Relative volume change, center $xx xx (xx ...)
characters 0-9 only.
The absence of this frame means only that the copyright information
type' "-->" and having a complete URL [URL] instead of picture data.
Language $xx xx xx
Identifier
or assist in its implementation may be prepared, copied, published
considered as an update of the previous one. E.g. if there is a
62.Pop/Funk
identifier'.
eight bits bigger in the same away as the play counter ("PCNT").
a - Unsynchronisation
References to the ID3v1 genres can be made by, as first byte, enter
4.2.1 TPUB Publisher
should be added.
13.Pop
which time stamp format should be used. Then follows one or more
containing an email address, or a link to a location where an email
is an identifier that explains the frames' format and content, and a
revision will never be $FF.
Copyright (C) Martin Nilsson 1998. All Rights Reserved.
Locators (URL).", RFC 1738, December 1994.
the unsynchronisation scheme should be applied *afterwards*. When
$FF one more byte of events follows (all the following bytes with
/76 76.59 rpm
TIT3
TV Television
if found more suitable by the software.
4.11. Comments
[ISRC] ISO 3901:1986
The 'Content type', which previously was stored as a one byte numeric
document, all "AENC" frames begin with a terminated string with a
description' is not a multiple of eight.
4.28. Private frame
7. References
Encapsulated object
The increment/decrement bit is 1 for increment and 0 for decrement.
size descriptor that allows software to skip unknown frames.
Extensions (MIME) Part One: Format of Internet Message Bodies",
3) make your project dependend on id3lib, and make id3lib dependend on zlib
and
117.Power Ballad
If the center channel adjustment is present the following is appended
4.6. Event timing codes
8. Appendix
4.19. Recommended buffer size
character is forbidden. In ISO-8859-1 a new line is represented, when
119.Freestyle
be described with the 'Peak volume right' and 'Peak volume left'
address can be found, that belongs to the organisation responsible
the frames and the headers, in other words the padding. The extended
[ISO-8859-1] characters in the range $20 - $FF. Such strings are
'Owner identifier' must be non-empty (more than just a termination).
/SVHS S-VHS
TOPE
each tag.
103.Opera
by new software. Unsynchronisation may only be made with MPEG 2 layer
$0D momentary unwanted noise (Snap, Crackle & Pop)
99.Acoustic
Text encoding $xx
the email address to the user, one rating byte and a four byte play
24.Soundtrack
4.12. Relative volume adjustment
the first frame in the stream. The frame layout is:
can figure out any genre)" or "(55)((I think...)". The following new
wanted it may be omitted. When the counter reaches all one's, one
MD MiniDisc
33.Instrumental
audio file, frames with timecodes in different locations in the file
textstring is followed by a termination ($00 (00)) all the following
original recording, if for example the music in the file should be a
/I
Relative volume change, right $xx xx (xx ...)
in the audio file as text, this time, however, in sync with the
numerical string.
section 5.
4.11. Comments
10.New Age
/9 9.5 cm/s
follows:
4.2.1 TSIZ Size
The actual text
30.Fusion
experimental stage.
URL
$FD audio end (start of silence)
with information such as where the album can be bought. There may be
/5 mode 5, 44.1 kHz/16 bits, linear
TMED
result with several frames. The frame begins, after the frame ID,
Time stamp format is:
$0C Lyricist/text writer
7.Hip-Hop
occurring in front of the first syllable of a new word. This is also
50.Darkwave
57.Comedy
with other frames. If set a group identifier byte is added to the
the date for the recording. This field is always four characters
44.Space
between every song in a playlist. The player should use the "ETC"
'recommended buffer size' frame should be included in every tag.
Type of event $xx
different programs may require different 'nodefaultlib' 's, or none at all, these worked for me.
last thing is the ability to include a company logotype. The first of
18.Techno
4.11. Comments
that its program uses and does not fit into the other frames. The
Time stamp $xx (xx ...)
TCON
be taken care of by the 'unsynchronisation scheme' described in
publisher.
Picture type: $00 Other
This frames is always four characters long (until the year 10000).
4.19 RBUF Recommended buffer size
header is a descriptor of how much the 'frame counter' should
0 Frame is not compressed.
The 'Official audio file webpage' frame is a URL pointing at a file
4.21 AENC Audio encryption
Abstract
consists of a binary dump of the Table Of Contents, TOC, from the CD,
The 'Owner identifier' is then followed by the actual identifier,
The 'Internet radio station name' frame contains the name of the
unsynchronisation on the data between the extended header and the
bundling all needed information. That makes this frame rather complex
TIME
increase for every reference. If this value is two then the first
writers are seperated with the "/" character.
chronological order. The type of event is as follows:
This is another way of incorporating the words, said or sung lyrics,
names of those involved, and how they were involved. The body simply
tag, except when stated otherwise in the frame description. If the
2) include libprj/id3lib.dsp and zlib/prj/zlib.dsp to your workspace
defined in 'bits for bytes deviation', that describes the difference
format of a correct sync that should be altered by ID3 encoders is as
$0A Band/Orchestra
followed by the actual URL. The URL is always encoded with ISO-8859-1
in a tag if the audio contains more than one performer, but not with
character is forbidden. In ISO-8859-1 a new line is represented, when
1 Frame contains group information
/III Type III cassette (ferric chrome)
Reverb feedback, right to right $xx
This frame's purpose is to be able to identify the audio file in a
value only, is now a numeric string. You may use one or several of
Reverb feedback, left to right $xx
header is a descriptor of how much the 'frame counter' should
/III Type III cassette (ferric chrome)
4.17. Play counter
same symbol and only one containing the same owner identifier. The
only one containing the same symbol and only one containing the same
field. If Peakvolume is not known these fields could be left zeroed
4.22. Position synchronisation frame
The three byte language field is used to describe the language of the
6) (add your code which uses id3lib)
The 'Software/Hardware and settings used for encoding' frame
but may be empty. There may be several pictures attached to one file,
/LW LW
/A Analog transfer from media
4.26 ENCR Encryption method registration
53.Pop-Folk
%x0000000 00000000
44.Space
out bytes and milliseconds respectively.
the frame.
/A Analog transfer from media
4.3.1 WPAY Payment
but it's an easier solution than if one tries to achieve the same
The 'Copyright/Legal information' frame is a URL pointing at a
117.Power Ballad
37.Sound Clip
contains a terminated string with the involvement directly followed
appears in a file. Numbers preceded with $ are hexadecimal and
are allowed in the text. There may be more than one 'Unsynchronised
useless.
milliseconds deviation', must be a multiple of four. There may only
reverb is applied symmetric). There may only be one "RVRB" frame in
"Strang" $00 xx xx "ers" $00 xx xx " in" $00 xx xx " the" $00 xx xx
56.Southern Rock
WPAY
4.21. Linked information
WCOP
in a project. The 'Involved people list' is a frame containing the
/6 mode 6, 44.1 kHz/16 bits, 'wide track' play
15.Rap
The 'Official audio file webpage' frame is a URL pointing at a file
responsible for this specific encrypted audio file. Questions
character date string (YYYYMMDD) followed by a string with the name
The 'Original release year' frame is intended for the year when the
$09 Conductor
7) Compile.
The following type and refinements are defined:
[ISO-4217] ISO 4217:1995.
THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
Since standardisation of such a database is beyond this document, all
audio stream he picked up; in effect, it states the time offset of
information, such as title, performer, copyright etc.
Reverb left (ms) $xx xx
represented as
the audio to match the 'Playlist delay' time. The time is represented
This frame is intended for URL [URL] links concerning the audiofile
3) make your project dependend on id3lib, and make id3lib dependend on zlib
92.Progressive Rock
currently only three flags are used.
3.2. ID3v2 extended header
textstring. The description has a maximum length of 64 characters,
The ID3v2 tag size is encoded with four bytes where the most
bytes. These flags are described in section 3.3.1.
97.Chorus
software with ID3v2.2.0 and below support should encounter version
$02 Absolute time, 32 bit sized, using milliseconds as unit
"AS IS" basis and THE AUTHORS DISCLAIMS ALL WARRANTIES, EXPRESS OR
that is a contact URL, with which the user can contact the seller,
The 'Payment' frame is a URL pointing at a webpage that will handle
Relative volume change, right $xx xx (xx ...)
information about the performers in the recording.
112.Club
Text encoding $xx
Language $xx xx xx
such order: UFID, TIT2, MCDI, TRCK ...
the player. All tempo descriptors should be sorted in chronological
string, followed by the actual string. There may be more than one
50.Darkwave
Reverb bounces left/right is the number of bounces that should be
/45 45 rpm
$0E sustained noise
Extensions (MIME) Part One: Format of Internet Message Bodies",
audiofile in a similar way to the other "T"-frames. The frame body
as in the "TCO" frame. Predefined refinements is appended after the
represented as $00 00 02 01.
4.2.2. User defined text information frame
/A Analog transfer from media
counter thus making the counter eight bits bigger. The counter must
Milliseconds between reference $xx xx xx
/AAC Advanced audio compression
The 'Encoded by' frame contains the name of the person or
the player. All tempo descriptors should be sorted in chronological
'recommended buffer size' frame should be included in every tag.
be used after every entry (name, event etc.) in a frame with the
4.3.1. URL link frames - details
There is no fixed order of the frames' appearance in the tag,
4.6 ETCO Event timing codes
MPEG frames between reference $xx xx
The second criterion has made a more noticeable impact on the design
$12345678 would be encoded $12 34 56 78).
TLEN
The 'Owner identifier' is a null-terminated string with a URL [URL]
5. The 'unsynchronisation scheme'
[ISO-8859-1] characters in the range $20 - $FF. Such strings are
performers are seperated with the "/" character.
ID3v2/file identifier "ID3"
ISO/IEC DIS 13818-3
66.New Wave
For a more accurate description of the tempo of a musical piece this
$12345678 would be encoded $12 34 56 78).
header in the next. This field may be omitted. Embedded tags are
which time stamp format should be used. Then follows one or more
'recommended buffer size' frame. If the client is connected to a
header in the same order as the flags indicating the additions. I.e.
4.2.1 TPE4 Interpreted, remixed, or otherwise modified by
be described with the 'Peak volume right' and 'Peak volume left'
specific webpage.
Text encoding $xx
The 'Media type' frame describes from which media the sound
Filename
[ID3v2] Martin Nilsson, "ID3v2 informal standard".
Terminating the start events such as "intro start" is not required.
without knowledge in why the frame was flagged read only and
information from another ID3v2 tag that might reside in another audio
The 'Buffer size' should be kept to a minimum. There may only be one
although it is desired that the frames are arranged in order of
with unknown content. %x is used to indicate a bit with unknown
frame size. If ISO-8859-1 is used this byte should be $00, if Unicode
significant bit (bit 7) is set to zero in every byte, making a total
122.Drum Solo
only be clear if the tag does not contain any false synchronisations.
Copyright (C) Martin Nilsson 1998. All Rights Reserved.
8. Appendix
content descriptor.
$01 end of initial silence
/AM AM
TPOS
22.Death Metal
4. Declared ID3v2 frames
The "TXXX", "APIC", "GEOB" and "AENC" frames may be linked with
without taking the proper means to compensate, e.g. recalculating
$02 Compressed audio on CD
4.2.1 TSSE Software/Hardware and settings used for encoding
a - Tag alter preservation
Increment/decrement %00xxxxxx
Owner identifier
It is permitted to include padding after all the final frame (at the
size and encoding fields, with a price string field. A price is
result with several frames. The frame begins, after the frame ID,
To indicate usage of the unsynchronisation, the first bit in 'ID3
additional information. This information will be added to the frame
Peak volume left back $xx xx (xx ...)
4.13. Equalisation
/4 mode 4, 32 kHz/12 bits, 4 channels
$05 As note sheets
Distribution of this document is unlimited.
54.Eurodance
cover of a previously released song, was released. The field is
decoding a compressed, 'unsynchronised' file, the 'unsynchronisation
Premix right to left $xx
altered functionallity.
bytes for the 'lead out' making a maximum of 804 bytes. The offset to
8-bit single-byte coded graphic character sets, Part 1: Latin
(debug) /nodefaultlib:"libcmtd" or(release) /nodefaultlib:"libcmt"
4.Disco
in the audio file as text, this time, however, in sync with the
which a program was run.
/2 MPEG 1/2 layer II
TRDA
TPOS
counter thus making the counter eight bits bigger. The counter must
'milliseconds between reference' and the reality. The number of bits
To increase performance and accuracy of jumps within a MPEG [MPEG]
are not subject to encryption or compression.
2. Conventions in this document
The following type and refinements are defined:
The 'Buffer size' should be kept to a minimum. There may only be one
should be ignored and not be displayed. All text frame identifiers
string with a URL [URL] containing an email address, or a link to a
Text encoding $xx
Text encoding $xx
ended with a ")" character. This is optionally followed by a
reserved. $00 is used to describe a beat-free time period, which is
Preview start $xx xx
Counter $xx xx xx xx (xx ...)
as a numeric string.
The 'Title/Songname/Content description' frame is the actual name of
pointing at the homepage of the internet radio station.
lyrics spoken or sung in the audio. The language is represented with
the signature, the bit should be cleared.
4.23. Terms of use frame
The 'Recording dates' frame is a intended to be used as complement to
valid for new line characters. A syllable followed by a comma should
TEL Telephone
purpose of this padding is to allow for adding a few additional
5.Funk
within "(" and ")" and are optionally followed by a text refinement,
[ISO-4217] ISO 4217:1995.
$02 Compressed audio on CD
All numeric strings and URLs [URL] are always encoded as ISO-8859-1.
Rating $xx
4) Add /D ID3LIB_LINKOPTION=1 to your project options (settings, C/C++ tab)
4.21. Linked information
2.Country
6. Copyright
Owner identifier
With these frames dynamic data such as webpages with touring
4.2.1 TLAN Language(s)
/AD ADD
79.Hard Rock
the frame the first two channels will be treated as front channels.
datablock required for decryption of the audio. There may be more
TPE4
45.Meditative
encoding have a text encoding description byte directly after the
24.Soundtrack
originated. This may be a text string or a reference to the
described in 4.3.2.>
The 'Official internet radio station homepage' contains a URL
Identifier
Language $xx xx xx
TORY
the encoder) is a null terminated string followed by a time stamp
Where time stamp format is:
TPUB
$F0-$FC reserved for future use
The 'Part of a set' frame is a numeric string that describes which
4.25 COMR Commercial frame
Content descriptor
$00.
Time stamp $xx (xx ...)
only used when the files are stored on a CD-ROM or other
The 'Time stamp' is set to zero if directly at the beginning of the
Where yy is less than $FF, xx is the 'flags' byte and zz is less than
The actual text
/1 standard, 48 kHz/16 bits, linear
/VHS VHS
TIT1
4.14 RVRB Reverb
$0E During recording
4.3.1. URL link frames - details
"POSS" frame in each tag.
"MCID", "ETCO", "MLLT", "SYTC", "RVAD", "EQUA", "RVRB", "RBUF", the
The price string is followed by an 8 character date string in the
TCOP
MIME type
$04 is events (e.g. "Don Quijote enters the stage")
4.2.1 TRSO Internet radio station owner
separating words should mark the beginning of a new word, thus
be one "RVAD" frame in each tag.
4.16. General encapsulated object
The first criterion is met by the simple fact that the MPEG [MPEG]
to the same group.
defined in 'bits for bytes deviation', that describes the difference
I, II and III and MPEG 2.5 files.
4.28. Private frame
predefine an equalisation curve within the audio file. There may only
The limited permissions granted above are perpetual and will not be
encoder.
Adjustment bits $xx
PCM Pulse Code Modulated audio
Reverb feedback, left to right $xx
is reflected by the revision number in the header of the tag.
4.2.1 TPE4 Interpreted, remixed, or otherwise modified by
102.Chanson
Adjustment bits $xx
72.Tribal
104.Chamber Music
audio file, frames with timecodes in different locations in the file
CR Cover
starts. It is represented as a string with a maximum length of three
A tag is the whole tag described in this document. A frame is a block
11.Oldies
AENC, ETCO, EQUA, MLLT, POSS, SYLT, SYTC, RVAD, TENC, TLEN, TSIZ
3. ID3v2 overview
subject to unsynchronisation.
4.24 OWNE Ownership frame
108.Primus
1. Table of contents
4.2.1 TALB Album/Movie/Show title
TIME
TEL Telephone
to frequency. All frequencies don't have to be declared. The
b - Extended header
/I
1 is worst and 255 is best. 0 is unknown. If no personal counter is
$06 Media (e.g. lable side of CD)
4.9. Unsychronised lyrics/text transcription
Value
currency code. Concatenated to this is the actual price payed, as a
IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF
nearest byte) for every equalisation band in the following format,
might be useful. The ID3v2 frame includes references that the
if found more suitable by the software.
$08 Non-musical merchandise
$0A variation start
/1 MPEG 1/2 layer I
0.Blues
9. Author's Address
media type, e.g. "(CD/A)" or "(VID/PAL/VHS)".
The 'Lyricist(s)/Text writer(s)' frame is intended for the writer(s)
Extended header size $xx xx xx xx
(debug) /nodefaultlib:"MSVCRTD" or(release) /nodefaultlib:"MSVCRT"
Seller
constructed by one three character currency code, encoded according
content descriptor, represented with as terminated textstring. If no
4.22 POSS Position synchronisation frame
In the increment/decrement field bit 0 is used to indicate the right
beginning of the file.
with the same language and content descriptor.
includes the used audio encoder and its settings when the file was
performers are seperated with the "/" character.
as flexible and expandable as possible.
The 'Time stamp' is set to zero if directly at the beginning of the
Frequency (lower 15 bits)
counter reaches all one's, one byte is inserted in front of the
audio is delivered when bought according to the following list:
the piece (e.g. "Adagio", "Hurricane Donna").
22.Death Metal
and MPEG-2.5, but may work with other types of encoded audio.
/A Analog transfer from media
This frame contains the lyrics of the song or a text transcription of
significance concerning the recognition of the file. An example of
MPEG 2 layer I, II and III [MPEG] and MPEG 2.5. This value may not be
official wepage for the publisher.
4.14 RVRB Reverb
maximum size described in 'Buffer size' may occur in the audiostream.
1 Frame is compressed using zlib [zlib] with 4 bytes for
code. Technical committee / subcommittee: TC 37 / SC 2
'Premix left to right' is the amount of left sound to be mixed in the
the audio to match the 'Playlist delay' time. The time is represented
$02 Absolute time, 32 bit sized, using milliseconds as unit
Codes for the representation of names of languages, Part 2: Alpha-3
section 5.
ISO/IEC DIS 13818-3
7) Compile.
audio stream. In these cases, the size of the buffer can be
consists of a binary dump of the Table Of Contents, TOC, from the CD,
recording. E.g. "4/9".
4.28. Private frame
25.Euro-Techno
DVD DVD
containing an email address, or a link to a location where an email
Part 3: Audio.
want to synchronise your music to something, like setting of an
4.21. Linked information
throughout the whole tag. Values below $80 are reserved. The 'Method
used in the text their language codes should follow according to
with the same email address.
unknown and the file, excluding the tag, is altered. This does not
Value
Size of padding $xx xx xx xx
All the other flags should be cleared. If one of these undefined
ISO/IEC DIS 13818-3
76.Retro
The bitorder in ID3v2 is most significant bit first (MSB). The
71.Lo-Fi
To indicate usage of the unsynchronisation, the first bit in 'ID3
audio stream he picked up; in effect, it states the time offset of
This frame enables several competing offers in the same tag by
by comparing people's profiles. The frame is very simple. It contains
TPE2
/1 MPEG 1/2 layer I
section 5.
Language $xx xx xx
the software that encounters them. At the start of every frame there
93.Psychedelic Rock
could be used to profile a person's taste and find other 'good' files
for more information.
bits) for MPEG 2 layer I, II and III [MPEG] and MPEG 2.5. This value
numerical value where "." is used as decimal seperator. In the price
The first criterion is met by the simple fact that the MPEG [MPEG]
ended with a ")" character. This is optionally followed by a
$14 theme end
/3 mode 3, 32 kHz/12 bits, nonlinear, low speed
Bits used for volume descr. $xx
the following format:
unsynchronisation on the data between the extended header and the
which may be up to 64 bytes. There may be more than one "UFID" frame
Abolute time means that every stamp contains the time from the
described in frames. If no part is unencrypted, these fields should
with information such as where the album can be bought. There may be
amount of volume that should be returned to the next echo bounce. $00
"/" character.
optional.
[MIME] Freed, N. and N. Borenstein, "Multipurpose Internet Mail
recording. This may be extended with a "/" character and a numeric
51.Techno-Industrial
'decompressed size' appended to the frame header.
87.Revival
The first three bytes of the tag are always "ID3" to indicate that
considered as an update of the previous one. E.g. if there is a
4.18 POPM Popularimeter
publisher.
email address can be found, that belongs to the organisation
Frame ID $xx xx xx xx (four characters)
In the increment/decrement field bit 2 is used to indicate the right
2) include libprj/id3lib.dsp and zlib/prj/zlib.dsp to your workspace
which time stamp format should be used. Then follows one or more
be at least 32-bits long to begin with.
4.22. Position synchronisation frame
size of ten bytes in every frame. The size is calculated as frame
23.Pranks
4.3.1 WCOM Commercial information
[ISO-8859-1] characters in the range $20 - $FF. Such strings are
Group dependent data
symbol' contains a value that associates the frame with this group
4.6. Event timing codes
section 3.2.
the frame.
symbol' may optionally be followed by encryption specific data. There
performer(s) of the original recording, if for example the music in
Text encoding $xx
Image format is the MIME type and subtype [MIME] for the image. In
THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
b - Extended header
ID3v2/file identifier "ID3"
experimental stage.
The 'File type' frame indicates which type of audio this tag defines.
The 'time stamp' is set to zero or the whole sync is omitted if
writers are seperated with the "/" character.
7. References
To identify with which method a frame has been encrypted the
be described with the 'Peak volume right' and 'Peak volume left'
4.3. URL link frames
4.2.1 TPE1 Lead performer(s)/Soloist(s)
None.
playlist that features better audiofiles more often than others or it
51.Techno-Industrial
string with a URL [URL] containing an email address, or a link to a
to the existing frame, after the center channel. The bass channel is
'Method symbol' contains a value that is associated with this method
TIME
Peak volume right back $xx xx (xx ...)
'offset to next tag' may be used. The offset is calculated from the
but it's an easier solution than if one tries to achieve the same
83.Swing
the player. All tempo descriptors should be sorted in chronological
all the $FF 00 combinations have to be replaced with the $FF 00 00
102.Chanson
$0C Lyricist/text writer
URL
The Second one (id3lib/libprj) creates the .lib file for static linking.
115.Folklore
/DD DDD
4.6. Event timing codes
audio stream he picked up; in effect, it states the time offset of
unsychronisation, including padding, excluding the header but not
$04 Stream over the Internet
The 'Software/Hardware and settings used for encoding' frame
frame have been made in a later version of the ID3v2 standard. This
The ID3v2 tag size is the size of the complete tag after
Terminated text to be synced (typically a syllable)
MIME type
audiofile indeed is encrypted, the whole file may be considered
0 Frame should be preserved.
Content descriptor
The 'Band/Orchestra/Accompaniment' frame is used for additional
35.House
66.New Wave
Universal Multiple-Octet Coded Character Set (UCS), Part 1:
represented as
7) Try to compile, and see if you need any of the following:
encoder.
Time stamp format is:
The "COMM", "SYLT" and "USLT" frames may be linked with three bytes
3.3. ID3v2 frames overview
1) Rename config.h.win32 to config.h
5. The 'unsynchronisation scheme'
string etc. A numeric string is a string that consists of the
102.Chanson
used in the text their language codes should follow according to
string containing the total numer of tracks/elements on the original
4.3.2. User defined URL link frame
indicates usage.
The 'Language(s)' frame should contain the languages of the text or
containing an email address, or a link to a location where an email
1.Classic Rock
reverb is applied symmetric). There may only be one "RVRB" frame in
or, if no other data follows, be completely omitted. There may only
represented by bit 5 in the increase/decrease field.
unknown and the file, excluding the tag, is altered. This does not
DCC DCC
This frame delivers information to the listener of how far into the
audio can be specified. The 'Preview start' and 'Preview length' is
The 'Official audio source webpage' frame is a URL pointing at the
5. The 'unsynchronisation scheme'
$03 File over the Internet
4.3.2. User defined URL link frame
Generic coding of moving pictures and associated audio information,
address can be found, that belongs to the organisation responsible
$02 Absolute time, 32 bit sized, using milliseconds as unit
124.Euro-Hous $0D momentary unwanted noise (Snap, Crackle & Pop)
subject to unsynchronisation.
61.Christian Rap
software with ID3v2.2.0 and below support should encounter version
$FF one more byte of events follows (all the following bytes with
sound or after the previous event. All events should be sorted in
$12345678 would be encoded $12 34 56 78).
'decompressed size' appended to the frame header.
4.17 PCNT Play counter
frames, all the frames consists of a frame header followed by one or
more information about the people behind a remix and similar
4.5. Music CD Identifier
/2 mode 2, 32 kHz/16 bits, linear
/2 mode 2, 32 kHz/16 bits, linear
3.3. ID3v2 frames overview
audiofile indeed is encrypted, the whole file may be considered
The 'time stamp' is set to zero or the whole sync is omitted if
/IV Type IV cassette (metal)
end of tag in which this frame resides to the first byte of the
"TXXX" frame in each tag, but only one with the same description.
same symbol and only one containing the same owner identifier. The
Yet another subjective one. You may here adjust echoes of different
IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF
4. Preserved if tag is altered, preserved if file is altered.
None.
4.3.2. User defined URL link frame
/38 38 cm/s
three or higher it should simply ignore the whole tag. Version and
in a similar way to the other "W"-frames. The frame body consists
information blocks, called frames, whose format need not be known to
/78 78.26 rpm
73.Acid Punk
textstring. The description has a maximum length of 64 characters,
nearest byte) for every equalisation band in the following format,
first byte has the value $FF, one more byte follows, which is added
[CDDB] Compact Disc Data Base
4.9. Unsychronised lyrics/text transcription
If the last byte in the tag is $FF, and there is a need to eliminate
ownership of the file. More detailed information concerning the legal
Sync identifier (terminator to above string) $00 (00)
122.Drum Solo
the artists official webpage. There may be more than one "WOAR" frame
WPAY
/II Type II cassette (chrome)
email address can be found, that belongs to the organisation
various ways, such as musicians and technicians, the 'Text
the file should be a cover of a previously released song. The
kinds. Reverb left/right is the delay between every bounce in ms.
the tag. There may only be one URL [URL] link frame of its kind in an
4.3.1 WPUB Publishers official webpage
This document describes the ID3v2.3.0, which is a more developed
Followed by a list of key events in the following format:
Text encoding $xx
4.11 COMM Comments
but may be empty. There may be several pictures attached to one file,
80.Folk
'decompressed size' appended to the frame header.
part of the tag (i.e. only one "RVRB" frame allowed, whether it's
TEXT
Date of purch.
The 'Official artist/performer webpage' frame is a URL pointing at
Filename
frame size. If ISO-8859-1 is used this byte should be $00, if Unicode
Picture type $xx
Newline ($0A) characters are allowed in all "SYLT" frames and should
to ISO 4217 [ISO-4217] alphabetic currency code, followed by a
4.2.1 TYER Year
kinds of alterations, including adding more padding and reordering
Flags $xx xx
the file should be a cover of a previously released song. The
4.2.1 TFLT File type
or, if no other data follows, be completely omitted. There may only
chronological order. The type of event is as follows:
false synchronisations in the tag, at least one byte of padding
break something, e.g. a signature. If the contents are changed,
$0F During performance
4.16 GEOB General encapsulated object
evolved from the ID3 tagging system. The ID3v2 offers a flexible way
Left to left means the sound from the left bounce to be played in the
end of the ID3 tag), making the size of all the frames together
Peak volume left back $xx xx (xx ...)
This flag tells the software what to do with this frame if it is
apply when the audio is completely replaced with other audio data.
writers are seperated with the "/" character.
WPUB
it doesn't seem to be maintained anymore. I've included it as a service.
used in the text their language codes should follow according to
only.
that is a contact URL, with which the user can contact the seller,
/3 mode 3, 32 kHz/12 bits, nonlinear, low speed
copyright holder of the original sound, not the audio file itself.
31.Trance
are allowed in the text. There may be more than one 'Unsynchronised
if not identical to what is described in this document. The contents
And, last but not least, there is a delphi project in cvs
3.3. ID3v2 frames overview
document, all "AENC" frames begin with a terminated string with a
more than one "WCOM" frame in a tag, but not with the same content.
78.Rock & Roll
None.
WOAF
Owner identifier
4.19. Recommended buffer size
"/" character.
This frames is always four characters long (until the year 10000).
4.5. Music CD Identifier
unknown flag is set in the first byte the frame may not be changed
all the $FF 00 combinations have to be replaced with the $FF 00 00
sync identifier.
writers are seperated with the "/" character.
4.13 EQUA Equalization
number of "PRIV" frames as low as possible.
method must be used somewhere in the tag. See section 3.3.1, flag j
4.10. Synchronised lyrics/text
115.Folklore
frame in each tag, but only one with the same content descriptor.
Language $xx xx xx
of a description of the string, represented as a terminated string,
4.Disco
This frame contains the lyrics of the song or a text transcription of
strings may be omitted, leaving only their terminations. MIME type is
/I
Bits for bytes deviation $xx
Bit 7 in the 'ID3v2 flags' indicates whether or not
Description
Informal standard M. Nilsson
c - Read only
the beat description occurs. There may only be one "SYTC" frame in
118.Rhythmic Soul
16-bit unicode 2.0 (ISO/IEC 10646-1:1993, UCS-2). Unicode strings
copyright message, if the audio file also is copyrighted by the
$03 Cover (front)
appended to the frame header. See section 4.26. for more
109.Porn Groove
correct parsing of the tag information, hence the extended header is
interpretations of another existing piece.
filename. The filename is case sensitive and includes its suffix.
Date of purch.
102.Chanson
4.2.1 TRCK Track number/Position in set
TOLY
appears in a file. Numbers preceded with $ are hexadecimal and
Sometimes the server from which a audio file is streamed is aware of
4.14. Reverb
43.Punk
66.New Wave
in a project. The 'Involved people list' is a frame containing the
/AA AAD
Short content descrip.
To identify with which method a frame has been encrypted the
not the same as a music-free time period. $01 is used to indicate one
symbol' may optionally be followed by some group specific data, e.g.
The second bit (bit 6) indicates whether or not the header is
4.10. Synchronised lyrics/text
only used when the files are stored on a CD-ROM or other
with a "(" character it should be replaced with "((" in the same way
6.Grunge
in a project. The 'Involved people list' is a frame containing the
field.
A. Appendix A - Genre List from ID3v1
lyrics/text transcription' frame in each tag, but only one with the
In such case the tag should reside between two MPEG [MPEG] frames, if
with the actual comment as a text string. Newline characters are
16.Reggae
audio is delivered when bought according to the following list:
The first one (id3lib/prj) creates the standard dll (no COM interface)
4.3.1. URL link frames - details
Tempo data
Reverb feedback, left to left $xx
identifier'.
4.22. Position synchronisation frame
The 'Internet radio station owner' frame contains the name of the
out bytes and milliseconds respectively.
[ISO-8859-1]. There may be more than one "WXXX" frame in each tag,
playlist that features better audiofiles more often than others or it
The ID3v2 tag size is the size of the complete tag after
"Strangers in the night" $0A "Exchanging glances"
$04 is events (e.g. "Don Quijote enters the stage")
$13 Band/artist logotype
References to the ID3v1 genres can be made by, as first byte, enter
Language $xx xx xx
4.19. Recommended buffer size
3) make your project dependend on id3lib, and make id3lib dependend on zlib
This frame contains a brief description of the terms of use and
between the values in this frame. Three equal adjustments for three
Compiling on win32:
4.21. Linked information
Description
the event that the MIME media type name is omitted, "image/" will be
Terminated strings are terminated with $00 if encoded with ISO-8859-1
specific webpage.
4.7. MPEG location lookup table
"1/2".
part of the tag and has the same restrictions as if it was a physical
tempo in the music changes, a tempo descriptor may indicate this for
the encoder) is a null terminated string followed by a time stamp
WPUB
b - Extended header
flags' should be set. This bit should only be set if the tag
The 'Length' frame contains the length of the audiofile in
ended with a ")" character. This is optionally followed by a
4.5. Music CD Identifier
between what is said in 'bytes between reference' and the reality and
[JFIF] JPEG File Interchange Format, version 1.02
altered, so they won't be affected by the decoding process. Therefore
refinement, e.g. "(21)" or "(4)Eurodisco". Several references can be
4.21 AENC Audio encryption
begins with "W". All URL link frames have the following format:
/MW MW
of the ID3v2 tag. It is constructed as a container for several
/2 mode 2, 32 kHz/16 bits, linear
The first one (id3lib/prj) creates the standard dll (no COM interface)
predefine an equalisation curve within the audio file. There may only
flag' is true (1) then this indicates that an ID3 tag with the
containing an email address, or a link to a location where an email
b - Extended header
18.Techno
unknown and the tag is altered in any way. This applies to all
/AM AM
4. Declared ID3v2 frames
The increment/decrement bit is 1 for increment and 0 for decrement.
described in frames. If no part is unencrypted, these fields should
more information about the people behind a remix and similar
A. Appendix A - Genre List from ID3v1
section 5.
/9 9.5 cm/s
revoked.
useless.
version of the ID3v2 informal standard [ID3v2] (version 2.2.0),
The 'time stamp' is set to zero or the whole sync is omitted if
113.Tango
The tempo descriptor is followed by a time stamp. Every time the
no use in 'unsynchronising' tags if the file is only to be processed
excluding the extended header (total tag size - 10). Only 28 bits
decoding software uses a syncsignal, embedded in the audiostream, to
123.Acapella
$01 Standard CD album with other songs
76.Retro
3.3.2. Default flags
but may be empty. There may be several pictures attached to one file,
ISO/IEC 13818-3:1995
each tag.
followed by a Unicode NULL ($FF FE 00 00 or $FE FF 00 00).
The second criterion has made a more noticeable impact on the design
original recording, if for example the music in the file should be a
represented as
additional information. This information will be added to the frame
An example: The "USLT" passage
recording. E.g. "4/9".
all the $FF 00 combinations have to be replaced with the $FF 00 00
%abc00000 %ijk00000
24.Soundtrack
2. Conventions in this document
Owner identifier
The 'Language(s)' frame should contain the languages of the text or
References to the ID3v1 genres can be made by, as first byte, enter
Text encoding $xx
such order: UFID, TIT2, MCDI, TRCK ...
string several prices may be concatenated, seperated by a "/"
$05 is chord (e.g. "Bb F Fsus")
'decompressed size' appended to the frame header.
play. There may only be one "PCNT" frame in each tag. When the
begin with a "(" character it should be replaced with "((", e.g. "((I
Each reference consists of two parts; a certain number of bits, as
bytes. All unused flags must be cleared. The first byte is for
REE Reel
"Strang" $00 xx xx "ers" $00 xx xx " in" $00 xx xx " the" $00 xx xx
frame header. Every frame with the same group identifier belongs
Milliseconds between reference $xx xx xx
generally not recommended since this could render unpredictable
denoting where in the sound file it belongs. Each sync thus has the
itself. The 'Size of padding' is simply the total tag size excluding
4.27. Group identification registration
VQF Transform-domain Weighted Interleave Vector Quantization
with the same language and content descriptor.
/5 mode 5, 44.1 kHz/16 bits, linear
defined.
The 'Owner identifier' is a null-terminated string with a URL [URL]
Abolute time means that every stamp contains the time from the
In such case the tag should reside between two MPEG [MPEG] frames, if
type' "-->" and having a complete URL [URL] instead of picture data.
A tag must contain at least one frame. A frame must be at least 1
Description
4.17. Play counter
organisation responsible for this grouping. Questions regarding the
kind, provided that a reference to this document is included on all
4.26. Encryption method registration
nearest byte) for every equalisation band in the following format,
In the increment/decrement field bit 0 is used to indicate the right
j - Encryption
40.AlternRock
Time stamp $xx (xx ...)
frame consists of an 'Owner identifier' string and the binary data.
Codes for the representation of names of languages, Part 2: Alpha-3
[JFIF] JPEG File Interchange Format, version 1.02
by a terminated string with the involvee followed by a new
"MCID", "ETCO", "MLLT", "SYTC", "RVAD", "EQUA", "RVRB", "RBUF", the
34.Acid
address can be found, that belongs to the organisation responsible
software with ID3v2.2.0 and below support should encounter version
internet radio station from which the audio is streamed.
50.Darkwave
organisation responsible for this grouping. Questions regarding the
And should be replaced with:
align all files to a reference volume, so that you don't have to
6.Grunge
4.2.1 TPE1 Lead performer(s)/Soloist(s)
Generic coding of moving pictures and associated audio information,
characters 0-9 only.
4.19. Recommended buffer size
/IV Type IV cassette (metal)
The 'Part of a set' frame is a numeric string that describes which
chronological order. The type of event is as follows:
different programs may require different 'nodefaultlib' 's, or none at all, these worked for me.
"Weather - Hurricane").
TLEN
increment and 0 is decrement.
file or alone in a binary file. It is recommended that this method is
73.Acid Punk
If a total revision of the ID3v2 tag should be needed, there is a
as the numerig content types, e.g. "(RX)".
contains a terminated string with the involvement directly followed
/I
/MW MW
$05 Leaflet page
Copyright (C) Martin Nilsson 1998. All Rights Reserved.
Total frame CRC $xx xx xx xx
TALB
Frame identifier $xx xx xx
After the 'Owner identifier', a pointer to an unencrypted part of the
the piece (e.g. "Adagio", "Hurricane Donna").
made in the same frame, e.g. "(51)(39)". If the refinement should
/19 19 cm/s
be played in the right speaker.
Universal Multiple-Octet Coded Character Set (UCS), Part 1:
34.Acid
The first three bytes of the tag are always "ID3" to indicate that
followed by a Unicode NULL ($FF FE 00 00 or $FE FF 00 00).
[ISO-4217] ISO 4217:1995.
$01 Absolute time, 32 bit sized, using MPEG [MPEG] frames as unit
/3 mode 3, 32 kHz/12 bits, nonlinear, low speed
c - Experimental indicator
41.Bass
"/" character.
ANA Other analog media
The 'Lyricist(s)/Text writer(s)' frame is intended for the writer(s)
28.Vocal
time. This frame requires a present and valid "TRCK" frame, even if
And the third one (id3lib/id3com) creates a dll with com interface. A Visual basic demo using it is included.
playlist that features better audiofiles more often than others or it
/80 80 rpm
different programs may require different 'nodefaultlib' 's, or none at all, these worked for me.
string according to encoding> if newlines are allowed. Any empty
between what is said in 'bytes between reference' and the reality and
should be before the sync).
/IV Type IV cassette (metal)
email address can be found, that belongs to the organisation
Newline ($0A) characters are allowed in all "SYLT" frames and should
software can use to calculate positions in the file. After the frame
CR Cover
The 'Original lyricist(s)/text writer(s)' frame is intended for the
92.Progressive Rock
that is a contact URL, with which the user can contact the seller,
7) Try to compile, and see if you need any of the following:
$0A Band/Orchestra
allowed in the text. There may only be one "USER" frame in a tag.
To increase performance and accuracy of jumps within a MPEG [MPEG]
Picture type $xx
cover of a previously released song, was released. The field is
'Content descriptor' is a terminated string. If no descriptor is
4.24. Ownership frame
involvement and so on. There may only be one "IPLS" frame in each
should be before the sync).
4.2.1 TDLY Playlist delay
The 'Owner identifier' is then followed by the actual identifier,
6. Copyright
the first frame in the stream. The frame layout is:
the left and right back channels. If this information is appended to
should be sorted in chronological order. The sync can be considered
described in frames. If no part is unencrypted, these fields should
containing an email address, or a link to a location where an email
type declared as picture type $01 and $02 respectively. There is the
4.14. Reverb
4.20. Audio encryption
34.Acid
reference points out the second frame, the 2nd reference the 4th
chronological order. The type of event is as follows:
5.Funk
Bits used for volume descr. $xx
85.Bebob
96.Big Band
for this specific database implementation. Questions regarding the
See section 3.3.1, flag j for more information.
In the frame header the size descriptor is followed by two flags
ID3v2 tag as compatible as possible with existing software. There is
individual connections like HTTP and there is a possibility to begin
4) Add /D ID3LIB_LINKOPTION=1 to your project options (settings, C/C++ tab)
The 'Album/Movie/Show title' frame is intended for the title of the
121.Punk Rock
is 0%, $FF is 100%. If this value were $7F, there would be 50% volume
double CD. The value may be extended with a "/" character and a
/1 MPEG 1/2 layer I
generally not recommended since this could render unpredictable
the email address to the user, one rating byte and a four byte play
displayed the field must be preceded with "Copyright " (C) " ", where
RX Remix
and MPEG-2.5, but may work with other types of encoded audio.
4.2.1 TENC Encoded by
/19 19 cm/s
4.2.1 TPE4 Interpreted, remixed, or otherwise modified by
allowed, in the frame descriptions. All Unicode strings [UNICODE] use
interpretations of another existing piece.
4.2.1 TMED Media type
3) make your project dependend on id3lib, and make id3lib dependend on zlib
containing an email address, or a link to a location where an email
header is a descriptor of how much the 'frame counter' should
0 Frame should be preserved.
represented as $00 00 02 01.
which picture format is used. In the event that the MIME media type
Encryption info
only be clear if the tag does not contain any false synchronisations.
The default settings for the frames described in this document can be
currency code. Concatenated to this is the actual price payed, as a
end of the ID3 tag), making the size of all the frames together
part of a set the audio came from. This frame is used if the source
The 'Media type' frame describes from which media the sound
It is permitted to include padding after all the final frame (at the
information about the performers in the recording.
textstring is followed by a termination ($00 (00)) all the following
Where the 'Extended header size', currently 6 or 10 bytes, excludes
good to use in conjunction with this one. The frame begins, after the
and
either used or reserved for future use.
Whenever a false synchronisation is found within the tag, one zeroed
$FE audio file ends
value only, is now a numeric string. You may use one or several of
it is likely to not be readable. The flags field is defined as
appears in a file. Numbers preceded with $ are hexadecimal and
center channel is represented by bit 4 in the increase/decrease
The ID3v2 tag size is encoded with four bytes where the most
three or higher it should simply ignore the whole tag. Version and
(representing up to 256MB) are used in the size description to avoid
/VHS VHS
1. Discarded if tag is altered, discarded if file is altered.
4.2.2. User defined text information frame
/AD ADD
or, if signed, as proof. Note that the "USER" and "TOWN" frames are
alphabet No. 1. Technical committee / subcommittee: JTC 1 / SC 2
/80 80 rpm
counter thus making the counter eight bits bigger. The counter must
tempo in the music changes, a tempo descriptor may indicate this for
bits) for MPEG 2 layer I, II and III [MPEG] and MPEG 2.5. This value
'bytes between reference' and 'milliseconds between reference' points
Extended header size $xx xx xx xx
with the same email address.
IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF
includes the used audio encoder and its settings when the file was
first byte has the value $FF, one more byte follows, which is added
46.Instrumental Pop
only one containing the same symbol and only one containing the same
byte is its revision number. In this case this is ID3v2.3.0. All
7. References
The 'Official audio file webpage' frame is a URL pointing at a file
should be sorted in chronological order. The sync can be considered
19.Industrial
4.21 AENC Audio encryption
followed by a termination ($00 (00)) all the following information
$11 A bright coloured fish
originated. This may be a text string or a reference to the
25.Euro-Techno
And the third one (id3lib/id3com) creates a dll with com interface. A Visual basic demo using it is included.
tempo codes. Each tempo code consists of one tempo part and one time
between every song in a playlist. The player should use the "ETC"
TYER
of the text or lyrics in the recording. They are seperated with the
1 Frame should be discarded.
URL containing an email address, or a link to a location where an
The original location is http://sourceforge.net/projects/id3com
URL containing an email address, or a link to a location where an
a larger category of sounds/music. For example, classical music is
/I
byte is inserted in front of the counter thus making the counter
the following format:
WCOM
Time stamp format $xx
followed by a Unicode NULL ($FF FE 00 00 or $FE FF 00 00).
Short content descrip.
The 'File owner/licensee' frame contains the name of the owner or
'status messages' and the second byte is for encoding purposes. If an
reason, coincidence make a syncsignal appear within the tag it will
4.2.1 TCOP Copyright message
unsynchronisation on the data between the extended header and the
4.4 IPLS Involved people list
audio is delivered when bought according to the following list:
one with the same contents. A linked frame is to be considered as
bytes for the 'lead out' making a maximum of 804 bytes. The offset to
Bit 7 in the 'ID3v2 flags' indicates whether or not
if found more suitable by the software.
milliseconds deviation', must be a multiple of four. There may only
This frame contains a picture directly related to the audio file.
4.19. Recommended buffer size
to the first giving a range from 2 - 510 BPM, since $00 and $01 is
section 5.
padded in the beginning (highest bits) when 'bits used for volume
7.Hip-Hop
the CD's only got one track. There may only be one "MCDI" frame in
The three byte language field is used to describe the language of the
How to start
numbers preceded with % are binary. $xx is used to indicate a byte
$49 44 33 yy yy xx zz zz zz zz
audio stream. In these cases, the size of the buffer can be
The 'Internet radio station owner' frame contains the name of the
111.Slow Jam
/I
[ISO-8859-1] ISO/IEC DIS 8859-1.
The 'Encoded by' frame contains the name of the person or
(MS recommend you distribute it in your programs dir and not in system(32) to avoid version conficts)
This frame is indended for any kind of full text information that
'status messages' and the second byte is for encoding purposes. If an
standard [ID3v2]. The informal standard is released so that
webpage where the terms of use and ownership of the file is
Reverb feedback, left to right $xx
In the frame header the size descriptor is followed by two flags
C)***Your project wants to link id3lib dynamic: (instructions below for vc)
4.21. Linked information
The ID3v2 tag size is the size of the complete tag after
4.28. PRIV Private frame
the left and right back channels. If this information is appended to
Total frame CRC $xx xx xx xx
"POSS" frame in each tag.
References to the ID3v1 genres can be made by, as first byte, enter
All URLs [URL] may be relative, e.g. "picture.png", "../doc.txt".
54.Eurodance
follows
The first three bytes of the tag are always "ID3" to indicate that
In this frame any type of file can be encapsulated. After the header,
$0B key change
Where yy is less than $FF, xx is the 'flags' byte and zz is less than
31.Trance
Followed by a list of key events in the following format:
The 'Content type', which previously was stored as a one byte numeric
followed by a one byte 'received as' field. It describes how the
Group dependent data
For applications like streaming audio it might be an idea to embed
(debug) /nodefaultlib:"msvcprtd" or(release) /nodefaultlib:"msvcprt"
of information in the tag. The tag consists of a header, frames and
one with the same contents. A linked frame is to be considered as
to the first giving a range from 2 - 510 BPM, since $00 and $01 is
the artists official webpage. There may be more than one "WOAR" frame
47.Instrumental Rock
The 'Track number/Position in set' frame is a numeric string
4.22. Position synchronisation frame
Encryption info
6.Grunge
58.Cult
51.Techno-Industrial
identifier'.
2) include libprj/id3lib.dsp and zlib/prj/zlib.dsp to your workspace
combination during the unsynchronisation.
This frame is indended for any kind of full text information that
71.Lo-Fi
numbers preceded with % are binary. $xx is used to indicate a byte
This frame enables several competing offers in the same tag by
unknown and the tag is altered in any way. This applies to all
Name of seller
byte is inserted after the first false synchronisation byte. The
7. References
4.2.1 TIME Time
/4 4.75 cm/s (normal speed for a two sided cassette)
4.2.2. User defined text information frame
4.2.1 TIME Time
The text that follows the frame header differs from that of the
number of "PRIV" frames as low as possible.
exception of the "TXXX" frame. All the text information frames have
/LW LW
To increase performance and accuracy of jumps within a MPEG [MPEG]
VID Video
and the least significant bit (LSB) is called 'bit 0'.
as the numerig content types, e.g. "(RX)".
Content type $xx
ended with a ")" character. This is optionally followed by a
chronological order. The type of event is as follows:
Bits for bytes deviation $xx
This frame is intended for music that comes from a CD, so that the CD
method must be used somewhere in the tag. See section 3.3.1, flag j
62.Pop/Funk
Relative volume change, left back $xx xx (xx ...)
4.2.1 TOFN Original filename
/WAC Wax cylinder
frame, the 3rd reference the 6th frame etc. In a similar way the
4.18 POPM Popularimeter
right before any reverb is applied, where $00 id 0% and $FF is 100%.
The 'Playlist delay' defines the numbers of milliseconds of silence
Technical committee / subcommittee: TC 46 / SC 9
their usage.
/5 mode 5, 44.1 kHz/16 bits, linear
4.3.2. User defined URL link frame
currently only three flags are used.
/I Type I cassette (ferric/normal)
right before any reverb is applied, where $00 id 0% and $FF is 100%.
'Method symbol' contains a value that is associated with this method
the beat description occurs. There may only be one "SYTC" frame in
TLAN
(C) is one character showing a C in a circle.
into this tag, a URL [URL] field, where a reference to the file where
Owner identifier
Premix right to left $xx
/4 4.75 cm/s (normal speed for a two sided cassette)
interpretations of another existing piece.
$08 Artist/performer
The 'BPM' frame contains the number of beats per minute in the
which may be up to 64 bytes. There may be more than one "UFID" frame
/AAC Advanced audio compression
in a project. The 'Involved people list' is a frame containing the
Part 3: Audio (Revision of ISO/IEC 13818-3:1995)
The 'File type' frame indicates which type of audio this tag defines.
26.Ambient
containing an email address, or a link to a location where an email
/WAC Wax cylinder
Content type: $00 is other
7) Try to compile, and see if you need any of the following:
16.Reggae
61.Christian Rap
4.2.1 TMED Media type
72.Tribal
$09 theme start
There may only be one "ETCO" frame in each tag.
significance concerning the recognition of the file. An example of
includes the used audio encoder and its settings when the file was
Code [ISRC] (12 characters).
123.Acapella
4.2.1 TOWN File owner/licensee
is an identifier that explains the frames' format and content, and a
one with the same contents. A linked frame is to be considered as
4.2.1 TOLY Original lyricist(s)/text writer(s)
39.Noise
Name of seller
responsible for this specific encrypted audio file. Questions
Reverb left (ms) $xx xx
specified. If a $00 is found directly after the 'Frame size' and the
/2.5 MPEG 2.5
49.Gothic
string, followed by the actual string. There may be more than one
for this specific encryption method. Questions regarding the
information frames' are often insufficient to list everyone involved
separating words should mark the beginning of a new word, thus
and "image/jpeg" are allowed. This format string is followed by the
information, such as title, performer, copyright etc.
LD Laserdisc
(debug) /nodefaultlib:"msvcprtd" or(release) /nodefaultlib:"msvcprt"
refinement, e.g. "(21)" or "(4)Eurodisco". Several references can be
directly related to the contents title (e.g. "Op. 16" or "Performed
This document is an informal standard and replaces the ID3v2.2.0
3.Dance
double CD. The value may be extended with a "/" character and a
frame, the 3rd reference the 6th frame etc. In a similar way the
$0F sustained noise end
followed by encoding, language and content descriptors and is ended
Text encoding $xx
strings may be omitted, leaving only their terminations. MIME type is
'bytes between reference' and 'milliseconds between reference' points
correct parsing of the tag information, hence the extended header is
TEL Telephone
made. $FF equals an infinite number of bounces. Feedback is the
in the audio file as text, this time, however, in sync with the
7. References
14.R&B
The 'Content group description' frame is used if the sound belongs to
represented as "m". Example "Cbm". Off key is represented with an "o"
A) ***Your project wants to link id3lib static, and has mfc linked static:
1) Rename config.h.win32 to config.h
(MS recommend you distribute it in your programs dir and not in system(32) to avoid version conficts)
4.2.1 TDAT Date
/45 45 rpm
4.2.1 TBPM BPM (beats per minute)
1 Frame should be discarded.
3.2. ID3v2 extended header
software with ID3v2.2.0 and below support should encounter version
The 'Buffer size' should be kept to a minimum. There may only be one
4.3.1 WOAS Official audio source webpage
4.3.1 WOAR Official artist/performer webpage
altered functionallity.
MIME type
83.Swing
the signature, the bit should be cleared.
byte order.
result with several frames. The frame begins, after the frame ID,
59.Gangsta
'recommended buffer size' frame should be included in every tag.
them is the 'Picture MIME type' field containing information about
4.11. Comments
4.25. Commercial frame
The 'Original release year' frame is intended for the year when the
/AD ADD
38.Gospel
4.7 MLLT MPEG location lookup table
Setting both premix to $FF would result in a mono output (if the
9. Author's Address
For applications like streaming audio it might be an idea to embed
4.27 GRID Group identification registration
/LW LW
information like artist, album and more. There may only be one text
between what is said in 'bytes between reference' and the reality and
4.4. Involved people list
specified. If a $00 is found directly after the 'Frame size' and the
indicated email address. The tag may contain more than one "PRIV"
official wepage for the publisher.
short description of the picture, represented as a terminated
4.2.1 TRSN Internet radio station name
recording. E.g. "4/9".
symbol' contains a value that associates the frame with this group
excluding "TXXX" described in 4.2.2.>
$FE audio file ends
4.10 SYLT Synchronized lyric/text
Relative volume change, center $xx xx (xx ...)
kinds. Reverb left/right is the delay between every bounce in ms.
4. Declared ID3v2 frames
section 5.
The frame ID is followed by a size descriptor, making a total header
A. Appendix A - Genre List from ID3v1
$14 Publisher/Studio logotype
giving a frequency range of 0 - 32767Hz:
character is forbidden. In ISO-8859-1 a new line is represented, when
part of a set the audio came from. This frame is used if the source
5. The 'unsynchronisation scheme'
49.Gothic
Codes for the representation of names of languages, Part 2: Alpha-3
made. $FF equals an infinite number of bounces. Feedback is the
represented by bit 5 in the increase/decrease field.
of language descriptor directly followed by a content descriptor as
"RBUF" frame in each tag.
C)***Your project wants to link id3lib dynamic: (instructions below for vc)
1 Frame is encrypted.
TPE2
within "(" and ")" and are optionally followed by a text refinement,
tempo codes. Each tempo code consists of one tempo part and one time
'Content descriptor' is a terminated string. If no descriptor is
Software that isn't told otherwise may safely remove such frames. The
TPE2
format of a correct sync that should be altered by ID3 encoders is as
Informal standard M. Nilsson
more than one "WCOM" frame in a tag, but not with the same content.
4.8. Synchronised tempo codes
refinement, e.g. "(21)" or "(4)Eurodisco". Several references can be
contains a frame identifier, which is the frame that should be linked
for more information.
could be used to profile a person's taste and find other 'good' files
Increment/decrement %00xxxxxx
%x0000000 00000000
only used when the files are stored on a CD-ROM or other
thijmen@id3lib.org
as a validator of the subsequent string.
59.Gangsta
of information in the tag. The tag consists of a header, frames and
URL containing an email address, or a link to a location where an
The three byte language field is used to describe the language of the
Description
DCC DCC
$02 Absolute time, 32 bit sized, using milliseconds as unit
exception of the "TXXX" frame. All the text information frames have
Text encoding $xx
30.Fusion
defined in 'bits for bytes deviation', that describes the difference
The equalisation bands should be ordered increasingly with reference
string according to encoding> if newlines are allowed. Any empty
/4 mode 4, 32 kHz/12 bits, 4 channels
36.Game
Language $xx xx xx
4.28. PRIV Private frame
The 'Not predefined sync's ($E0-EF) are for user events. You might
encryption method should be sent to the indicated email address. The
alphabet No. 1. Technical committee / subcommittee: JTC 1 / SC 2
frame header:
5. The 'unsynchronisation scheme'
/19 19 cm/s
for more information.
followed by the actual URL. The URL is always encoded with ISO-8859-1
method byte. These additions to the frame header, while not included
The 'Language(s)' frame should contain the languages of the text or
REE Reel
3.3.2. Default flags
the unsynchronisation scheme should be applied *afterwards*. When
Software that isn't told otherwise may safely remove such frames. The
made in the same frame, e.g. "(51)(39)". If the refinement should
frames, all the frames consists of a frame header followed by one or
nearest byte) for every equalisation band in the following format,
63.Jungle
Time stamp format $xx
/3 MPEG 1/2 layer III
$04 is events (e.g. "Don Quijote enters the stage")
the beginning of every track on the CD should be described with a
And, last but not least, there is a delphi project in cvs
46.Instrumental Pop
Text encoding $xx
4.2.1 TCON Content type
allowed in the comment text string. There may be more than one
the time for the recording. This field is always four characters
the event that the MIME media type name is omitted, "image/" will be
as the numerig content types, e.g. "(RX)".
Position $xx (xx ...)
4.11 COMM Comments
to the same group.
audiofile indeed is encrypted, the whole file may be considered
[ID3v2] Martin Nilsson, "ID3v2 informal standard".
reason, coincidence make a syncsignal appear within the tag it will
81.Folk-Rock
more information about the people behind a remix and similar
change the volume constantly. This frame may also be used to balance
which uses the allready compiled dll.
How to start
followed by encoding, language and content descriptors and is ended
Buffer size $xx xx xx
$02 Absolute time, 32 bit sized, using milliseconds as unit
4) Add /D ID3LIB_LINKOPTION=1 to your project options (settings, C/C++ tab)
more information about the people behind a remix and similar
order. The first beat-stroke in a time-period is at the same time as
9) distribute your program including id3lib.dll
the frames and the headers, in other words the padding. The extended
follows:
in the audio file as text, this time, however, in sync with the
4.13 EQUA Equalization
should not be used for the actual database queries. The string
the frame.
directly related to the contents title (e.g. "Op. 16" or "Performed
The 'Original release year' frame is intended for the year when the
circumstances when the risk of file seperation is low. The frame
made. $FF equals an infinite number of bounces. Feedback is the
Also in there is a file called Id3lib.pas which has the interface to the dll
but other types may be used, not for these types though. This is used
and
4.3.2 WXXX User defined URL link frame
Data Format Specification version 3.3", RFC 1950, May 1996.
4.2.1 TOAL Original album/movie/show title
56.Southern Rock
TPOS
be at least 32-bits long to begin with.
the time for the recording. This field is always four characters
52.Electronic
Newline ($0A) characters are allowed in all "SYLT" frames and should
/A Analog transfer from media
although it is desired that the frames are arranged in order of
set. The formal standard will use another version or revision number
tempo in the music changes, a tempo descriptor may indicate this for
Technical committee / subcommittee: JTC 1 / SC 2
The 'Not predefined sync's ($E0-EF) are for user events. You might
ID3v2/file identifier "ID3"
address can be found, that belongs to the organisation responsible
(representing up to 256MB) are used in the size description to avoid
TIT3
4.14. Reverb
email address can be found, that belongs to the organisation
Picture type $xx
The 'Software/Hardware and settings used for encoding' frame
The version is followed by one the ID3v2 flags field, of which
TEL Telephone
This frame contains a brief description of the terms of use and
4.7. MPEG location lookup table
x - CRC data present
$08 Artist/performer
(C) is one character showing a C in a circle.
email address can be found, that belongs to the organisation
67.Psychadelic
audiofile in a similar way to the other "T"-frames. The frame body
Locators (URL).", RFC 1738, December 1994.
3) make your project dependend on id3lib, and make id3lib dependend on zlib
TCON
4.2.1 TCOP Copyright message
Compressed
This flag indicates wether or not the frame is enrypted. If set
4.3.1. URL link frames - details
$03 is movement/part name (e.g. "Adagio")
The 'Lyricist(s)/Text writer(s)' frame is intended for the writer(s)
These are the directories you'll be needing:
is unavailable or has been removed, and must not be interpreted to
$02 Absolute time, 32 bit sized, using milliseconds as unit
represented by bit 5 in the increase/decrease field.
None.
The 'Owner identifier' is then followed by the actual identifier,
4. Declared ID3v2 frames
chronological order. The type of event is as follows:
than one "AENC" frames in a tag, but only one with the same 'Owner
4.1. Unique file identifier
a - Unsynchronisation
The 'Publishers official webpage' frame is a URL pointing at the
be at least 32-bits long to begin with.
4.2.1 TOFN Original filename
without disturbing old software too much and that ID3v2 should be
occurring in front of the first syllable of a new word. This is also
Unicode strings which are NULL-terminated may have the Unicode BOM
$00.
to ISO 4217 [ISO-4217] alphabetic currency code, followed by a
$01 Absolute time, 32 bit sized, using MPEG [MPEG] frames as unit
[PNG] Portable Network Graphics, version 1.0
b - File alter preservation
4.2.1 TIT1 Content group description
$FF one more byte of events follows (all the following bytes with
byte is inserted in front of the counter thus making the counter
for this specific database implementation. Questions regarding the
symbol' contains a value that associates the frame with this group
character.
26.Ambient
[UNICODE] ISO/IEC 10646-1:1993.
may be several "ENCR" frames in a tag but only one containing the
This frame is intended for one-string text information concerning the
Then for every reference the following data is included;
each tag.
Data Format Specification version 3.3", RFC 1950, May 1996.
encoding have a text encoding description byte directly after the
International Standard Recording Code (ISRC).
DIG Other digital media
Technical committee / subcommittee: JTC 1 / SC 29
The 'Buffer size' should be kept to a minimum. There may only be one
without taking the proper means to compensate, e.g. recalculating
1) Rename config.h.win32 to config.h
by comparing people's profiles. The frame is very simple. It contains
Peak volume right $xx xx (xx ...)
double CD. The value may be extended with a "/" character and a
itself. The 'Size of padding' is simply the total tag size excluding
/FM FM
4.2.1 TOPE Original artist(s)/performer(s)
%abc00000 %ijk00000
4.2.1 TPUB Publisher
/SECAM SECAM
$49 44 33 yy yy xx zz zz zz zz
eight bits bigger in the same away as the play counter ("PCNT").
4.2.1 TPE2 Band/orchestra/accompaniment
4.2.1 TIT3 Subtitle/Description refinement
4.21 AENC Audio encryption
to frequency. All frequencies don't have to be declared. The
Text encoding $xx
4.2.1 TALB Album/Movie/Show title
it is likely to not be readable. The flags field is defined as
TDLY
URL
$01 Absolute time, 32 bit sized, using MPEG [MPEG] frames as unit
/FM FM
The 'Internet radio station owner' frame contains the name of the
Status of this document
/A Analog transfer from media
[JFIF] JPEG File Interchange Format, version 1.02
4.2.1 TEXT Lyricist/Text writer
frame ID, size and encoding fields, with a 'price payed' field. The
$13 refrain end
The ID3v2 tag size is encoded with four bytes where the most
The 'Commercial information' frame is a URL pointing at a webpage
Technical committee / subcommittee: TC 68
if not identical to what is described in this document. The contents
8-bit single-byte coded graphic character sets, Part 1: Latin
The 'Time stamp' is set to zero if directly at the beginning of the
space character (making five characters), is intended for the
/9 9.5 cm/s
83.Swing
to the same group.
Data Format Specification version 3.3", RFC 1950, May 1996.
should be added.
of the text or lyrics in the recording. They are seperated with the
$02 Compressed audio on CD
5. The 'unsynchronisation scheme'
4.5. Music CD identifier
80.Folk
be one "MLLT" frame in each tag.
103.Opera
There is no fixed order of the frames' appearance in the tag,
84.Fast Fusion
'status messages' and the second byte is for encoding purposes. If an
4.4. Involved people list
4.2.1 TSRC ISRC (international standard recording code)
lyrics/text transcription' frame in each tag, but only one with the
1) Rename config.h.win32 to config.h
the introducuction of 'false syncsignals'.
formatted as in the "TYER" frame.
music in the file should be a cover of a previously released song.
Compiling on win32:
official wepage for the publisher.
100.Humour
4.25 COMR Commercial frame
database that may contain more information relevant to the content.
WOAF
contains a frame identifier, which is the frame that should be linked
4.2.1 TCOM Composer
4.2.1 TPE2 Band/orchestra/accompaniment
counter thus making the counter eight bits bigger. The counter must
frame's content, according to ISO-639-2 [ISO-639-2].
or assist in its implementation may be prepared, copied, published
consists of a description of the string, represented as a terminated
contains a terminated string with the involvement directly followed
This flag indicates wether or not the frame is enrypted. If set
72.Tribal
ID3v2 tag as compatible as possible with existing software. There is
following structure:
[URL] T. Berners-Lee, L. Masinter & M. McCahill, "Uniform Resource
$0F sustained noise end
4.3.1 WOAR Official artist/performer webpage
symbol' may optionally be followed by some group specific data, e.g.
/3 MPEG 1/2 layer III
4.7. MPEG location lookup table
frame header:
bytes. All unused flags must be cleared. The first byte is for
TCOP
78.Rock & Roll
These are the directories you'll be needing:
a content descriptor. The body consists of the actual text. The
6.Grunge
Also in there is a file called Id3lib.pas which has the interface to the dll
/A Analog transfer from media
/A Analog transfer from media
%x0000000 00000000
size of ten bytes in every frame. The size is calculated as frame
be used after every entry (name, event etc.) in a frame with the
62.Pop/Funk
one with the same contents. A linked frame is to be considered as
16-bit unicode 2.0 (ISO/IEC 10646-1:1993, UCS-2). Unicode strings
to the existing frame, after the center channel. The bass channel is
4.1. Unique file identifier
others, and derivative works that comment on or otherwise explain it
"POSS" frame in each tag.
Copyright (C) Martin Nilsson 1998. All Rights Reserved.
/AAC Advanced audio compression
picture is to attach.
begin with "T". Only text frame identifiers begin with "T", with the
Content descriptor
break something, e.g. a signature. If the contents are changed,
each tag.
66.New Wave
Text encoding $xx
4.26. Encryption method registration
audio file, frames with timecodes in different locations in the file
in a similar way to the predefined types in the "TMED" frame, but
Frame identifier $xx xx xx
followed by a Unicode NULL ($FF FE 00 00 or $FE FF 00 00).
Document: id3v2.3.0.txt 3rd February 1999
section 5.
specific webpage.
6. Copyright
115.Folklore
altered, so they won't be affected by the decoding process. Therefore
version number and a size descriptor in the ID3v2 header.
$FD audio end (start of silence)
TIT2
/AD ADD
amount of volume that should be returned to the next echo bounce. $00
The 'Official artist/performer webpage' frame is a URL pointing at
each in their individual "APIC" frame, but only one with the same
by comparing people's profiles. The frame is very simple. It contains
frame size. If ISO-8859-1 is used this byte should be $00, if Unicode
1. Table of contents
and
kind, provided that a reference to this document is included on all
This document describes the ID3v2.3.0, which is a more developed
[ISRC] ISO 3901:1986
$01 Absolute time, 32 bit sized, using MPEG frames as unit
The 'Content group description' frame is used if the sound belongs to
4.2.1 TDLY Playlist delay
The following genres is defined in ID3v1
character, but there may only be one currency of each type.
smaller than the size given in the head of the tag. A possible
%abc00000 %ijk00000
This flag indicates wether or not the frame is enrypted. If set
89.Bluegrass
part of a set the audio came from. This frame is used if the source
audiofile indeed is encrypted, the whole file may be considered
TEXT
TMED
/A Analog transfer from media
Locators (URL).", RFC 1738, December 1994.
4.28. Private frame
into this tag, a URL [URL] field, where a reference to the file where
"RBUF" frame in each tag.
How to start
4.7. MPEG location lookup table
45.Meditative
followed by a Unicode NULL ($FF FE 00 00 or $FE FF 00 00).
124.Euro-Hous without taking the proper means to compensate, e.g. recalculating
audio stream. In these cases, the size of the buffer can be
'Premix left to right' is the amount of left sound to be mixed in the
$49 44 33 yy yy xx zz zz zz zz
RX Remix
4.2.1 TRCK Track number/Position in set
'Method symbol' contains a value that is associated with this method
TIT2
syllable (or whatever size of text is considered to be convenient by
entered, 'Content descriptor' is $00 (00) only. Newline characters
Technical committee / subcommittee: JTC 1 / SC 29
The 'Buffer size' should be kept to a minimum. There may only be one
Contact URL
4.17. Play counter
The use of linked files should however be used sparingly since there
8.Jazz
4.4. Involved people list
be described with the 'Peak volume right' and 'Peak volume left'
34.Acid
Copyright (C) Martin Nilsson 1998. All Rights Reserved.
either used or reserved for future use.
And, last but not least, there is a delphi project in cvs
Milliseconds between reference $xx xx xx
4.25. Commercial frame
regarding the encrypted audio should be sent to the email address
four bytes absolute CD-frame address per track, and not with absolute
TCOM
3.3.1. Frame header flags
'recommended buffer size' frame should be included in every tag.
information about encryption method registration.
If nothing else is said a string is represented as ISO-8859-1
content. The most significant bit (MSB) of a byte is called 'bit 7'
the transaction, encoded according to ISO 4217 [ISO-4217] alphabetic
$01 32x32 pixels 'file icon' (PNG only)
/2.5 MPEG 2.5
'Frame size' and 'Encoding' follows 'MIME type' [MIME] represented as
4.15. Attached picture
media type, e.g. "(CD/A)" or "(VID/PAL/VHS)".
Extensions (MIME) Part One: Format of Internet Message Bodies",
$01 end of initial silence
TOWN
Terminating the start events such as "intro start" is not required.
4.16. General encapsulated object
3.3.2. Default flags
6) (add your code which uses id3lib)
appears in a file. Numbers preceded with $ are hexadecimal and
$01 Absolute time, 32 bit sized, using MPEG [MPEG] frames as unit
PCM Pulse Code Modulated audio
as the numerig content types, e.g. "(RX)".
The two biggest design goals were to be able to implement ID3v2
streamed.
The default settings for the frames described in this document can be
character is forbidden. In ISO-8859-1 a new line is represented, when
4.3. URL link frames
$01 end of initial silence
described in the "TALB" frame is divided into several mediums, e.g. a
The 'Original lyricist(s)/text writer(s)' frame is intended for the
The 'Size' frame contains the size of the audiofile in bytes,
[PNG] Portable Network Graphics, version 1.0
performer(s) of the original recording, if for example the music in
recommended by the server using this frame. If the 'embedded info
not be broken apart with a sync (both the syllable and the comma
three characters according to ISO-639-2. If more than one language is
The tempo descriptor is followed by a time stamp. Every time the
character, but there may only be one currency of each type.
in a similar way to the predefined types in the "TMED" frame, but
counter, intended to be increased with one for every time the file is
4.15. Attached picture
it is likely to not be readable. The flags field is defined as
The 'Original lyricist(s)/text writer(s)' frame is intended for the
music in the file should be a cover of a previously released song.
The 'Publisher' frame simply contains the name of the label or
The 'Official internet radio station homepage' contains a URL
Code [ISRC] (12 characters).
Text encoding $xx
4.2.2 TXXX User defined text information frame
database that may contain more information relevant to the content.
107.Booty Bass
This frame indicates if the actual audio stream is encrypted, and by
within "(" and ")" and are optionally followed by a text refinement,
/IV Type IV cassette (metal)
Reverb right (ms) $xx xx
adjust the audio. If the volume peak levels are known then this could
without parentheses. If this frame is not present audio type is
containing the order number of the audio-file on its original
17.Rock
URL
content type $03 - $04.
part of a set the audio came from. This frame is used if the source
$05 Leaflet page
/II Type II cassette (chrome)
31.Trance
represented as $00 00 02 01.
4.12. Relative volume adjustment
This is another subjective, alignment frame. It allows the user to
$12 Illustration
ID3v2 tag as compatible as possible with existing software. There is
$06 verse start
Bits for milliseconds dev. $xx
be one "EQUA" frame in each tag.
$14 theme end
Encoding: $00 ISO-8859-1 [ISO-8859-1] character set is used => $00
MPEG 2 layer I, II and III [MPEG] and MPEG 2.5. This value may not be
to the first giving a range from 2 - 510 BPM, since $00 and $01 is
occurring in front of the first syllable of a new word. This is also
file, since some media doesn't allow the desired length of the
Each reference consists of two parts; a certain number of bits, as
the types as ID3v1.1 did or, since the category list would be
three or higher it should simply ignore the whole tag. Version and
Text encoding $xx
/76 76 cm/s
60.Top 40
4.18 POPM Popularimeter
excluding the ID3v2 tag, represented as a numeric string.
This frame delivers information to the listener of how far into the
content types is defined in ID3v2 and is implemented in the same way
separating words should mark the beginning of a new word, thus
the frame is given, and additional ID data, if needed. Data should be
$01 is lyrics
each channel while the file is played. The purpose is to be able to
7) Compile.
The bitorder in ID3v2 is most significant bit first (MSB). The
TEXT
[ID3v2] Martin Nilsson, "ID3v2 informal standard".
91.Gothic Rock
ended with a ")" character. This is optionally followed by a
4.14. Reverb
29.Jazz+Funk
comment frame in each tag, but only one with the same language and
rewrite the entire file. The value of the padding bytes must be $00.
4.2.1 TPE1 Lead performer(s)/Soloist(s)
entered, 'Content descriptor' is $00 (00) only. Newline characters
Content descriptor
$11 mainpart end
The 'Buffer size' should be kept to a minimum. There may only be one
string containing the total numer of tracks/elements on the original
%11111111 111xxxxx
defined.
between the values in this frame. Three equal adjustments for three
4.22. Position synchronisation frame
/78 78.26 rpm
The 'Internet radio station owner' frame contains the name of the
strings may be omitted, leaving only their terminations. MIME type is
section 3.2.
The 'Internet radio station owner' frame contains the name of the
for this specific database implementation. Questions regarding the
$E0-$EF not predefined sync 0-F
$14 theme end
bytes. All unused flags must be cleared. The first byte is for
90.Avantgarde
CR Cover
$05 outro end
the software that encounters them. At the start of every frame there
$00.
unknown and the file, excluding the tag, is altered. This does not
attributes of the tag. These attributes are currently defined as
The header is:
$06 verse start
119.Freestyle
and distributed, in whole or in part, without restriction of any
in the audio file as text, this time, however, in sync with the
numerical value where "." is used as decimal seperator. In the price
4.4. Involved people list
mainpart of the audio. The BPM is an integer and represented as a
Flags $xx xx
part. The tempo is in BPM described with one or two bytes. If the
4.2.1 TORY Original release year
58.Cult
responsible for this specific encrypted audio file. Questions
35.House
be one "MLLT" frame in each tag.
Coding of moving pictures and associated audio for digital storage
Terminated strings are terminated with $00 if encoded with ISO-8859-1
begins with "W". All URL link frames have the following format:
reverb is applied symmetric). There may only be one "RVRB" frame in
$01 end of initial silence
/PAL PAL
4.27. Group identification registration
responsible for this specific encrypted audio file. Questions
recording(/source of sound) which the audio in the file is taken
TENC
Picture type: $00 Other
of information in the tag. The tag consists of a header, frames and
/78 78.26 rpm
numeric string containing the total number of parts in the set. E.g.
flags' should be set. This bit should only be set if the tag
is unavailable or has been removed, and must not be interpreted to
4.16. General encapsulated object
others, and derivative works that comment on or otherwise explain it
by a terminated string with a short description of the product. The
end of the ID3 tag), making the size of all the frames together
to the same group.
119.Freestyle
stage or on the screen in sync with the audio. The header includes a
To identify with which method a frame has been encrypted the
TPE1
TSIZ
Compressed
number of "PRIV" frames as low as possible.
be used after every entry (name, event etc.) in a frame with the
The 'Publisher' frame simply contains the name of the label or
4.2.2 TXXX User defined text information frame
Name of seller
120.Duet
(debug) /nodefaultlib:"MSVCRTD" or(release) /nodefaultlib:"MSVCRT"
IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF
Text encoding $xx
RX Remix
RAD Radio
nearest byte) for every equalisation band in the following format,
120.Duet
Owner identifier
follows.
binary picture data. This two last fields may be omitted if no
attributes of the tag. These attributes are currently defined as
4.15. Attached picture
4) Add /D ID3LIB_LINKOPTION=1 to your project options (settings, C/C++ tab)
representation of the adjustment. This is normally $10 (16 bits) for
subject to unsynchronisation.
kinds of alterations, including adding more padding and reordering
If the bass channel adjustment is present the following is appended
which uses the allready compiled dll.
frame identifiers begins with "W". Only URL link frame identifiers
header is considered separate from the header proper, and as such is
Group dependent data
Owner identifier
than one "AENC" frames in a tag, but only one with the same 'Owner
Description
$15-$DF reserved for future use
[PNG] Portable Network Graphics, version 1.0
This frame contains a picture directly related to the audio file.
information blocks, called frames, whose format need not be known to
63.Jungle
$14 theme end
16-bit unicode 2.0 (ISO/IEC 10646-1:1993, UCS-2). Unicode strings
4. Preserved if tag is altered, preserved if file is altered.
ID3 tag version 2.3.0
contains a, now corrected, false synchronisation. The bit should
117.Power Ballad
Reverb left (ms) $xx xx
4.2.2 TXXX User defined text information frame
with information such as where the album can be bought. There may be
Owner identifier
number of "PRIV" frames as low as possible.
4.15. Attached picture
/76 76 cm/s
$02 Absolute time, 32 bit sized, using milliseconds as unit
The Second one (id3lib/libprj) creates the .lib file for static linking.
4.2.1 TYER Year
The following type and refinements are defined:
information, such as equalisation curves, as well as related meta
A tag must contain at least one frame. A frame must be at least 1
audiofile in a similar way to the other "T"-frames. The frame body
WPAY
that its program uses and does not fit into the other frames. The
Peak volume bass $xx xx (xx ...)
header in the same order as the flags indicating the additions. I.e.
4.2.1 TOPE Original artist(s)/performer(s)
$05 outro end
This document describes the ID3v2.3.0, which is a more developed
exception of the "TXXX" frame. All the text information frames have
(debug) /nodefaultlib:"libcd" or(release) /nodefaultlib:"libc"
by a terminated string with a short description of the product. The
and MPEG-2.5, but may work with other types of encoded audio.
i.e. the beginning of the next frame. If this frame is used in the
directly related to the contents title (e.g. "Op. 16" or "Performed
frame, if present, to skip initial silence and silence at the end of
4.2.1 TOPE Original artist(s)/performer(s)
TDAT
syncsignal, no software will attempt to play the tag. If, for any
format of a correct sync that should be altered by ID3 encoders is as
but may be empty. There may be several pictures attached to one file,
Text encoding $xx
The three byte language field is used to describe the language of the
Size of padding $xx xx xx xx
/NTSC NTSC
$01 Standard CD album with other songs
long.
contains a terminated string with the involvement directly followed
characters 0-9 only.
to the first giving a range from 2 - 510 BPM, since $00 and $01 is
between every song in a playlist. The player should use the "ETC"
4.2.1 TALB Album/Movie/Show title
Lyrics/text
WOAR
string with a URL [URL] containing an email address, or a link to a
and
string, followed by the actual string. There may be more than one
Price string
$0C Lyricist/text writer
last thing is the ability to include a company logotype. The first of
All the other flags should be cleared. If one of these undefined
xx "glan" $00 xx xx "ces" $00 xx xx
The 'BPM' frame contains the number of beats per minute in the
WOAR
4.27 GRID Group identification registration
exception of the "TXXX" frame. All the text information frames have
in a similar way to the predefined types in the "TMED" frame, but
Reverb feedback, left to right $xx
information should be ignored and not be displayed. All URL link
Left to left means the sound from the left bounce to be played in the
4.6. Event timing codes
TPE4
4.2.1 TFLT File type
play. There may only be one "PCNT" frame in each tag. When the
should be sorted in chronological order. The sync can be considered
10.New Age
the beat description occurs. There may only be one "SYTC" frame in
Followed by a list of key events in the following format:
format YYYYMMDD, describing for how long the price is valid. After
MC MC (normal cassette)
single beat-stroke followed by a beat-free period.
4.19. Recommended buffer size
filename. The filename is case sensitive and includes its suffix.
4.2.1. Text information frames - details
21.Ska
'lock on to' the audio. Since the ID3v2 tag doesn't contain a valid
'bytes between reference' and 'milliseconds between reference' points
Bits for milliseconds dev. $xx
16.Reggae
28.Vocal
Frame identifier $xx xx xx
8-bit single-byte coded graphic character sets, Part 1: Latin
TENC
or, if signed, as proof. Note that the "USER" and "TOWN" frames are
This flag indicates wether or not the frame is enrypted. If set
88.Celtic
$08 interlude start
/9 9.5 cm/s
k - Grouping identity
Description
must begin with the Unicode BOM ($FF FE or $FE FF) to identify the
B)***Your project wants to link id3lib static, and has mfc linked dynamic or has no MFC:
same language and content descriptor.
TLAN
4. Declared ID3v2 frames
The 'adjustment bits' field defines the number of bits used for
unsychronisation, including padding, excluding the header but not
$0D momentary unwanted noise (Snap, Crackle & Pop)
Text encoding $xx
in a tag, but only one with the same 'Owner identifier'.
ID3v2 tag as compatible as possible with existing software. There is
containing an email address, or a link to a location where an email
1 Frame is encrypted.
and distributed, in whole or in part, without restriction of any
4.23. Terms of use
LD Laserdisc
[UNICODE] ISO/IEC 10646-1:1993.
The version is followed by one the ID3v2 flags field, of which
their usage.
the user to say how much he wants to increase/decrease the volume on
4.27 GRID Group identification registration
TCOP
1 Frame should be discarded.
follows
Time stamp $xx (xx ...)
containing an email address, or a link to a location where an email
Do bear in mind, that if a compression scheme is used by the encoder,
divided into the following classes. The flags may be set differently
A few considerations regarding whitespace characters: Whitespace
the tag with this frame. The 'Owner identifier' is a null-terminated
The third bit (bit 5) should be used as an 'experimental
altered, so they won't be affected by the decoding process. Therefore
significant bit (bit 7) is set to zero in every byte, making a total
$01 Absolute time, 32 bit sized, using MPEG [MPEG] frames as unit
entered, 'Content descriptor' is $00 (00) only. Newline characters
represented as
TIT1
Embedded info flag %0000000x
contains a frame identifier, which is the frame that should be linked
in a similar way to the predefined types in the "TMED" frame, but
The absence of this frame means only that the copyright information
73.Acid Punk
The 'Payment' frame is a URL pointing at a webpage that will handle
Size of padding $xx xx xx xx
Text encoding $xx
1 Frame should be discarded.
as the numerig content types, e.g. "(RX)".
Image format is the MIME type and subtype [MIME] for the image. In
Code [ISRC] (12 characters).
reverb is applied symmetric). There may only be one "RVRB" frame in
/WAC Wax cylinder
described.
be left zeroed. After the 'preview length' field follows optionally a
Owner identifier
Content type $xx
Tempo data
The version is followed by one the ID3v2 flags field, of which
three characters according to ISO-639-2. If more than one language is
software with ID3v2.2.0 and below support should encounter version
space character (making five characters), is intended for the
bytes. All unused flags must be cleared. The first byte is for
contains a terminated string with the involvement directly followed
The 'Part of a set' frame is a numeric string that describes which
and free for everyone to use, without the need to set the
4.2. Text information frames
possibility to put only a link to the image file by using the 'MIME
CD TOC
3.1. ID3v2 header
but it's an easier solution than if one tries to achieve the same
each tag.
4.2.1 TCOM Composer
Generic coding of moving pictures and associated audio information,
Picture data
organisation that encoded the audio file. This field may contain a
predefine an equalisation curve within the audio file. There may only
Picture type $xx
within "(" and ")" and are optionally followed by a text refinement,
3.3. ID3v2 frames overview
follows
Codes for the representation of names of languages, Part 2: Alpha-3
reverb is applied symmetric). There may only be one "RVRB" frame in
padded in the beginning (highest bits) when 'bits used for volume
There may be more than one "POPM" frame in each tag, but only one
[ISO-8859-1]. There may be more than one "WXXX" frame in each tag,
/II Type II cassette (chrome)
j - Encryption
Rating $xx
49.Gothic
frame header:
and
the types as ID3v1.1 did or, since the category list would be
a certain number of bits, as defined in 'bits for milliseconds
The three byte language field is used to describe the language of the
Data Format Specification version 3.3", RFC 1950, May 1996.
4.2.1 TRCK Track number/Position in set
4.22 POSS Position synchronisation frame
Contact URL
The 'File owner/licensee' frame contains the name of the owner or
77.Musical
the frame.
The 'time stamp' is set to zero or the whole sync is omitted if
4.2. Text information frames
a content description as terminated string, encoded as 'Encoding'.
allowed, with $0A only. Frames that allow different types of text
4.21. Linked information
TIT1
Sync identifier (terminator to above string) $00 (00)
None.
4.2.1 TCOP Copyright message
Text encoding $xx
followed by encoding, language and content descriptors and is ended
frame might be used. After the header follows one byte describing
TDAT
$12 verse end
Part 3: Audio.
After the 'Owner identifier', a pointer to an unencrypted part of the
TMED
None.
$01 Absolute time, 32 bit sized, using MPEG frames as unit
but may be empty. There may be several pictures attached to one file,
/DD DDD
of the seller as the last field in the frame. There may only be one
The frame ID made out of the characters capital A-Z and 0-9.
$06 Media (e.g. lable side of CD)
of the text or lyrics in the recording. They are seperated with the
involvement and so on. There may only be one "IPLS" frame in each
type declared as picture type $01 and $02 respectively. There is the
/9 9.5 cm/s
audio file, frames with timecodes in different locations in the file
used in the text their language codes should follow according to
33.Instrumental
70.Trailer
be at least 32-bits long to begin with.
The 'Lead artist(s)/Lead performer(s)/Soloist(s)/Performing group' is
the beat description occurs. There may only be one "SYTC" frame in
size descriptor that allows software to skip unknown frames.
112.Club
TPUB
This frame contains a brief description of the terms of use and
the first frame in the stream. The frame layout is:
The 'Original lyricist(s)/text writer(s)' frame is intended for the
Text encoding $xx
file, is 10 bytes as follows:
in the audio file as text, this time, however, in sync with the
/A Analog transfer from media
size of ten bytes in every frame. The size is calculated as frame
TDLY
altered, so they won't be affected by the decoding process. Therefore
/80 80 rpm
revoked.
/I ISDN
/A Analog transfer from media
between every song in a playlist. The player should use the "ETC"
'Frame size' and 'Encoding' follows 'MIME type' [MIME] represented as
$01 Absolute time, 32 bit sized, using MPEG frames as unit
increase for every reference. If this value is two then the first
124.Euro-Hous Frames that may be linked and need no additional data are "IPLS",
be one "RVAD" frame in each tag.
4.4. Involved people list
is an identifier that explains the frames' format and content, and a
Extensions (MIME) Part One: Format of Internet Message Bodies",
tags into the audio stream though. If the clients connects to
ID3v2 tag as compatible as possible with existing software. There is
audio stream. In these cases, the size of the buffer can be
/A Analog transfer from media
copyright holder of the original sound, not the audio file itself.
The 'Size' frame contains the size of the audiofile in bytes,
The header is:
bytes. These flags are described in section 3.3.1.
$01 end of initial silence
9. Author's Address
Size of padding $xx xx xx xx
/VHS VHS
Bits for bytes deviation $xx
altered functionallity.
[ISO-8859-1] characters in the range $20 - $FF. Such strings are
tempo in the music changes, a tempo descriptor may indicate this for
21.Ska
organisation that encoded the audio file. This field may contain a
contains a frame identifier, which is the frame that should be linked
Valid until
WOAR
4.26. Encryption method registration
Time stamp format $xx
/8CA 8-track tape cassette
'lock on to' the audio. Since the ID3v2 tag doesn't contain a valid
to ISO 4217 [ISO-4217] alphabetic currency code, followed by a
the same content.
revision will never be $FF.
[URL] T. Berners-Lee, L. Masinter & M. McCahill, "Uniform Resource
As the tag consists of a tag header and a tag body with one or more
exception of the "TXXX" frame. All the text information frames have
Bits for bytes deviation $xx
frames, all the frames consists of a frame header followed by one or
a larger category of sounds/music. For example, classical music is
4.3.1 WOAS Official audio source webpage
[ISO-8859-1] ISO/IEC DIS 8859-1.
Relative volume change, right back $xx xx (xx ...)
the beginning of every track on the CD should be described with a
102.Chanson
divided into the following classes. The flags may be set differently
containing an email address, or a link to a location where an email
then the first should be 'replaced' with the second.
as a terminated string encoded with ISO 8859-1 [ISO-8859-1]. The
frame ID, size and encoding fields, with a 'price payed' field. The
3.2. ID3v2 extended header
address can be found, that belongs to the organisation responsible
textstring. The description has a maximum length of 64 characters,
from.
Rating $xx
revision will never be $FF.
$E0-$EF not predefined sync 0-F
15.Rap
4. Preserved if tag is altered, preserved if file is altered.
part of the tag (i.e. only one "RVRB" frame allowed, whether it's
1) Rename config.h.win32 to config.h
The 'Subtitle/Description refinement' frame is used for information
the frame is given, and additional ID data, if needed. Data should be
of information in the tag. The tag consists of a header, frames and
revisions are backwards compatible while major versions are not. If
counter reaches all one's, one byte is inserted in front of the
but if you got it working on Borland or other compilers, drop me a mail, or better, add a patch
'Frame size' and 'Encoding' follows 'MIME type' [MIME] represented as
time. This frame requires a present and valid "TRCK" frame, even if
15.Rap
/6 mode 6, 44.1 kHz/16 bits, 'wide track' play
$01 Unicode [UNICODE] character set is used => $00 00 is
4. Declared ID3v2 frames
TRDA
The 'Software/Hardware and settings used for encoding' frame
Every tag that is picked up after the initial/first tag is to be
/I
The equalisation bands should be ordered increasingly with reference
The 'Playlist delay' defines the numbers of milliseconds of silence
$0F During performance
4.23. Terms of use frame
$01 Standard CD album with other songs
combination during the unsynchronisation.
same language and content descriptor.
organisation that encoded the audio file. This field may contain a
and free for everyone to use, without the need to set the
$01 Absolute time, 32 bit sized, using MPEG [MPEG] frames as unit
/6 mode 6, 44.1 kHz/16 bits, 'wide track' play
/II Type II cassette (chrome)
TSIZ
descriptor is entered, 'Content descriptor' is $00 (00) only.
play. There may only be one "PCNT" frame in each tag. When the
j - Encryption
4) Add /D ID3LIB_LINKOPTION=1 to your project options (settings, C/C++ tab)
The 'Software/Hardware and settings used for encoding' frame
the software that encounters them. At the start of every frame there
"Strangers in the night" $0A "Exchanging glances"
break something, e.g. a signature. If the contents are changed,
the file should be a cover of a previously released song. The text
decoding software uses a syncsignal, embedded in the audiostream, to
altered functionallity.
information, such as equalisation curves, as well as related meta
The ID3 tag described in this document is mainly targeted at files
2.Country
be at least 32-bits long to begin with.
size descriptor that allows software to skip unknown frames.
performer(s) of the original recording, if for example the music in
85.Bebob
70.Trailer
"Strang" $00 xx xx "ers" $00 xx xx " in" $00 xx xx " the" $00 xx xx
$0A variation start
The Second one (id3lib/libprj) creates the .lib file for static linking.
101.Speech
$49 44 33 yy yy xx zz zz zz zz
should be before the sync).
allowed in the comment text string. There may be more than one
/I Type I cassette (ferric/normal)
Language $xx xx xx
Bits for bytes deviation $xx
contains a terminated string with the involvement directly followed
4.15. Attached picture
but other types may be used, not for these types though. This is used
Every tag that is picked up after the initial/first tag is to be
Encryption data
recommended by the server using this frame. If the 'embedded info
which picture format is used. In the event that the MIME media type
symbol' contains a value that associates the frame with this group
The 'Buffer size' should be kept to a minimum. There may only be one
consists of a binary dump of the Table Of Contents, TOC, from the CD,
reserved. $00 is used to describe a beat-free time period, which is
This is a more subjective function than the previous ones. It allows
$F0-$FC reserved for future use
$01 Standard CD album with other songs
The 'Subtitle/Description refinement' frame is used for information
TPE1
$0C time change
The purpose of this frame is to specify how good an audio file is.
beginning of the file.
$01 Unicode [UNICODE] character set is used => $00 00 is
information, such as title, performer, copyright etc.
organisation responsible for this grouping. Questions regarding the
header is a descriptor of how much the 'frame counter' should
This frame is indended for any kind of full text information that
$0D Recording Location
optional padding. A field is a piece of information; one value, a
Text encoding $xx
76.Retro
in a tag, but only one with the same 'Owner identifier'.
without knowledge in why the frame was flagged read only and
[JFIF] JPEG File Interchange Format, version 1.02
encoded. Hardware refers to hardware encoders, not the computer on
4.9. Unsychronised lyrics/text transcription
In the frame header the size descriptor is followed by two flags
transmission or coding problems resulting in interruptions in the
This frame enables several competing offers in the same tag by
This is a more subjective function than the previous ones. It allows
by new software. Unsynchronisation may only be made with MPEG 2 layer
If a frame is longer than it should be, e.g. having more fields than
c - Experimental indicator
$02 is text transcription
audio stream. In these cases, the size of the buffer can be
This frames is always four characters long (until the year 10000).
And the third one (id3lib/id3com) creates a dll with com interface. A Visual basic demo using it is included.
$02 intro start
predefined media types found in the list below. References are made
1 Frame is encrypted.
In this frame any type of file can be encapsulated. After the header,
40.AlternRock
other vocal activities. The head includes an encoding descriptor and
beginning of a file the value is always 0. There may only be one
Owner identifier
As the tag consists of a tag header and a tag body with one or more
the frames and the headers, in other words the padding. The extended
A. Appendix A - Genre List from ID3v1
4.20. Audio encryption
Text encoding $xx
The following type and refinements are defined:
4.3.1 WCOP Copyright/Legal information
RX Remix
organisation that encoded the audio file. This field may contain a
revoked.
Content descriptor
There may be more than one "POPM" frame in each tag, but only one
of the seller as the last field in the frame. There may only be one
Generic coding of moving pictures and associated audio information,
counter thus making the counter eight bits bigger. The counter must
be left zeroed. After the 'preview length' field follows optionally a
/A Analog transfer from media
Unicode strings which are NULL-terminated may have the Unicode BOM
/5 mode 5, 44.1 kHz/16 bits, linear
out bytes and milliseconds respectively.
85.Bebob
67.Psychadelic
software with ID3v2.2.0 and below support should encounter version
starts. It is represented as a string with a maximum length of three
3.3.2. Default flags
Distribution of this document is unlimited.
DVD DVD
The ownership frame might be used as a reminder of a made transaction
Text encoding $xx
28.Vocal
The second bit (bit 6) indicates whether or not the header is
The following type and refinements are defined:
5) Add the following include dirs to your program:
3.2. ID3v2 extended header
Text encoding $xx
string containing the total numer of tracks/elements on the original
Picture type $xx
79.Hard Rock
audio file, frames with timecodes in different locations in the file
the process of paying for this file.
ID3v2 version $03 00
4.27 GRID Group identification registration
/A Analog transfer from media
type declared as picture type $01 and $02 respectively. There is the
in a project. The 'Involved people list' is a frame containing the
DCC DCC
frame, the 3rd reference the 6th frame etc. In a similar way the
indicates usage.
[ID3v2] Martin Nilsson, "ID3v2 informal standard".
the piece (e.g. "Adagio", "Hurricane Donna").
and MPEG-2.5, but may work with other types of encoded audio.
URL
4.28. Private frame
of the original recording (or source of sound), if for example the
in a tag if the audio contains more than one performer, but not with
Bits for bytes deviation $xx
The header is:
The third one is not too much tested, it was created outside this project but
/I Type I cassette (ferric/normal)
revision will never be $FF.
frame identifiers begins with "W". Only URL link frame identifiers
webpage where the terms of use and ownership of the file is
61.Christian Rap
/71 71.29 rpm
the frame is given, and additional ID data, if needed. Data should be
(debug) /nodefaultlib:"MSVCRTD" or(release) /nodefaultlib:"MSVCRT"
WPAY
The 'Initial key' frame contains the musical key in which the sound
playlist that features better audiofiles more often than others or it
additional information. This information will be added to the frame
4.1. Unique file identifier
be at least 32-bits long to begin with.
one byte indicating with which method it was encrypted will be
$49 44 33 yy yy xx zz zz zz zz
bytes. These flags are described in section 3.3.1.
This is another subjective, alignment frame. It allows the user to
The frame ID is followed by a size descriptor, making a total header
Reverb feedback, left to right $xx
TLAN
Extensions (MIME) Part One: Format of Internet Message Bodies",
byte big, excluding the header.
%abc00000 %ijk00000
13.Pop
frame size. If ISO-8859-1 is used this byte should be $00, if Unicode
different programs may require different 'nodefaultlib' 's, or none at all, these worked for me.
TDLY
The 'Subtitle/Description refinement' frame is used for information
The 'Content group description' frame is used if the sound belongs to
86.Latin
4.19. Recommended buffer size
This frame delivers information to the listener of how far into the
follows
59.Gangsta
play. There may only be one "PCNT" frame in each tag. When the
subsequent frequencies. A frequency should only be described once in
4.2.1 TIT1 Content group description
/80 80 rpm
For applications like streaming audio it might be an idea to embed
reverb is applied symmetric). There may only be one "RVRB" frame in
subject to unsynchronisation.
The 'Lyricist(s)/Text writer(s)' frame is intended for the writer(s)
$0F sustained noise end
Thijmen
played. The email is a terminated string. The rating is 1-255 where
Text encoding $xx
$07 refrain start
4.3.2 WXXX User defined URL link frame
/DD DDD
$01 Absolute time, 32 bit sized, using MPEG [MPEG] frames as unit
starts. It is represented as a string with a maximum length of three
4.3.1 WORS Official internet radio station homepage
with information such as where the album can be bought. There may be
and distributed, in whole or in part, without restriction of any
96.Big Band
Abolute time means that every stamp contains the time from the
Where yy is less than $FF, xx is the 'flags' byte and zz is less than
file or alone in a binary file. It is recommended that this method is
4.24. Ownership frame
as a numeric string.
thijmen@id3lib.org
4.3.1 WCOP Copyright/Legal information
music in the file should be a cover of a previously released song.
4.18 POPM Popularimeter
and the least significant bit (LSB) is called 'bit 0'.
47.Instrumental Rock
should not be used for the actual database queries. The string
A few considerations regarding whitespace characters: Whitespace
The 'File owner/licensee' frame contains the name of the owner or
frames or enlarge existing frames within the tag without having to
For applications like streaming audio it might be an idea to embed
4.10 SYLT Synchronized lyric/text
explosion on-stage, turning on your screensaver etc.
How to start
4.26 ENCR Encryption method registration
break something, e.g. a signature. If the contents are changed,
copyright holder of the original sound, not the audio file itself.
Sometimes the server from which a audio file is streamed is aware of
does not fit in any other frame. It consists of a frame header
4.10 SYLT Synchronized lyric/text
To indicate usage of the unsynchronisation, the first bit in 'ID3
The absence of this frame means only that the copyright information
[ISO-8859-1] characters in the range $20 - $FF. Such strings are
standard [ID3v2]. The informal standard is released so that
encoding have a text encoding description byte directly after the
not be modified in any way and reissued as the original document.
4.2.1 TLEN Length
$09 theme start
$12 verse end
60.Top 40
The 'Publishers official webpage' frame is a URL pointing at the
The 'Size' frame contains the size of the audiofile in bytes,
audio is delivered when bought according to the following list:
content descriptor. There may only be one picture with the picture
$04 Stream over the Internet
Sometimes the server from which a audio file is streamed is aware of
represented as $00 00 02 01.
Description
$05 Leaflet page
between the values in this frame. Three equal adjustments for three
TPE3
various ways, such as musicians and technicians, the 'Text
7. References
exception of the "TXXX" frame. All the text information frames have
padded in the beginning (highest bits) when 'bits used for volume
information frame of its kind in an tag. If the textstring is
should not be used for the actual database queries. The string
Bits used for volume descr. $xx
RFC 2045, November 1996.
4.24. Ownership frame
Position $xx (xx ...)
/33 33.33 rpm
4.2.1 TIT2 Title/songname/content description
The original location is http://sourceforge.net/projects/id3com
The default settings for the frames described in this document can be
Software that isn't told otherwise may safely remove such frames. The
by a terminated string with the involvee followed by a new
124.Euro-Hous $01 Absolute time, 32 bit sized, using MPEG [MPEG] frames as unit
4.2.1 TPE3 Conductor/performer refinement
79.Hard Rock
to the existing frame, after the center channel. The bass channel is
For a more accurate description of the tempo of a musical piece this
characters. The ground keys are represented with "A","B","C","D","E",
DIG Other digital media
channel and bit 1 is used to indicate the left channel. 1 is
So far, it has only been confirmed it compiles on visual C 6.0 (service pack 5),
4.8. Synced tempo codes
114.Samba
MIME type
Compressed
Valid until
consists of a binary dump of the Table Of Contents, TOC, from the CD,
revision will never be $FF.
reserved. $00 is used to describe a beat-free time period, which is
/AD ADD
The 'Encoded by' frame contains the name of the person or
Reverb feedback, left to left $xx
4.2.1 TEXT Lyricist/Text writer
i.e. the beginning of the next frame. If this frame is used in the
65.Cabaret
This frame is intended for music that comes from a CD, so that the CD
ID3v2 size 4 * %0xxxxxxx
content descriptor, represented with as terminated textstring. If no
1 Frame is encrypted.
/AAC Advanced audio compression
reserved. $00 is used to describe a beat-free time period, which is
[MPEG] ISO/IEC 11172-3:1993.
each channel while the file is played. The purpose is to be able to
frame but only with different contents. It is recommended to keep the
This frame is indended for any kind of full text information that
/3 mode 3, 32 kHz/12 bits, nonlinear, low speed
4) Add /D ID3LIB_LINKOPTION=1 to your project options (settings, C/C++ tab)
This document is an informal standard and replaces the ID3v2.2.0
information about encryption method registration.
5) Add the following include dirs to your program:
In the frame header the size descriptor is followed by two flags
containing an email address, or a link to a location where an email
correct parsing of the tag information, hence the extended header is
5.Funk
This flag tells the software what to do with this frame if it is
4) Add /D ID3LIB_LINKOPTION=3 to your project options (settings, C/C++ tab) (*note this is a different option than above)
6) (add your code which uses id3lib)
$01 Absolute time, 32 bit sized, using MPEG frames as unit
content type $03 - $04.
header in the same order as the flags indicating the additions. I.e.
4.19. Recommended buffer size
This frame indicates if the actual audio stream is encrypted, and by
4.2.1 TCON Content type
unsychronisation, including padding, excluding the header but not
The 'Content group description' frame is used if the sound belongs to
the user to say how much he wants to increase/decrease the volume on
decoding software uses a syncsignal, embedded in the audiostream, to
$F0-$FC reserved for future use
code. Technical committee / subcommittee: TC 37 / SC 2
9) distribute your program including id3lib.dll
byteorder in multibyte numbers is most significant byte first (e.g.
$0B Composer
follows:
frames begin with a null-terminated string with a URL [URL]
4.19. Recommended buffer size
bundling all needed information. That makes this frame rather complex
starts. It is represented as a string with a maximum length of three
101.Speech
See section 3.3.1, flag j for more information.
Premix right to left $xx
In the frame header the size descriptor is followed by two flags
string with a URL [URL] containing an email address, or a link to a
Size of padding $xx xx xx xx
4.2.1 TPE4 Interpreted, remixed, or otherwise modified by
/6 mode 6, 44.1 kHz/16 bits, 'wide track' play
If a total revision of the ID3v2 tag should be needed, there is a
Abstract
are allowed in the text. There may be more than one 'Unsynchronised
that is a contact URL, with which the user can contact the seller,
byteorder in multibyte numbers is most significant byte first (e.g.
52.Electronic
LD Laserdisc
/4 mode 4, 32 kHz/12 bits, 4 channels
/9 9.5 cm/s
Terminated text to be synced (typically a syllable)
as a terminated string encoded with ISO 8859-1 [ISO-8859-1]. The
described in the "TALB" frame is divided into several mediums, e.g. a
such order: UFID, TIT2, MCDI, TRCK ...
ID3v2 size 4 * %0xxxxxxx
/78 78.26 rpm
only one containing the same symbol and only one containing the same
4.3.1 WORS Official internet radio station homepage
$01 Absolute time, 32 bit sized, using MPEG [MPEG] frames as unit
4.28. Private frame
/IV Type IV cassette (metal)
revisions are backwards compatible while major versions are not. If
RAD Radio
4.2.1 TEXT Lyricist/Text writer
Encapsulated object
Identifier
be left zeroed. After the 'preview length' field follows optionally a
2) include prj/id3lib.dsp and zlib/prj/zlib.dsp to your workspace (*note this is a different id3lib than above)
(C) is one character showing a C in a circle.
writers are seperated with the "/" character.
2.Country
All URLs [URL] may be relative, e.g. "picture.png", "../doc.txt".
4.17 PCNT Play counter
This has the side effect that all $FF 00 combinations have to be
$0C time change
/I Type I cassette (ferric/normal)
$00 Other
WOAS
here: http://sourceforge.net/tracker/?group_id=979&atid=300979 with the (e.g.) borland project files.
information from another ID3v2 tag that might reside in another audio
impossible to maintain with accurate and up to date categories,
97.Chorus
predefine an equalisation curve within the audio file. There may only
124.Euro-Hous c - Experimental indicator
4.2.1 TPUB Publisher
$15-$DF reserved for future use
Counter $xx xx xx xx (xx ...)
URL
4.5 MCDI Music CD identifier
Increment/decrement %00xxxxxx
Picture type $xx
4.12. Relative volume adjustment
k - Grouping identity
Extended Flags $xx xx
/II Type II cassette (chrome)
within "(" and ")" and are optionally followed by a text refinement,
frame header:
the player. All tempo descriptors should be sorted in chronological
Rating $xx
music in the file should be a cover of a previously released song.
'Content descriptor' is a terminated string. If no descriptor is
the frame.
allowed, with $0A only. Frames that allow different types of text
unsynchronised lyrics/text transcription in one major way. Each
This flag indicates whether or not the frame is compressed.
Preview start $xx xx
kinds. Reverb left/right is the delay between every bounce in ms.
The frame ID made out of the characters capital A-Z and 0-9.
Locators (URL).", RFC 1738, December 1994.
TLEN
defined.
information like artist, album and more. There may only be one text
URL containing an email address, or a link to a location where an
frame in each tag, but only one with the same content descriptor.
long.
into this tag, a URL [URL] field, where a reference to the file where
character, but there may only be one currency of each type.
live at Wembley").
entered, 'Content descriptor' is $00 (00) only. Newline characters
format YYYYMMDD, describing for how long the price is valid. After
/IV Type IV cassette (metal)
The 'Title/Songname/Content description' frame is the actual name of
terms might be available through the "WCOP" frame. Newlines are
for the frame. Questions regarding the frame should be sent to the
Identifier
$02 Absolute time, 32 bit sized, using milliseconds as unit
/I Type I cassette (ferric/normal)
more information about the people behind a remix and similar
followed by a termination ($00 (00)) all the following information
followed by a Unicode NULL ($FF FE 00 00 or $FE FF 00 00).
CD TOC
/A Analog transfer from media
unknown and the tag is altered in any way. This applies to all
Technical committee / subcommittee: TC 68
each tag.
106.Symphony
indicates usage.
Lyrics/text
Text encoding $xx
This datablock is then optionally followed by a volume definition for
considered as an update of the previous one. E.g. if there is a
/FM FM
In the frame header the size descriptor is followed by two flags
$15-$DF reserved for future use
TORY
Text encoding $xx
99.Acoustic
4.2.1 TSIZ Size
$02 Other file icon
followed by a Unicode NULL ($FF FE 00 00 or $FE FF 00 00).
textstring is followed by a termination ($00 (00)) all the following
2. Conventions in this document
/2 MPEG 1/2 layer II
Universal Multiple-Octet Coded Character Set (UCS), Part 1:
15.Rap
4.2.1 TRCK Track number/Position in set
channel and bit 1 is used to indicate the left channel. 1 is
altered functionallity.
/SVHS S-VHS
3) make your project dependend on id3lib, and make id3lib dependend on zlib
should be sorted in chronological order. The sync can be considered
Generic coding of moving pictures and associated audio information,
The 'Publisher' frame simply contains the name of the label or
points. There may be more than one "LINK" frame in a tag, but only
Rating $xx
decoding a compressed, 'unsynchronised' file, the 'unsynchronisation
numerical string.
and "image/jpeg" are allowed. This format string is followed by the
An example: The "USLT" passage
4.4 IPLS Involved people list
5) Add the following include dirs to your program:
their usage.
/I Type I cassette (ferric/normal)
WCOP
This frame is intended for one-string text information concerning the
good to use in conjunction with this one. The frame begins, after the
unknown flag is set in the first byte the frame may not be changed
Language $xx xx xx
$FF one more byte of events follows (all the following bytes with
/I
should be used when interoperability is wanted. Description is a
The version is followed by one the ID3v2 flags field, of which
unsynchronisation is used (see section 5 for details); a set bit
Some flags indicates that the frame header is extended with
between the values in this frame. Three equal adjustments for three
4.12. Relative volume adjustment
reason, coincidence make a syncsignal appear within the tag it will
There may be more than one "POPM" frame in each tag, but only one
A. Appendix A - Genre List from ID3v1
string according to encoding> if newlines are allowed. Any empty
4.2.1 TLEN Length
'milliseconds between reference' and the reality. The number of bits
as a numeric string.
1) Rename config.h.win32 to config.h
TEXT
4.27. Group identification registration
Technical committee / subcommittee: TC 68
it doesn't seem to be maintained anymore. I've included it as a service.
c - Experimental indicator
"TIT2" frame in the first received tag and one in the second tag,
apply when the audio is completely replaced with other audio data.
grouping should be sent to the indicated email address. The 'Group
'Premix left to right' is the amount of left sound to be mixed in the
4.20. Audio encryption
The use of linked files should however be used sparingly since there
format YYYYMMDD, describing for how long the price is valid. After
Technical committee / subcommittee: JTC 1 / SC 29
91.Gothic Rock
chronological order. The type of event is as follows:
$0C time change
and
Premix left to right $xx
Method symbol $xx
recording. This may be extended with a "/" character and a numeric
the artists official webpage. There may be more than one "WOAR" frame
directly related to the contents title (e.g. "Op. 16" or "Performed
/38 38 cm/s
$0F sustained noise end
publisher.
or, if no other data follows, be completely omitted. There may only
"TIT2" frame in the first received tag and one in the second tag,
significance concerning the recognition of the file. An example of
4.9 USLT Unsychronized lyric/text transcription
$13 Band/artist logotype
$06 As note sheets in a book with other sheets
Peak volume left $xx xx (xx ...)
3.3. ID3v2 frames overview
audio stream. In these cases, the size of the buffer can be
such order: UFID, TIT2, MCDI, TRCK ...
if found more suitable by the software.
'decompressed size' appended to the frame header.
Tempo data
4) Add /D ID3LIB_LINKOPTION=1 to your project options (settings, C/C++ tab)
method byte. These additions to the frame header, while not included
id3lib/libprj
3.1. ID3v2 header
information, price information or plain ordinary news can be added to
This is simply a counter of the number of times a file has been
TKEY
The 'Publishers official webpage' frame is a URL pointing at the
containing an email address, or a link to a location where an email
character.
tempo codes. Each tempo code consists of one tempo part and one time
Peak volume left back $xx xx (xx ...)
to the existing frame, after the center channel. The bass channel is
$0E During recording
This frame indicates if the actual audio stream is encrypted, and by
The purpose of this frame is to specify how good an audio file is.
/33 33.33 rpm
Text encoding $xx
explosion on-stage, turning on your screensaver etc.
Valid until
Since standardisation of such a database is beyond this document, all
between what is said in 'bytes between reference' and the reality and
The 'Commercial information' frame is a URL pointing at a webpage
This flag indicates wether or not the frame is enrypted. If set
/II Type II cassette (chrome)
performers are seperated with the "/" character.
Sync identifier (terminator to above string) $00 (00)
"F" and "G" and halfkeys represented with "b" and "#". Minor is
indicator'. This flag should always be set when the tag is in an
33.Instrumental
The 'Recording dates' frame is a intended to be used as complement to
subject to unsynchronisation.
65.Cabaret
Position $xx (xx ...)
and
method must be used somewhere in the tag. See section 3.3.1, flag j
byte big, excluding the header.
name is omitted, "image/" will be implied. Currently only "image/png"
How to start
[ZLIB] P. Deutsch, Aladdin Enterprises & J-L. Gailly, "ZLIB
%x0000000 00000000
96.Big Band
3. ID3v2 overview
denoting where in the sound file it belongs. Each sync thus has the
frame, the 3rd reference the 6th frame etc. In a similar way the
[MIME] Freed, N. and N. Borenstein, "Multipurpose Internet Mail
(representing up to 256MB) are used in the size description to avoid
contains a terminated string with the involvement directly followed
[CDDB] Compact Disc Data Base
not the same as a music-free time period. $01 is used to indicate one
4.22 POSS Position synchronisation frame
part of a set the audio came from. This frame is used if the source
to ISO 4217 [ISO-4217] alphabetic currency code, followed by a
The 'Original filename' frame contains the preferred filename for the
104.Chamber Music
4.20. Audio encryption
The 'Official audio source webpage' frame is a URL pointing at the
the audio to match the 'Playlist delay' time. The time is represented
82.National Folk
TDLY
The 'Official audio source webpage' frame is a URL pointing at the
its origin and contents. The information may be technical
/80 80 rpm
always an ISO-8859-1 text string. There may be more than one "GEOB"
to the existing frame, after the left and right back channels. The
WOAS
Group symbol $xx
scheme' should be parsed first, decompression afterwards.
URL
numeric string containing the total number of parts in the set. E.g.
numerical string.
with a "(" character it should be replaced with "((" in the same way
content. The most significant bit (MSB) of a byte is called 'bit 7'
/II Type II cassette (chrome)
the types as ID3v1.1 did or, since the category list would be
This is followed by 2 bytes + ('adjustment bits' rounded up to the
containing an email address, or a link to a location where an email
official wepage for the publisher.
$0C time change
28.Vocal
experimental stage.
4.24. Ownership frame
followed by a one byte 'received as' field. It describes how the
6) (add your code which uses id3lib)
The last thing in the frame is the actual object. The first two
cover of a previously released song, was released. The field is
without taking the proper means to compensate, e.g. recalculating
$05 Leaflet page
This document describes the ID3v2.3.0, which is a more developed
$FE audio file ends
Text encoding $xx
file or alone in a binary file. It is recommended that this method is
This is another way of incorporating the words, said or sung lyrics,
50.Darkwave
which is a header of 4 bytes and then 8 bytes/track on the CD plus 8
field. If Peakvolume is not known these fields could be left zeroed
follows
described.
4.10. Synchronised lyrics/text
%x0000000 00000000
/MW MW
/SECAM SECAM
should be added.
3) make your project dependend on id3lib, and make id3lib dependend on zlib
frame but only with different contents. It is recommended to keep the
$FE audio file ends
/76 76 cm/s
/I ISDN
media type, e.g. "(CD/A)" or "(VID/PAL/VHS)".
circumstances when the risk of file seperation is low. The frame
from.
Group symbol $xx
information about the performers in the recording.
'Method symbol' contains a value that is associated with this method
115.Folklore
reduction on the first bounce, 50% of that on the second and so on.
This is followed by 2 bytes + ('adjustment bits' rounded up to the
Picture MIME type
This frame is intended for music that comes from a CD, so that the CD
header is a descriptor of how much the 'frame counter' should
defined in 'bits for bytes deviation', that describes the difference
be described with the 'Peak volume right' and 'Peak volume left'
5) Add the following include dirs to your program:
If the center channel adjustment is present the following is appended
only.
2) include libprj/id3lib.dsp and zlib/prj/zlib.dsp to your workspace
60.Top 40
The 'Part of a set' frame is a numeric string that describes which
milliseconds deviation', must be a multiple of four. There may only
used for the main artist(s). They are seperated with the "/"
$12345678 would be encoded $12 34 56 78).
experimental stage.
$0C Lyricist/text writer
Relative volume change, bass $xx xx (xx ...)
/I
4.2.2. User defined text information frame
'Owner identifier' is a null-terminated string with a URL [URL]
others, and derivative works that comment on or otherwise explain it
by new software. Unsynchronisation may only be made with MPEG 2 layer
4.2.1 TCON Content type
Preview start $xx xx
Relative volume change, right back $xx xx (xx ...)
4.15. Attached picture
followed by a Unicode NULL ($FF FE 00 00 or $FE FF 00 00).
evolved from the ID3 tagging system. The ID3v2 offers a flexible way
that its program uses and does not fit into the other frames. The
DAT DAT
/SVHS S-VHS
RX Remix
The 'File owner/licensee' frame contains the name of the owner or
80.Folk
milliseconds deviation', must be a multiple of four. There may only
MC MC (normal cassette)
described in the "TALB" frame is divided into several mediums, e.g. a
which picture format is used. In the event that the MIME media type
Increment/decrement %00xxxxxx
might have used the same identifier as you. All other identifiers are
In the increment/decrement field bit 2 is used to indicate the right
in a project. The 'Involved people list' is a frame containing the
the frames and the headers, in other words the padding. The extended
of the seller as the last field in the frame. There may only be one
The 'Owner identifier' is then followed by the actual identifier,
$12 verse end
WOAR
'Premix right to left' does the same thing, but right to left.
An example: The "USLT" passage
Text encoding $xx
containing an email address, or a link to a location where an email
Counter $xx xx xx xx (xx ...)
and MPEG-2.5, but may work with other types of encoded audio.
starts. It is represented as a string with a maximum length of three
3.3.2. Default flags
allowed in the text. There may only be one "USER" frame in a tag.
"/" character.
6) (add your code which uses id3lib)
change the volume constantly. This frame may also be used to balance
If this flag is set four bytes of CRC-32 data is appended to the
combination during the unsynchronisation.
Peak volume bass $xx xx (xx ...)
ID3v2/file identifier "ID3"
strings may be omitted, leaving only their terminations. MIME type is
unknown and the tag is altered in any way. This applies to all
$FD audio end (start of silence)
All URLs [URL] may be relative, e.g. "picture.png", "../doc.txt".
information, such as equalisation curves, as well as related meta
7. References
text writer(s) of the original recording, if for example the music in
9) distribute your program including id3lib.dll
1 Frame is encrypted.
$00 Other
Abolute time means that every stamp contains the time from the
increase for every reference. If this value is two then the first
all the $FF 00 combinations have to be replaced with the $FF 00 00
good to use in conjunction with this one. The frame begins, after the
of language descriptor directly followed by a content descriptor as
content type $03 - $04.
audio file, frames with timecodes in different locations in the file
4.2.2. User defined text information frame
4.7 MLLT MPEG location lookup table
$01 Absolute time, 32 bit sized, using MPEG [MPEG] frames as unit
other vocal activities. The head includes an encoding descriptor and
every transmission with a tag, then this tag should include a
three or higher it should simply ignore the whole tag. Version and
channel and bit 1 is used to indicate the left channel. 1 is
Text encoding $xx
[ISO-4217] ISO 4217:1995.
87.Revival
All the other flags should be cleared. If one of these undefined
be left zeroed. After the 'preview length' field follows optionally a
want to synchronise your music to something, like setting of an
rewrite the entire file. The value of the padding bytes must be $00.
Size of padding $xx xx xx xx
4.2.1 TENC Encoded by
header in the same order as the flags indicating the additions. I.e.
The first criterion is met by the simple fact that the MPEG [MPEG]
short description of the picture, represented as a terminated
[ID3v2] Martin Nilsson, "ID3v2 informal standard".
62.Pop/Funk
Peak volume bass $xx xx (xx ...)
53.Pop-Folk
/2 MPEG 1/2 layer II
TSSE
encryption method must be registered in the tag with this frame. The
without parentheses. If this frame is not present audio type is
TCOP
the left and right back channels. If this information is appended to
character date string (YYYYMMDD) followed by a string with the name
4.8. Synced tempo codes
occurring in front of the first syllable of a new word. This is also
(MS recommend you distribute it in your programs dir and not in system(32) to avoid version conficts)
belongs to a set of frames a group identifier must be registered in
4) Add /D ID3LIB_LINKOPTION=1 to your project options (settings, C/C++ tab)
The tempo descriptor is followed by a time stamp. Every time the
4.21. Linked information
4.2.2. User defined text information frame
14.R&B
belongs to a set of frames a group identifier must be registered in
/WAC Wax cylinder
This document describes the ID3v2.3.0, which is a more developed
method must be used somewhere in the tag. See section 3.3.1, flag j
Text encoding $xx
then the first should be 'replaced' with the second.
Reverb left (ms) $xx xx
recommended by the server using this frame. If the 'embedded info
The 'Official internet radio station homepage' contains a URL
This frame indicates if the actual audio stream is encrypted, and by
The ID3v2 tag size is the size of the complete tag after
So far, it has only been confirmed it compiles on visual C 6.0 (service pack 5),
Reverb feedback, left to left $xx
datablock required for decryption of the audio. There may be more
/BETA BETAMAX
in the audio file as text, this time, however, in sync with the
frame, the 3rd reference the 6th frame etc. In a similar way the
TEL Telephone
part of the tag and has the same restrictions as if it was a physical
4.17. Play counter
short description of the picture, represented as a terminated
channel and bit 1 is used to indicate the left channel. 1 is
grouping should be sent to the indicated email address. The 'Group
/I Type I cassette (ferric/normal)
80.Folk
The 'Content group description' frame is used if the sound belongs to
Extended header size $xx xx xx xx
"F" and "G" and halfkeys represented with "b" and "#". Minor is
/76 76.59 rpm
Content type: $00 is other
The first one (id3lib/prj) creates the standard dll (no COM interface)
A) ***Your project wants to link id3lib static, and has mfc linked static:
Technical committee / subcommittee: JTC 1 / SC 2
flags' should be set. This bit should only be set if the tag
adjust the audio. If the volume peak levels are known then this could
Language $xx xx xx
The 'Recording dates' frame is a intended to be used as complement to
$F0-$FC reserved for future use
bits) for MPEG 2 layer I, II and III [MPEG] and MPEG 2.5. This value
good to use in conjunction with this one. The frame begins, after the
as in the "TCO" frame. Predefined refinements is appended after the
$02 Absolute time, 32 bit sized, using milliseconds as unit
4.2.1 TOAL Original album/movie/show title
98.Easy Listening
%11111111 111xxxxx
Reverb feedback, left to left $xx
$10 Movie/video screen capture
This frame is intended for URL [URL] links concerning the audiofile
33.Instrumental
Relative volume change, center $xx xx (xx ...)
Peak volume left back $xx xx (xx ...)
then the first should be 'replaced' with the second.
defined.
/A Analog transfer from media
$FE audio file ends
DAT DAT
ID3v2 flags %abc00000
See section 3.3.1, flag j for more information.
TEXT
bits) for MPEG 2 layer I, II and III [MPEG] and MPEG 2.5. This value
'decompressed size' appended to the frame header.
/4 4.75 cm/s (normal speed for a two sided cassette)
This frame is intended for one-string text information concerning the
Increment/decrement %00xxxxxx
id3lib/id3com
numbers preceded with % are binary. $xx is used to indicate a byte
In the frame header the size descriptor is followed by two flags
picture is to attach.
although it is desired that the frames are arranged in order of
frame is intended to be read only. Changing the contents might
The frame ID made out of the characters capital A-Z and 0-9.
the beginning of every track on the CD should be described with a
audio can be specified. The 'Preview start' and 'Preview length' is
Frame ID $xx xx xx xx (four characters)
excluding "TXXX" described in 4.2.2.>
$12 Illustration
of the seller as the last field in the frame. There may only be one
After the 'Owner identifier', a pointer to an unencrypted part of the
74.Acid Jazz
None.
'Premix left to right' is the amount of left sound to be mixed in the
section 3.2.
A. Appendix A - Genre List from ID3v1
organisation that encoded the audio file. This field may contain a
29.Jazz+Funk
Bits for milliseconds dev. $xx
Description
representation of the adjustment. This is normally $10 (16 bits) for
WPAY
$11 A bright coloured fish
kinds. Reverb left/right is the delay between every bounce in ms.
The 'Lyricist(s)/Text writer(s)' frame is intended for the writer(s)
audiofile in a similar way to the other "T"-frames. The frame body
end of the ID3 tag), making the size of all the frames together
Abstract
4.4. Involved people list
Newline ($0A) characters are allowed in all "SYLT" frames and should
4.27 GRID Group identification registration
reverb is applied symmetric). There may only be one "RVRB" frame in
Where the 'Extended header size', currently 6 or 10 bytes, excludes
This flag indicates whether or not the frame is compressed.
containing an email address, or a link to a location where an email
right before any reverb is applied, where $00 id 0% and $FF is 100%.
Name of seller
The 'Not predefined sync's ($E0-EF) are for user events. You might
beginning of the file.
recording(/source of sound) which the audio in the file is taken
Software that isn't told otherwise may safely remove such frames. The
(debug) /nodefaultlib:"MSVCRTD" or(release) /nodefaultlib:"MSVCRT"
pointing at the homepage of the internet radio station.
The 'Interpreted, remixed, or otherwise modified by' frame contains
4.3.1. URL link frames - details
4.2.1 TENC Encoded by
TPE2
$0A variation start
characters 0-9 only.
A tag is the whole tag described in this document. A frame is a block
TORY
optional.
purpose of this padding is to allow for adding a few additional
(representing up to 256MB) are used in the size description to avoid
byte is inserted after the first false synchronisation byte. The
each channel while the file is played. The purpose is to be able to
allowed in the comment text string. There may be more than one
Technical committee / subcommittee: JTC 1 / SC 29
The first one (id3lib/prj) creates the standard dll (no COM interface)
the audio to match the 'Playlist delay' time. The time is represented
or, if signed, as proof. Note that the "USER" and "TOWN" frames are
/SVHS S-VHS
significance concerning the recognition of the file. An example of
85.Bebob
Where yy is less than $FF, xx is the 'flags' byte and zz is less than
others, and derivative works that comment on or otherwise explain it
numerical string.
$12 verse end
encryption method should be sent to the indicated email address. The
x - CRC data present
Abstract
four bytes absolute CD-frame address per track, and not with absolute
Rating $xx
strings may be omitted, leaving only their terminations. MIME type is
$02 Absolute time, 32 bit sized, using milliseconds as unit
Text encoding $xx
Adjustment $xx (xx ...)
text writer(s) of the original recording, if for example the music in
Do bear in mind, that if a compression scheme is used by the encoder,
Rating $xx
The text information frames are the most important frames, containing
4.26. Encryption method registration
frame ID, size and encoding fields, with a 'price payed' field. The
MPG MPEG Audio
/33 33.33 rpm
/I
2. Discarded if tag is altered, preserved if file is altered.
See section 3.3.1, flag j for more information.
implementors could have a set standard before a formal standard is
54.Eurodance
(debug) /nodefaultlib:"libcd" or(release) /nodefaultlib:"libc"
1) Rename config.h.win32 to config.h
IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF
"F" and "G" and halfkeys represented with "b" and "#". Minor is
version number and a size descriptor in the ID3v2 header.
4.10. Synchronised lyrics/text
last thing is the ability to include a company logotype. The first of
text writer(s) of the original recording, if for example the music in
indicator'. This flag should always be set when the tag is in an
ID3v2 size 4 * %0xxxxxxx
100.Humour
section 5.
The header is:
Adjustment bits $xx
The 'Content type', which previously was stored as a one byte numeric
Value
text information frames and the URL link frames.
C)***Your project wants to link id3lib dynamic: (instructions below for vc)
includes the used audio encoder and its settings when the file was
4.11. Comments
77.Musical
$10 Movie/video screen capture
kinds of alterations, including adding more padding and reordering
25.Euro-Techno
encryption method must be registered in the tag with this frame. The
mean that the sound is public domain. Every time this field is
throughout the whole tag. Values below $80 are reserved. The 'Group
This document and translations of it may be copied and furnished to
69.Showtunes
Owner identifier
4.27 GRID Group identification registration
Adjustment $xx (xx ...)
Lyrics/text
4. Declared ID3v2 frames
To keep space waste as low as possible this frame may be used to link
'Premix left to right' is the amount of left sound to be mixed in the
$01 Absolute time, 32 bit sized, using MPEG frames as unit
the CD's only got one track. There may only be one "MCDI" frame in
Increment/decrement %00xxxxxx
ID3v2 flags %abc00000
[ISO-8859-1] characters in the range $20 - $FF. Such strings are
37.Sound Clip
address can be found, that belongs to the organisation responsible
(debug) /nodefaultlib:"msvcprtd" or(release) /nodefaultlib:"msvcprt"
The 'Publishers official webpage' frame is a URL pointing at the
(debug) /nodefaultlib:"libcd" or(release) /nodefaultlib:"libc"
of storing information about an audio file within itself to determine
TPE2
the piece (e.g. "Adagio", "Hurricane Donna").
as a numeric string.
Text encoding $xx
$0E sustained noise
/PAL PAL
The 'bits used for volume description' field is normally $10 (16
the player. All tempo descriptors should be sorted in chronological
part. The tempo is in BPM described with one or two bytes. If the
tag, except when stated otherwise in the frame description. If the
The 'ISRC' frame should contain the International Standard Recording
This flag indicates whether or not this frame belongs in a group
121.Punk Rock
6.Grunge
The 'Track number/Position in set' frame is a numeric string
Encryption data
The ID3v2 tag size is the size of the complete tag after
/DD DDD
combination during the unsynchronisation.
The 'Buffer size' should be kept to a minimum. There may only be one
or, if no other data follows, be completely omitted. There may only
If a frame is longer than it should be, e.g. having more fields than
1) Rename config.h.win32 to config.h
27.Trip-Hop
$06 is trivia/'pop up' information
in a similar way to the other "W"-frames. The frame body consists
tags into the audio stream though. If the clients connects to
$02 Compressed audio on CD
starts. It is represented as a string with a maximum length of three
MC MC (normal cassette)
parser that does not know the flags function.
15.Rap
single beat-stroke followed by a beat-free period.
individual connections like HTTP and there is a possibility to begin
RX Remix
the piece (e.g. "Adagio", "Hurricane Donna").
version of the ID3v2 informal standard [ID3v2] (version 2.2.0),
36.Game
Adjustment bits $xx
in a tag if the audio contains more than one performer, but not with
Where yy is less than $FF, xx is the 'flags' byte and zz is less than
4.21. Linked information
$0B Composer
to the existing frame, after the left and right back channels. The
4.11 COMM Comments
and MPEG-2.5, but may work with other types of encoded audio.
4.21. Linked information
increase for every reference. If this value is two then the first
is the risk of separation of files.
4.3.1. URL link frames - details
In this frame any type of file can be encapsulated. After the header,
3. ID3v2 overview
symbol' contains a value that associates the frame with this group
which is a header of 4 bytes and then 8 bytes/track on the CD plus 8
4.2.1 TOPE Original artist(s)/performer(s)
circumstances when the risk of file seperation is low. The frame
TLAN
directly related to the contents title (e.g. "Op. 16" or "Performed
x - CRC data present
[ISO-8859-1] characters in the range $20 - $FF. Such strings are
although it is desired that the frames are arranged in order of
None.
$10 Movie/video screen capture
CD CD
the first frame in the stream. The frame layout is: