Tag Mapping

From Hydrogenaudio Knowledgebase
Revision as of 15:09, 10 September 2021 by Beardgoggles (Talk | contribs)

Jump to: navigation, search

Introduction

This page attempts to document a useful mapping between the tagging schemes used on various (audio) file formats. Hopefully this will help those developers trying to transcode or move audio data around and wish to retain their tags. It is hopefully also of use to developers that read and write metadata from audio files.

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). This 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. Also note that this page might not be complete, and may never will be.

Please do not rely on the content being accurate.

Organization

The below tables are organized into categories of data, and within each category the ordering is roughly as follows:

1. tags that apply to a wider range of data (e.g. a whole CD) come before tags that apply to a narrower range of data (e.g. one track).

2. tags are sorted alphabetically where this is relevant.

3. tags that are more widely supported come before tags that are less widely supported.

4. tags that fall into smaller unnamed sub-categories are grouped together.

5. tags that appear very similar but which have not yet been mapped are listed next to each other.

This document will not deal with approaches to tagging, except where certain approaches to tagging are required to make mapping work.

Format-specific notes

Vorbis Comment

Tags marked S or M denote how many instances of that tag should be allowed to be stored in a file: Single or Multiple.

Matroska

Unlike other tagging systems, the same tag name (e.g. TITLE) can have different meanings based on the "TargetType" level.

The recommendation is that album-specific tags have a "TargetType" of 50 and track-specific tags have a "TargetType" of 30.

Mapping Tables

Titles

Name ID3v1.1 [1] ID3v2.2 [2] ID3v2.3 [3] ID3v2.4 [4] iTunes MP4 WMA [5] Vorbis Comment APEv2 Matroska RIFF UPnP
Album Title Album (30 chars) TAL TALB ©alb [6] WM/AlbumTitle [6] ALBUM S [7] [8] Album [6] IPRD [9] upnp:album [10]
Album Title Sort Order TSOA [11] / XSOA [6] TSOA soal [6] WM/AlbumSortOrder [6] ALBUMSORT [6] ALBUMSORT [6]
Original Album Title [11] TOT TOAL WM/OriginalAlbumTitle
Disc [6] / Set [11] Subtitle (for multi-disc sets) TSST[11] ----:com.apple.iTunes:DISCSUBTITLE [6] WM/SetSubTitle [6] DISCSUBTITLE [6] DiscSubtitle [6]
Show Name tvsh [6]
Show Name Sort Order sosn [6]
Content Group [11] TT1 TIT1 ©grp [6] WM/ContentGroupDescription [6] GROUPING [6] Grouping [6]
Track Title Title (30 chars) TT2 TIT2 ©nam [6] Title [6] TITLE S [7] [8] Title [6] INAM [12] [9] dc:title [10]
Track Title Sort Order TSOT [11] / XSOT [6] TSOT sonm [6] WM/TitleSortOrder [6] TITLESORT [6] TITLESORT [6]
Track Subtitle[11] TT3 TIT3 ----:com.apple.iTunes:SUBTITLE [6] WM/SubTitle [6] SUBTITLE [6] Subtitle
Version VERSION S [7] [8]
Part PART M [8]
Opus OPUS S [8]
Movement Name MVNM [6] ©mvn [13] MOVEMENTNAME [6] MOVEMENTNAME [6]
Chapter name CHAPTERxxxNAME [14]

People & Organizations

