Tag Mapping

From Hydrogenaudio Knowledgebase
Revision as of 01:40, 21 August 2021 by Serial (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.


Mapping Tables

Titles

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

People & Organizations

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

Counts & Indexes

Name ID3v1.1 [1] ID3v2.2 [2] ID3v2.3 [3] ID3v2.4 [4] iTunes MP4 WMA Vorbis Comment APEv2 Matroska RIFF UPnP
Disc Number TPA=Disc Number/Disc Total TPOS=Disc Number/Disc Total disk [5] WM/PartOfSet [5] DISCNUMBER S [7] 4 Disc [5]
Disc Total DISCTOTAL [14] or TOTALDISCS [5]
Track Number Album Track TRK=Track Number/Track Total TRCK=Track Number/Track Total trkn [5] WM/TrackNumber [5] TRACKNUMBER S [6] [7] Track [5] IPRT [11] or ITRK [8] upnp:originalTrackNumber [9]
Track Total TRACKTOTAL [14] or TOTALTRACKS [5] IFRM [11]
Part Number PARTNUMBER M [7]
Chapter start time CHAPTERxxx [12]
Length [15] TLE TLEN
Popularimeter [15] or Rating [5] POP POPM WM/SharedUserRating [5] RATING:user@email [5]
Rating (double meaning) rate (PG not popularity) RATING [13] (popularity?) IRTD [11] (PG not popularity) pv:rating [9] (PG not popularity)

Dates

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

Identifiers

Name ID3v1.1 [1] ID3v2.2 [2] ID3v2.3 [3] ID3v2.4 [4] iTunes MP4 WMA Vorbis Comment APEv2 Matroska RIFF UPnP
ISRC TRC TSRC ----:com.apple.iTunes:ISRC [5] WM/ISRC [5] ISRC S [6] [7] ISRC [5]
EAN EAN/UPN S [7]
Product Number PRODUCTNUMBER [14]
Barcode [5] TXXX:BARCODE ----:com.apple.iTunes:BARCODE WM/Barcode BARCODE [5] Barcode
Catalogue Number TXXX:CATALOGNUMBER [5] ----:com.apple.iTunes:CATALOGNUMBER [5] WM/CatalogNo [5] CATALOGNUMBER [5] CatalogNumber [5]
UPC UPC [13]
MusicBrainz IDs [5] Various
CDDB ID?
AccurateRip Disc ID ACCURATERIPDISCID S [13]
Podcast ID TGID [15]
CD TOC WM/MCID [18] ITOC [18]

Flags

Name ID3v1.1 [1] ID3v2.2 [2] ID3v2.3 [3] ID3v2.4 [4] iTunes MP4 WMA Vorbis Comment APEv2 Matroska RIFF UPnP
Compilation TCMP cpil [5] COMPILATION S [13] [5] Compilation [5]
Podcast [15] PCST [19] pcst [5]

Ripping & Encoding

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

URLs

Name ID3v1.1 [1] ID3v2.2 [2] ID3v2.3 [3] ID3v2.4 [4] iTunes MP4 WMA Vorbis Comment APEv2 Matroska RIFF UPnP
Audio Source Webpage URL [10] WAS WOAS
Chapter URL [12] CHAPTERxxxURL
Commercial Information URL [10] WCM WCOM
Copyright URL WCP WCOP
File Webpage URL [10] WAF WOAF
Track Artist Web Page URL 7 WAR WOAR
Radio Station URL [15] WORS
Payment URL [10] WPAY
Publisher URL [10] WPB WPUB
Podcast URL [15] WFED [19] purl [5]

Style

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

Miscellaneous

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

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 https://id3.org/ID3v1
  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 https://id3.org/id3v2-00
  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 https://id3.org/id3v2.3.0
  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 https://id3.org/id3v2.4.0-frames
  5. 5.000 5.001 5.002 5.003 5.004 5.005 5.006 5.007 5.008 5.009 5.010 5.011 5.012 5.013 5.014 5.015 5.016 5.017 5.018 5.019 5.020 5.021 5.022 5.023 5.024 5.025 5.026 5.027 5.028 5.029 5.030 5.031 5.032 5.033 5.034 5.035 5.036 5.037 5.038 5.039 5.040 5.041 5.042 5.043 5.044 5.045 5.046 5.047 5.048 5.049 5.050 5.051 5.052 5.053 5.054 5.055 5.056 5.057 5.058 5.059 5.060 5.061 5.062 5.063 5.064 5.065 5.066 5.067 5.068 5.069 5.070 5.071 5.072 5.073 5.074 5.075 5.076 5.077 5.078 5.079 5.080 5.081 5.082 5.083 5.084 5.085 5.086 5.087 5.088 5.089 5.090 5.091 5.092 5.093 5.094 5.095 5.096 5.097 5.098 5.099 5.100 5.101 5.102 5.103 5.104 5.105 5.106 5.107 5.108 5.109 5.110 5.111 5.112 5.113 5.114 5.115 5.116 5.117 5.118 5.119 5.120 5.121 5.122 5.123 5.124 5.125 5.126 5.127 5.128 5.129 5.130 5.131 5.132 5.133 5.134 5.135 5.136 5.137 5.138 5.139 5.140 5.141 5.142 5.143 5.144 5.145 5.146 5.147 5.148 5.149 MusicBrainz Picard tag mapping http://picard.musicbrainz.org/docs/mappings/
  6. 6.00 6.01 6.02 6.03 6.04 6.05 6.06 6.07 6.08 6.09 6.10 6.11 6.12 6.13 6.14 http://xiph.org/vorbis/doc/v-comment.html
  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 7.15 7.16 7.17 7.18 7.19 7.20 7.21 7.22 7.23 7.24 7.25 7.26 7.27 7.28 7.29 http://age.hobba.nl/audio/mirroredpages/ogg-tagging.html
  8. 8.0 8.1 8.2 8.3 8.4 8.5 8.6 foobar2k RIFF WAV tagging http://www.hydrogenaudio.org/forums/index.php?showtopic=105749&st=0&p=865737&#entry865737
  9. 9.0 9.1 9.2 9.3 9.4 9.5 9.6 9.7 9.8 Twonky http://www.twonkyforum.com/mediawiki/index.php/Mapping_your_Media_file_tags_to_the_Twonky_Database
  10. 10.00 10.01 10.02 10.03 10.04 10.05 10.06 10.07 10.08 10.09 10.10 10.11 10.12 10.13 10.14 10.15 10.16 10.17 10.18 10.19 10.20 10.21 10.22 10.23 10.24 10.25 10.26 10.27 foobar2k ID3 Tag Mapping http://wiki.hydrogenaudio.org/index.php?title=Foobar2000:ID3_Tag_Mapping
  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 Age Bosma http://age.hobba.nl/audio/tag_frame_reference.html
  12. 12.0 12.1 12.2 http://wiki.xiph.org/Chapter_Extension
  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 dBPowerAMP
  14. 14.0 14.1 14.2 14.3 14.4 14.5 14.6 14.7 http://wiki.xiph.org/Field_names
  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 15.12 15.13 15.14 15.15 15.16 15.17 mp3tag main tags http://help.mp3tag.de/main_tags.html
  16. 16.0 16.1 16.2 16.3 16.4 UPnP http://www.upnp.org/specs/av/UPnP-av-ContentDirectory-v3-Service.pdf
  17. 17.0 17.1 17.2 17.3 17.4 17.5 17.6 17.7 17.8 DinkyPumpkin https://github.com/dinkypumpkin/get_iplayer/wiki/tagging
  18. 18.0 18.1 dBPowerAmp storage of CDTOC https://forum.dbpoweramp.com/showthread.php?16705-FLAC-amp-Ogg-Vorbis-Storage-of-CDTOC
  19. 19.0 19.1 19.2 19.3 Podcast extensions https://github.com/judwhite/IdSharp/pull/1
  20. 20.0 20.1 20.2 20.3 20.4 20.5 20.6 20.7 20.8 http://wiki.xiph.org/VorbisComment

See also

External links

Other similar tag mappings: