This article needs additional citations for verification. (February 2016) (Learn how and when to remove this template message)
A Vorbis comment is a metadata container used in the Vorbis, FLAC, Theora, Speex and Opus file formats. It allows information such as the title, artist, album, track number or other information about the file to be added to the file itself. However, as the official Ogg Vorbis documentation notes, “[the comment header] is meant for short, text comments, not arbitrary metadata; arbitrary metadata belongs in a separate logical bitstream (usually an XML stream type) that provides greater structure and machine parseability.”
A Vorbis tag is a list of fields in the format
FieldName=Data. The field name can be composed of printable ASCII characters, 0x20 (space) through 0x7D (‘}’), with 0x3D (‘=’) and 0x7E (‘~’) excluded. It is case insensitive, so
ARTIST are the same field. The number of fields and their length is restricted to 4,294,967,295 (the maximum value of an unsigned 32-bit integer), but most tag editing applications impose stricter limits.
Any tag name is allowed, and there is no format that the data values must be in. This is in contrast to the ID3 format used for MP3s, which is highly structured. Field names are also permitted to be used more than once. It is encouraged to use this feature to support multiple values, for example two
ARTIST=... fields to list both artists of a single composition.
The specification gives several example tag names such as
TRACKNUMBER. Most applications also support common de facto standards, such as
RATING, and tags for ReplayGain information. Ratings are usually mapped as 1-5 stars with 20,40,60,80,100 as the actual string values.
There are no provisions for storing binary data in Vorbis comments. This is by design; they are intended to be used as part of a container format such as Ogg, and any additional binary data should be encoded into the container as a stream. The exception to this, by popular request, is a proposal to incorporate cover art into a Vorbis comment.
- "Ogg Vorbis I format specification: comment field and header specification". xiph.org. Xiph.Org Foundation. 2005. Retrieved 18 February 2016.
- "VorbisComment, cover art". wiki.xiph.org. xiph.org. Retrieved 1 October 2016.
- Vorbis Comments specification at Xiph
- Proposed field names at Xiph Wiki
- Proposal for extensions (e.g.: cover art, chapter extension, date and time) at Xiph Wiki
- Chapter mark extension at Xiph Wiki
- Shea, David (Sep 28, 2004). "Proposals for extending Ogg Vorbis comments". Archived from the original on April 2014.