Name ID3v1.1 [1] ID3v2.2 [2] ID3v2.3 [3] ID3v2.4 [4] iTunes MP4 WMA [5] Vorbis Comment APEv2 Matroska RIFF UPnP
Album Artist TP2 TPE2 aART [6] WM/AlbumArtist [6] ALBUMARTIST [15][6] Album Artist [6] upnp:albumArtist [10]
Album Artist Sort Order TSO2 [11] / TXXX:ALBUMARTISTSORT [6] soaa [6] WM/AlbumArtistSortOrder [6] ALBUMARTISTSORT [6] ALBUMARTISTSORT [6]
Track Artist Artist (30 chars) TP1 TPE1 ©ART [6] Author [6] ARTIST S [7][8] Artist [6] IART [9] upnp:artist [10]
Track Artist Sort Order [11] TSOP [11] / XSOP [6] TSOP soar [6] WM/ArtistSortOrder [6] ARTISTSORT [6]
Arranger IPL:arranger IPLS:arranger [6] TIPL:arranger ©arg [13] ARRANGER M [8] Arranger [6]
Author / Writer TXT TEXT ©aut [13] AUTHOR M [8] IWRI [12]
Writer [6] [see Lyricist] WRITER [6] Writer [6]
Composer TCM TCOM ©wrt [6] / ©com WM/Composer [6] COMPOSER M [8][16] Composer [6] IMUS [12] upnp:author [10]
Composer Sort Order TSOC [11] soco [6]
Conductor TP3 TPE3 ----:com.apple.iTunes:CONDUCTOR [6] / ©con [17] WM/Conductor [6] CONDUCTOR M [8] Conductor [6]
Engineer [6] IPL:engineer IPLS:engineer TIPL:engineer ----:com.apple.iTunes:ENGINEER [6] ENGINEER [6] Engineer [6]
Ensemble ENSEMBLE M [8]
Involved People [17] IPL IPLS TIPL
Lyricist TXT=Lyricist/Lyrics TEXT [11] [6] ----:com.apple.iTunes:LYRICIST [6] WM/Writer [6] LYRICIST M [8] Lyricist
Mix-DJ [6] IPL:DJ-mix IPLS:DJ-mix [6] TIPL:DJ-mix [6] ----:com.apple.iTunes:DJMIXER [6] DJMIXER [6] DJMixer [6]
Mix Engineer [6] IPL:mix IPLS:mix [6] TIPL:mix [6] ----:com.apple.iTunes:MIXER [6] MIXER [6] Mixer [6]
Musician Credits [17] TMCL
Narrator ©nrt [13]
Organisation ORGANIZATION [7]
Original Artist [11] TOA TOPE ©ope [13] WM/OriginalArtist
Original Lyricist [17] TOL TOLY WM/OriginalLyricist
Performer IPLS:instrument [6] TMCL:instrument [6] perf [13] PERFORMER M [7][8] Performer [6]
Producer [6] IPL:producer IPLS:producer TIPL:producer ----:com.apple.iTunes:PRODUCER / ©prd WM/Producer PRODUCER Producer IPRO [12] upnp:producer [18]
Publisher TPB TPUB ©pub [13] PUBLISHER S [8] upnp:publisher [18]
Label ----:com.apple.iTunes:LABEL [6] / ©lab WM/Publisher [6] LABEL S [8] Label [6]
Label Number LABELNO S [8]
(Internet[3]) Radio Station [11] TRSN WM/RadioStationName
(internet[3]) Radio Station Owner [11] TRSO WM/RadioStationOwner
Remixed By [11] / Mix Artist [17] TP4 TPE4 ----:com.apple.iTunes:REMIXER [6] WM/ModifiedBy [6] REMIXER [6] MixArtist [6]
Soloist ©sol [13]
Soloists SOLOISTS [15]

Counts & Indexes

Name ID3v1.1 [1] ID3v2.2 [2] ID3v2.3 [3] ID3v2.4 [4] iTunes MP4 WMA [5] Vorbis Comment APEv2 Matroska RIFF UPnP
Disc Number TPA=Disc Number/Disc Total TPOS=Disc Number/Disc Total disk [6] WM/PartOfSet [6] DISCNUMBER S [8] 4 Disc [6]
Disc Total DISCTOTAL [16] or TOTALDISCS [6]
Track Number Album Track TRK=Track Number/Track Total TRCK=Track Number/Track Total trkn [6] WM/TrackNumber [6] TRACKNUMBER S [7] [8] Track [6] IPRT [12] or ITRK [9] upnp:originalTrackNumber [10]
Track Total TRACKTOTAL [16] or TOTALTRACKS [6] IFRM [12]
Movement Number MVIN=Movement Number/Movement Total [6] ©mvi [13] MOVEMENT [6] MOVEMENT [6]
Movement Total ©mvc [13] MOVEMENTTOTAL [6] MOVEMENTTOTAL [6]
Part Number PARTNUMBER M [8] PRT1
Part Total PRT2
Play Count CNT PCNT
Chapter Start Time CHAPTERxxx [14]
Length [17] TLE TLEN TLEN
Popularimeter [17] / Rating [6] POP POPM WM/SharedUserRating [6] RATING:user@email [6]
Content Rating (PG, not popularity) rate RATING [15] (popularity?) IRTD [12] pv:rating [10]

Dates

Name ID3v1.1 [1] ID3v2.2 [2] ID3v2.3 [3] ID3v2.4 [4] iTunes MP4 WMA [5] Vorbis Comment APEv2 Matroska RIFF UPnP
Recording Date TYE+TDA(+TIM) TYER+TDAT(+TIME[19]) TDRC ©day (?) [6] DATE M [7][8] ICRD [12][9] but [12]=written dc:date [10][18]
Year Year (4 chars) TYE TYER part of TDRC WM/Year [6] part of DATE Year [6]
Original Release Date TOR (year) TORY (year) TDOR WM/OriginalReleaseYear (year) [6] ORIGINALDATE [6]
Original Release Time WM/OriginalReleaseTime
Recording Dates, long date format [11] TRD TRDA TXXX:recording dates [11]
Release Date [11] TDRL (release time)
Tagging Time [17] TDTG
Period WM/Period PERIOD [15]

Identifiers

Name ID3v1.1 [1] ID3v2.2 [2] ID3v2.3 [3] ID3v2.4 [4] iTunes MP4 WMA [5] Vorbis Comment APEv2 Matroska RIFF UPnP
ISRC TRC TSRC ----:com.apple.iTunes:ISRC [6] / ©isr WM/ISRC [6] ISRC S [7][8] ISRC [6]
EAN EAN/UPN S [8]
Product Number PRODUCTNUMBER [16]
Barcode [6] TXXX:BARCODE ----:com.apple.iTunes:BARCODE WM/Barcode BARCODE [6] Barcode
Catalogue Number TXXX:CATALOGNUMBER [6] ----:com.apple.iTunes:CATALOGNUMBER [6] WM/CatalogNo [6] CATALOGNUMBER [6] CatalogNumber [6]
MCN (Media Catalog Number) [20] CATALOG
UPC UPC [15]
AcoustID [6] TXXX:Acoustid Id ----:com.apple.iTunes:Acoustid Id Acoustid/Id ACOUSTID_ID ACOUSTID_ID
AcoustID Fingerprint [6] TXXX:Acoustid Fingerprint ----:com.apple.iTunes:Acoustid Fingerprint Acoustid/Fingerprint ACOUSTID_FINGERPRINT ACOUSTID_FINGERPRINT
AccurateRip Disc ID ACCURATERIPDISCID S [15]
CD TOC MCI MCDI WM/MCDI [21] ITOC [21]
CDDB1 Disc ID
MusicBrainz IDs [6] Various
Podcast ID TGID [17]
XID (?) [22] xid

Flags

Name ID3v1.1 [1] ID3v2.2 [2] ID3v2.3 [3] ID3v2.4 [4] iTunes MP4 WMA [5] Vorbis Comment APEv2 Matroska RIFF UPnP
Compilation TCMP cpil [6] COMPILATION S [15] [6] Compilation [6]
Podcast [17] PCST [23] pcst [6]
Content Rating (e.g. "Explicit") TXXX:ITUNESADVISORY rtng [13]
Media Type (e.g. Music, Audiobook) stik [13]
Show Movement shwm [13]

Ripping & Encoding

