Difference between revisions of "Metatag Mapping"

From Hydrogenaudio Knowledgebase
Redirect page
Jump to: navigation, search
(Introduction)
(Redirect to "Tag Mapping" page since it's the more complete and accurate page, avoiding the duplicate content)
 
(10 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== Introduction ==
+
#REDIRECT [[Tag Mapping]]
 
+
The purpose of this page is to try and cover as many of the most used formats/standards of tagging (audio) as possible.
+
Hopefully this will help those trying to transcode or move audio data around and wish to retain their tags.
+
It is also hopefully of use to developers that read and write metadata from files.
+
And if this page helps standards bodies to make decisions on current or future metadata/formats/tags then that is just awesome too.
+
 
+
Please note that this page is about mapping tags to each other, it does not detail nor dictate the actual way the metadata is stored nor any limitations (or lack thereof), such is way beyond the scope of this page.
+
 
+
The terms metadata/tag/field may be used intermittently on this page to mean the same thing. This page is also far from complete and may never be.
+
 
+
The names down along the left hand side of the tables are the suggested names of these tags (and how they should be presented to the end user), in time these will hopefully get their own mini wiki page, or at the very least a note as to what it's intended purpose/use is.
+
 
+
== Standard Tags ==
+
 
+
The following tables just map tags in one format/standard to another. Each format may have limitations, like not being able to handle UTF8 for example, or limitations as to the length of the content of a tag, some might have a non-textual tag like ID3v1 has for the Genre tag. Some may allow multiple tags of the same kind, while some may allow just one but uses a separator in the text instead. These format differences may or may not be mentioned on this page, so please keep that in mind.
+
If you see a question mark inside the tables then that just means somebody haven't filled/researched anything about that part yet, if you see n/a in the table that means this tag does not exist and will most likely never exist for that format/standard (mostly this applies to ID3 v1 and v1.1). The grouping of the tags may also change from time to time as this page is improved.
+
 
+
=== Primary ===
+
 
+
These are the core meta-tags and supported/defined in all major tagging standards or file formats one way or another.
+
 
+
{| class="wikitable"
+
! Tag !! ID3 v1/v1.1 !! FLAC/Vorbis/Ogg !! ID3 v2.3 / ID3 v2.4 !! APEv2 !! Matroska !! WMA !! MP4/iTunes
+
|-
+
!Album
+
|Album
+
|ALBUM
+
|TALB
+
|Album
+
|TITLE <ref name=Matroska />
+
|WM/AlbumTitle
+
|©alb
+
|-
+
!Artist
+
|Artist
+
|ARTIST
+
|TPE1
+
|Artist
+
|ARTIST
+
|Author
+
|©art
+
|-
+
!Comment
+
|Comment
+
|DESCRIPTION
+
|COMM
+
|Comment
+
|COMMENT
+
|Description
+
|©cmt
+
|-
+
!Date
+
|Year
+
|DATE <ref name=ISO8601 />
+
|TDRC <ref name=TDRC />
+
|Year
+
|DATE_RELEASE
+
|WM/Year
+
|©day
+
|-
+
!Genre
+
|Genre <ref name=ID3v1Genre />
+
|GENRE
+
|TCON
+
|Genre
+
|GENRE
+
|WM/Genre
+
|©gen
+
|-
+
!Title
+
|Title
+
|TITLE
+
|TIT2
+
|Title
+
|TITLE <ref name=Matroska />
+
|Title
+
|©nam
+
|-
+
!Track <ref name=Track />
+
|Album track <ref name=ID3v1 />
+
|TRACKNUMBER
+
|TRCK
+
|Track
+
|TRACK
+
|TRACKNUMBER
+
|trkn
+
|}
+
 
+
=== Secondary ===
+
 
+
These meta-tags provide information that a user or software may expect. Not all formats or software may support these tags though.
+
 
+
{|class="wikitable"
+
! Tag !! ID3 v1/v1.1 !! FLAC/Vorbis/Ogg !! ID3 v2.3/v2.4 !! APEv2 !! Matroska !! WMA !! MP4/iTunes
+
|-
+
!Album Artist
+
|n/a
+
|?
+
|TPE2
+
|?
+
|ACCOMPANIMENT
+
|WM/AlbumArtist
+
|?
+
|-
+
!Composer
+
|n/a
+
|COMPOSER
+
|TCOM
+
|Composer
+
|COMPOSER
+
|WM/Composer
+
|©wrt
+
|-
+
!Copyright
+
|n/a
+
|COPYRIGHT
+
|TCOP
+
|Copyright
+
|COPYRIGHT
+
|Copyright
+
|cprt
+
|-
+
!Disc
+
|n/a
+
|DISCNUMBER
+
|TPOS
+
|Disc
+
|PART_OFFSET
+
|WM/PartOfSet
+
|disk
+
|-
+
!EAN/UPC
+
|n/a
+
|?
+
|?
+
|EAN/UPC
+
|BARCODE
+
|?
+
|?
+
|-
+
!ISRC
+
|n/a
+
|ISRC
+
|TSRC
+
|ISRC
+
|ISRC
+
|WM/ISRC
+
|?
+
|-
+
!Performer
+
|n/a
+
|PERFORMER
+
|?
+
|?
+
|?
+
|?
+
|?
+
|-
+
!Publisher
+
|n/a
+
|ORGANIZATION
+
|TPUB
+
|Publisher
+
|PUBLISHER
+
|WM/Publisher
+
|?
+
|-
+
!Recording Location
+
|n/a
+
|LOCATION
+
|?
+
|Record Location
+
|RECORDING_LOCATION
+
|?
+
|?
+
|-
+
!Remixed By
+
|n/a
+
|REMIXEDBY
+
|TPE4
+
|?
+
|REMIXED_BY
+
|?
+
|?
+
|-
+
!ReplayGain Album Gain
+
|n/a
+
|REPLAYGAIN_ALBUM_GAIN
+
|TXXX=REPLAYGAIN_ALBUM_GAIN <ref name=TXXX />
+
|REPLAYGAIN_ALBUM_GAIN
+
|REPLAYGAIN_GAIN <ref name=Matroska />
+
|?
+
|?
+
|-
+
!ReplayGain Album Peak
+
|n/a
+
|REPLAYGAIN_ALBUM_PEAK
+
|TXXX=REPLAYGAIN_ALBUM_PEAK <ref name=TXXX />
+
|REPLAYGAIN_ALBUM_PEAK
+
|REPLAYGAIN_PEAK <ref name=Matroska />
+
|?
+
|?
+
|-
+
!ReplayGain Track Gain
+
|n/a
+
|REPLAYGAIN_TRACK_GAIN
+
|TXXX=REPLAYGAIN_TRACK_GAIN <ref name=TXXX />
+
|REPLAYGAIN_TRACK_GAIN
+
|REPLAYGAIN_GAIN <ref name=Matroska />
+
|?
+
|?
+
|-
+
!ReplayGain Track Peak
+
|n/a
+
|REPLAYGAIN_TRACK_PEAK
+
|TXXX=REPLAYGAIN_TRACK_PEAK <ref name=TXXX />
+
|REPLAYGAIN_TRACK_PEAK
+
|REPLAYGAIN_PEAK <ref name=Matroska />
+
|?
+
|?
+
|-
+
!Subtitle
+
|n/a
+
|VERSION
+
|TSST
+
|Subtitle
+
|SUBTITLE
+
|WM/Subtitle
+
|?
+
|-
+
!Total Discs
+
|n/a
+
|TOTALDISCS / DISCTOTAL
+
|?
+
|?
+
|?
+
|?
+
|?
+
|-
+
!Total Tracks
+
|n/a
+
|TOTALTRACKS / TRACKTOTAL
+
|?
+
|?
+
|TOTAL_PARTS
+
|TRACKTOTAL
+
|?
+
|}
+
 
+
=== Tertiary ===
+
 
+
These meta-tags while considered standard may have uneven support across various software or formats. They should otherwise be rather well specified though.
+
 
+
{|class="wikitable"
+
! Tag !! ID3 v1/v1.1 !! FLAC/Vorbis/Ogg !! ID3 v2.3/v2.4 !! APEv2 !! Matroska !! WMA !! MP4/iTunes
+
|}
+
 
+
=== Quaternary ===
+
 
+
These meta-tags are the more rare ones. They may also be ambiguous on how the content of a tag is to be treated/parsed. Some of these may have been proprietary at some point in the past. While others may be falling into obscurity.
+
 
+
{|class="wikitable"
+
! Tag !! ID3 v1/v1.1 !! FLAC/Vorbis/Ogg !! ID3 v2.3/v2.4 !! APEv2 !! Matroska !! WMA !! MP4
+
|}
+
 
+
=== (Unsorted/Incomplete) ===
+
 
+
{|class="wikitable"
+
! Tag !! ID3 v1/v1.1 !! FLAC/Vorbis/Ogg !! ID3 v2.3/v2.4 !! APEv2 !! Matroska !! WMA !! MP4
+
|-
+
!Album Sort
+
|n/a
+
|?
+
|TSOA
+
|?
+
|?
+
|?
+
|-
+
!Album Artist Sort
+
|n/a
+
|?
+
|TSO2
+
|?
+
|?
+
|?
+
|-
+
!Artist Sort
+
|n/a
+
|?
+
|TSOP
+
|?
+
|SORT_WITH
+
|?
+
|?
+
|-
+
!BPM
+
|n/a
+
|?
+
|TBPM
+
|?
+
|?
+
|?
+
|-
+
!Contact
+
|n/a
+
|CONTACT
+
|?
+
|?
+
|?
+
|?
+
|?
+
|-
+
!Compilation
+
|n/a
+
|?
+
|TCMP
+
|?
+
|?
+
|?
+
|-
+
!Composer Sort
+
|n/a
+
|?
+
|TSOC
+
|?
+
|?
+
|?
+
|-
+
!Conductor
+
|n/a
+
|?
+
|TPE3
+
|?
+
|?
+
|?
+
|-
+
!Content Group
+
|n/a
+
|?
+
|TIT1
+
|?
+
|?
+
|?
+
|-
+
!Encoded By
+
|n/a
+
|ENCODEDBY
+
|TENC
+
|?
+
|?
+
|?
+
|-
+
!Encoding Settings
+
|n/a
+
|?
+
|TSSE
+
|?
+
|?
+
|?
+
|-
+
!Encoding Time
+
|n/a
+
|?
+
|TDEN <ref name=ID3v2.4 />
+
|?
+
|?
+
|?
+
|-
+
!File Owner
+
|n/a
+
|?
+
|TOWN
+
|?
+
|?
+
|?
+
|-
+
!File Type
+
|n/a
+
|?
+
|TFLT
+
|?
+
|?
+
|?
+
|-
+
!Initial Key
+
|n/a
+
|?
+
|TKEY
+
|?
+
|?
+
|?
+
|-
+
!Involved People
+
|n/a
+
|?
+
|IPLS, TIPL
+
|?
+
|?
+
|?
+
|-
+
!Language
+
|n/a
+
|?
+
|TLAN
+
|?
+
|?
+
|?
+
|-
+
!License
+
|n/a
+
|LICENSE
+
|?
+
|?
+
|?
+
|?
+
|?
+
|-
+
!Length
+
|n/a
+
|?
+
|TLEN
+
|?
+
|?
+
|?
+
|-
+
!Lyricist
+
|n/a
+
|?
+
|TEXT
+
|?
+
|?
+
|?
+
|-
+
!Media Type
+
|n/a
+
|?
+
|TMED
+
|?
+
|?
+
|?
+
|-
+
!Mood
+
|n/a
+
|?
+
|TMOO <ref name=ID3v2.4 />
+
|?
+
|?
+
|?
+
|-
+
!Musician Credits
+
|n/a
+
|?
+
|TMCL <ref name=ID3v2.4 />
+
|?
+
|?
+
|?
+
|-
+
!Net Radio Owner
+
|n/a
+
|?
+
|TRSO
+
|?
+
|?
+
|?
+
|-
+
!Net Radio Station
+
|n/a
+
|?
+
|TRSN
+
|?
+
|?
+
|?
+
|-
+
!Original Album
+
|n/a
+
|?
+
|TOAL
+
|?
+
|?
+
|?
+
|-
+
!Original Filename
+
|n/a
+
|?
+
|TOFN
+
|?
+
|?
+
|?
+
|-
+
!Original Lyricist
+
|n/a
+
|?
+
|TOLY
+
|?
+
|?
+
|?
+
|-
+
!Podcast
+
|n/a
+
|?
+
|PCST
+
|?
+
|?
+
|?
+
|-
+
!Podcast Category
+
|n/a
+
|?
+
|TCAT
+
|?
+
|?
+
|?
+
|-
+
!Podcast Description
+
|n/a
+
|?
+
|TDES
+
|?
+
|?
+
|?
+
|-
+
!Podcast ID
+
|n/a
+
|?
+
|TGID
+
|?
+
|?
+
|?
+
|-
+
!Podcast URL
+
|n/a
+
|?
+
|WFED
+
|?
+
|?
+
|?
+
|-
+
!Rating
+
|n/a
+
|?
+
|POPM
+
|?
+
|?
+
|?
+
|-
+
!Release Time
+
|n/a
+
|?
+
|TDRL
+
|?
+
|?
+
|?
+
|-
+
!Set Subtitle
+
|n/a
+
|?
+
|TSST <ref name=ID3v2.4 />
+
|?
+
|?
+
|?
+
|-
+
!Tagging Time
+
|n/a
+
|?
+
|TDTG <ref name=ID3v2.4 />
+
|?
+
|?
+
|?
+
|-
+
!Lyrics
+
|n/a
+
|?
+
|USLT
+
|?
+
|?
+
|?
+
|-
+
!URL
+
|n/a
+
|?
+
|WXXX
+
|?
+
|?
+
|?
+
|-
+
!Author URL
+
|n/a
+
|?
+
|WOAR
+
|?
+
|?
+
|?
+
|-
+
!Audio File URL
+
|n/a
+
|?
+
|WOAF
+
|?
+
|?
+
|?
+
|-
+
!Audio Source URL
+
|n/a
+
|?
+
|WOAS
+
|?
+
|?
+
|?
+
|-
+
!Promotion URL
+
|n/a
+
|?
+
|WCOM
+
|?
+
|?
+
|?
+
|-
+
!Copyright URL
+
|n/a
+
|?
+
|WCOP
+
|?
+
|?
+
|?
+
|-
+
!Payment URL
+
|n/a
+
|?
+
|WPAY
+
|?
+
|?
+
|?
+
|-
+
!Publisher URL
+
|n/a
+
|?
+
|WPUB
+
|?
+
|?
+
|?
+
|-
+
!Radio URL
+
|n/a
+
|?
+
|WORS
+
|?
+
|?
+
|?
+
|-
+
!Original Artist
+
|n/a
+
|ORIGARTIST
+
|TOPE
+
|?
+
|?
+
|?
+
|}
+
 
+
== Non-standard Tags ==
+
 
+
=== Proprietary ===
+
 
+
These meta-tags are used in proprietary software, and is rarely of use outside that particular software.
+
 
+
{|class="wikitable"
+
! Tag !! ID3 v1/v1.1 !! FLAC/Vorbis/Ogg !! ID3 v2.3/v2.4 !! APEv2 !! Matroska !! WMA !! MP4/iTunes
+
|-
+
!fieldname
+
|n/a
+
|?
+
|?
+
|?
+
|?
+
|?
+
|?
+
|-
+
!fieldname
+
|n/a
+
|?
+
|?
+
|?
+
|?
+
|?
+
|?
+
|}
+
 
+
=== Proposed ===
+
 
+
These meta-tags are suggestions for new standards, some of these may also have previously been experimental or proprietary in nature. While they may be proposed this does not guarantee they will become standard. It just means that someone (and hopefully more than one individual) would like to see it standardized. Any tags listed here should be properly documented someplace and specified in detail.
+
 
+
{|class="wikitable"
+
! Tag !! ID3 v1/v1.1 !! FLAC/Vorbis/Ogg !! ID3 v2.3/v2.4 !! APEv2 !! Matroska !! WMA !! MP4/iTunes
+
|-
+
!fieldname
+
|n/a
+
|?
+
|?
+
|?
+
|?
+
|?
+
|?
+
|-
+
!fieldname
+
|n/a
+
|?
+
|?
+
|?
+
|?
+
|?
+
|?
+
|}
+
 
+
=== Experimental ===
+
 
+
These meta-tags are experimental in nature and should not be encountered normally, but in case they are they are listed here for completeness sake. These tags may appear and vanish at any time or may have their meaning or use changed at any time.
+
 
+
{|class="wikitable"
+
! Tag !! ID3 v1/v1.1 !! FLAC/Vorbis/Ogg !! ID3 v2.3/v2.4 !! APEv2 !! Matroska !! WMA !! MP4/iTunes
+
|-
+
!Custom
+
|n/a
+
|?
+
|TXXX
+
|?
+
|?
+
|?
+
|?
+
|}
+
 
+
== Additional Information ==
+
 
+
=== Notes ===
+
 
+
<references>
+
<ref name=ISO8601>ISO 8601 date used/highly advised, see [http://wiki.xiph.org/VorbisComment Vorbis Comment] and [http://en.wikipedia.org/wiki/ISO_8601 ISO 8601] Wikipedia article for more.</ref>
+
<ref name=TDRC>The ID3 v2.3 tags TYER & TDAT & TIME & TRDA are replaced by TDRC in ID3 v2.4, see [http://en.wikipedia.org/wiki/ID3#ID3v2_Frame_Specification_.28Version_2.4_.E2.80.93_delta_respect_to_2.3.29 ID3] Wikipedia article for more.</ref>
+
<ref name=ID3v1Genre>The ID3 v1 and v1.1 Genre tag is a number referencing a pre-defined list, this brings it own huge genre mapping issue that is not covered in this Wiki page.</ref>
+
<ref name=Track>Some Track meta tags may have both the current track and total tracks stored, using a / to separate the two values. While others do not.</ref>
+
<ref name=ID3v1>Difference between ID3 v1 and v1.1 is the addition of Album track, see [http://id3.org/ID3v1 ID3v1] specs for more.</ref>
+
<ref name=Matroska>In Matroska it matters where the tags are used. So a ReplayGain tag for Track and Album are named the same just as an example.</ref>
+
<ref name=ID3v2.4>Some tags are only in ID3 v2.4 and there exists no equivalent in ID3 v2.3.</ref>
+
<ref name=TXXX>Tags that start with TXXX= in the tables above means that the actual tag is stored inside a TXXX tag. 
+
</references>
+
 
+
=== Issues ===
+
 
+
There are a few issues that are unresolved/need to be resolved:
+
 
+
* "Remixed By" is pretty much the same as "Subtitle", the Ogg definition of "Version" even mention this. But ID3v2.x treat them as two separate tags.
+
* "Subtitle" is often put as part of the title inside parenthesis. For display purposes that is probably correct, but not when storing the information.
+
* It is not clear yet if this page should be all exhaustive, or if it should cover common practice (in a similar vein to how HTML5 standard is being maintained).
+
 
+
=== Links ===
+
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=102013 Forum:Metadata/tag mapping between FLAC, mp3, and UPnP/DLNA, Is there a standard? What does fb2k do?]
+
* [[foobar2000:Encouraged_Tag_Standards|foobar2000 Encouraged Tag Standards]]
+
* [http://wiki.xiph.org/VorbisComment Vorbis Comment]
+
* [http://help.mp3tag.de/main_tags.html MP3Tag mappings]
+
* [http://matroska.org/technical/specs/tagging/index.html Matroska tags]
+
* [http://age.hobba.nl/audio/mirroredpages/ogg-tagging.html Ogg Tagging]
+
* [http://atomicparsley.sourceforge.net/mpeg-4files.html MP4/iTunes tags]
+
* [http://id3.org/id3v2.4.0-frames ID3 v2.4 frames]
+
* [[APE_key|APE tags]]
+
* [[Foobar2000:ID3_Tag_Mapping]]
+
* [http://wiki.xiph.org/Field_names Ogg field names]
+
 
+
[[Category:Guides]]
+
[[Category:Metadata]]
+

Latest revision as of 13:07, 20 April 2017