Name ID3v1.1 [1] ID3v2.2 [2] ID3v2.3 [3] ID3v2.4 [4] iTunes MP4 WMA [5] Vorbis Comment APEv2 Matroska RIFF UPnP
Encoded By (person/organisation) TEN TENC ©enc [13] WM/EncodedBy [6] ENCODED-BY S [8] [24] [16] EncodedBy [6] ITCH [12]
Encoder (software) TSS TSSE ©too [6] WM/ToolName + WM/ToolVersion ENCODER [24] [16] ISFT [12]
Encoder Settings WM/EncodingSettings ENCODING S [8] / ENCODER SETTINGS S [15]
Encoding Time [17] TDEN
Gapless Playback pgap [6]
File Type [17] TFT TFLT
Media Type [11] / Release Format [6] TMT TMED ----:com.apple.iTunes:MEDIA [6] WM/Media [6] MEDIA [6] Media [6] ISRF [12]
Source Media SOURCEMEDIA S [8] [16]
Source SOURCE [15]
Original Filename [17] TOF TOFN
AccurateRip Result ACCURATERIPRESULT S [15]
ReplayGain Album Gain TXX:REPLAYGAIN_ALBUM_GAIN (?) TXXX:REPLAYGAIN_ALBUM_GAIN REPLAYGAIN_ALBUM_GAIN S [24]
ReplayGain Album Peak TXX:REPLAYGAIN_ALBUM_PEAK (?) TXXX:REPLAYGAIN_ALBUM_PEAK REPLAYGAIN_ALBUM_PEAK S [24]
ReplayGain Track Gain TXX:REPLAYGAIN_TRACK_GAIN (?) TXXX:REPLAYGAIN_TRACK_GAIN REPLAYGAIN_TRACK_GAIN S [24]
ReplayGain Track Peak TXX:REPLAYGAIN_TRACK_PEAK (?) TXXX:REPLAYGAIN_TRACK_PEAK REPLAYGAIN_TRACK_PEAK S [24]

URLs

Name ID3v1.1 [1] ID3v2.2 [2] ID3v2.3 [3] ID3v2.4 [4] iTunes MP4 WMA [5] Vorbis Comment APEv2 Matroska RIFF UPnP
Album Cover URL WM/AlbumCoverURL
Audio Source Webpage URL [11] WAS WOAS
Chapter URL [14] CHAPTERxxxURL
Commercial Information URL [11] WCM WCOM
Copyright URL WCP WCOP CopyrightURL
File Creator URL ©mal
File Webpage URL [11] WAF WOAF WM/AudioFileURL
Label URL ©lal
Payment URL [11] WPAY
Podcast URL [17] WFED [23] purl [6]
Publisher URL [11] WPB WPUB
Radio Station URL [17] WORS
Track Artist Web Page URL 7 WAR WOAR ©prl WM/AuthorURL WEBSITE Weblink

Style

Name ID3v1.1 [1] ID3v2.2 [2] ID3v2.3 [3] ID3v2.4 [4] iTunes MP4 WMA [5] Vorbis Comment APEv2 Matroska RIFF UPnP
Genre Genre (byte 80 or 126) TCO TCON ©gen [6] / gnre [13] WM/Genre [6] GENRE M [7][8] IGNR [9] upnp:genre [10][18]
Genre ID geID [13] WM/GenreID
Beats Per Minute 7 TBP TBPM tmpo [6] WM/BeatsPerMinute [6] BPM [6]
Initial Key TKE TKEY WM/InitialKey
Mood [17] TMOO ----:com.apple.iTunes:MOOD [6] WM/Mood [6] MOOD [6] Mood [6]
Style STYLE M [15]

Miscellaneous

Name ID3v1.1 [1] ID3v2.2 [2] ID3v2.3 [3] ID3v2.4 [4] iTunes MP4 WMA [5] Vorbis Comment APEv2 Matroska RIFF UPnP
Comments Comment (28 chars) COM COMM ©cmt WM/Comments COMMENT M [8] Comment ICMT [12][9]
Description TIT3 (!)[19] desc [19] DESCRIPTION [7]
Podcast [17] / Long [19] Description TDES [23] [17] ldes [19]
Contact CONTACT [7]
Copyright © Message TCR TCOP cprt [6] Copyright [6] COPYRIGHT S [7][8] Copyright [6] ICOP [12]
Artwork PIC APIC covr METADATA_BLOCK_PICTURE [24][16] or COVERART (Deprecated)[24] Varies
Instrument INSTRUMENT [15] (with performer?)[6]
Language [11] TLA TLAN ----:com.apple.iTunes:LANGUAGE [6] WM/Language [6] LANGUAGE [6] Language [6] ILNG [12] dc:language [18]
License [6] WCP (single URL) WCOP (single URL) / TXXX:LICENSE (multiple or non-URL) [6] ----:com.apple.iTunes:LICENSE LICENSE LICENSE S [7] [8]
Location LOCATION M [7] [8]
(File) Owner [11] TOWN
Podcast Category [17] TCAT [23] catg [19]
Podcast Keywords [19] TKWD keyw
Podcast GUID [19] TGID egid
Recording Copyright ℗ Message TPRO ©phg
Rights RIGHTS [24] (proposed)
Script [6] TXXX:SCRIPT ----:com.apple.iTunes:SCRIPT WM/Script SCRIPT Script
Synced Lyrics SLT SYLT WM/Lyrics_Synchronised
Unsynced Lyrics [11] TXT=Lyricist/Lyrics USLT ©lyr [6] WM/Lyrics [6] LYRICS [6] Lyrics [6]

Additional Information

Ape pictures

APEv2 stores each picture type with a different key according to the ID3v2 [4] APIC frame's picture type. This is unlike other formats, ID3v2 for example, where all pictures are under a single ID ("APIC") and identified by a picture type.

Picture Type APEv2 key
Other Cover Art (Other)
32x32 pixels 'file icon' (PNG only) Cover Art (Png Icon)
Other file icon Cover Art (Icon)
Cover (front) Cover Art (Front)
Cover (back) Cover Art (Back)
Leaflet page Cover Art (Leaflet)
Media (e.g. label side of CD) Cover Art (Media)
Lead artist/lead performer/soloist Cover Art (Lead Artist)
Artist/performer Cover Art (Artist)
Conductor Cover Art (Conductor)
Band/Orchestra Cover Art (Band)
Composer Cover Art (Composer)
Lyricist/text writer Cover Art (Lyricist)
Recording Location Cover Art (Recording Location)
During recording Cover Art (During Recording)
During performance Cover Art (During Performance)
Movie/video screen capture Cover Art (Video Capture)
A bright coloured fish Cover Art (Fish)
Illustration Cover Art (Illustration)
Band/artist logotype Cover Art (Band Logotype)
Publisher/Studio logotype Cover Art (Publisher Logotype)

Issues

Due to the re-purposing of ID3v2's TPE2 as Album Artist, we have no field to store the name of the Orchestra, yet we have a dedicated field for the Conductor.

Author / Writer / Lyricist clash through ID3v2 (worse if artist=author or title=author!)

Performers vs involved people vs musicians. All musicians are involved people; not all involved people are necessarily musicians!

Dates - some are specific (recorded/released/tagged) others are just a non-specific date.

Mp3tag

Mp3tag contains some mappings in its initial configuration:

Tag Source Target
VorbisComment DATE YEAR
VorbisComment ORGANIZATION PUBLISHER
VorbisComment TRACKNUMBER TRACK

These mappings were previously internal to Mp3tag, they are now included as initial values in the "User-defined field mappings" preference, which was introduced in version 2.45.

Notes

  1. 1.0 1.1 1.2 1.3 1.4 1.5 1.6 1.7 1.8 1.9 ID3v1.1 at id3.org
  2. 2.0 2.1 2.2 2.3 2.4 2.5 2.6 2.7 2.8 2.9 ID3v2.2 at id3.org
  3. 3.00 3.01 3.02 3.03 3.04 3.05 3.06 3.07 3.08 3.09 3.10 3.11 ID3v2.3 at id3.org
  4. 4.00 4.01 4.02 4.03 4.04 4.05 4.06 4.07 4.08 4.09 4.10 ID3v2.4 at id3.org
  5. 5.0 5.1 5.2 5.3 5.4 5.5 5.6 5.7 5.8 5.9 Windows Media Format Attribute List
  6. 6.000 6.001 6.002 6.003 6.004 6.005 6.006 6.007 6.008 6.009 6.010 6.011 6.012 6.013 6.014 6.015 6.016 6.017 6.018 6.019 6.020 6.021 6.022 6.023 6.024 6.025 6.026 6.027 6.028 6.029 6.030 6.031 6.032 6.033 6.034 6.035 6.036 6.037 6.038 6.039 6.040 6.041 6.042 6.043 6.044 6.045 6.046 6.047 6.048 6.049 6.050 6.051 6.052 6.053 6.054 6.055 6.056 6.057 6.058 6.059 6.060 6.061 6.062 6.063 6.064 6.065 6.066 6.067 6.068 6.069 6.070 6.071 6.072 6.073 6.074 6.075 6.076 6.077 6.078 6.079 6.080 6.081 6.082 6.083 6.084 6.085 6.086 6.087 6.088 6.089 6.090 6.091 6.092 6.093 6.094 6.095 6.096 6.097 6.098 6.099 6.100 6.101 6.102 6.103 6.104 6.105 6.106 6.107 6.108 6.109 6.110 6.111 6.112 6.113 6.114 6.115 6.116 6.117 6.118 6.119 6.120 6.121 6.122 6.123 6.124 6.125 6.126 6.127 6.128 6.129 6.130 6.131 6.132 6.133 6.134 6.135 6.136 6.137 6.138 6.139 6.140 6.141 6.142 6.143 6.144 6.145 6.146 6.147 6.148 6.149 6.150 6.151 6.152 6.153 6.154 6.155 6.156 6.157 6.158 6.159 6.160 6.161 6.162 MusicBrainz Picard Tag Mapping
  7. 7.00 7.01 7.02 7.03 7.04 7.05 7.06 7.07 7.08 7.09 7.10 7.11 7.12 7.13 7.14 Ogg Vorbis I format specification: comment field and header specification at Xiph.org
  8. 8.00 8.01 8.02 8.03 8.04 8.05 8.06 8.07 8.08 8.09 8.10 8.11 8.12 8.13 8.14 8.15 8.16 8.17 8.18 8.19 8.20 8.21 8.22 8.23 8.24 8.25 8.26 8.27 8.28 8.29 Ogg Vorbis Comment Field Recommendations
  9. 9.0 9.1 9.2 9.3 9.4 9.5 9.6 foobar2000 RIFF WAV tagging
  10. 10.0 10.1 10.2 10.3 10.4 10.5 10.6 10.7 10.8 Mapping your Media file tags to the Twonky Database
  11. 11.00 11.01 11.02 11.03 11.04 11.05 11.06 11.07 11.08 11.09 11.10 11.11 11.12 11.13 11.14 11.15 11.16 11.17 11.18 11.19 11.20 11.21 11.22 11.23 11.24 11.25 11.26 11.27 foobar2000:ID3 Tag Mapping
  12. 12.00 12.01 12.02 12.03 12.04 12.05 12.06 12.07 12.08 12.09 12.10 12.11 12.12 12.13 12.14 Tag Frame Reference by Age Bosma
  13. 13.00 13.01 13.02 13.03 13.04 13.05 13.06 13.07 13.08 13.09 13.10 13.11 13.12 13.13 13.14 13.15 ExifTool QuickTime Tags
  14. 14.0 14.1 14.2 Chapter Extension at XiphWiki
  15. 15.00 15.01 15.02 15.03 15.04 15.05 15.06 15.07 15.08 15.09 15.10 15.11 dBPowerAMP
  16. 16.0 16.1 16.2 16.3 16.4 16.5 16.6 16.7 Field names at XiphWiki
  17. 17.00 17.01 17.02 17.03 17.04 17.05 17.06 17.07 17.08 17.09 17.10 17.11 17.12 17.13 17.14 17.15 17.16 17.17 17.18 Mp3tag Help - Tag field mappings
  18. 18.0 18.1 18.2 18.3 18.4 UPnP Service Template
  19. 19.0 19.1 19.2 19.3 19.4 19.5 19.6 19.7 get_iplayer Metadata Tagging
  20. CDRWIN User's Guide
  21. 21.0 21.1 FLAC & Ogg Vorbis Storage of CDTOC at dBPowerAmp
  22. iTunes LP Development Guide
  23. 23.0 23.1 23.2 23.3 iTunes podcast extensions
  24. 24.0 24.1 24.2 24.3 24.4 24.5 24.6 24.7 24.8 VorbisComment at XiphWiki

Cite error: <ref> tag with name "matroska" defined in <references> is not used in prior text.

See also

External links

Other similar tag mappings: