Tag Mapping

From Hydrogenaudio Knowledgebase
Jump to: navigation, search

Introduction[edit]

This page is under construction. Please do not rely on the content being accurate or trustworthy.

This page attempts to document a useful mapping between the tagging schemes used on various file formats. The aim is to allow tag data (metadata) to be transferred between file formats without information loss.

It is 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[edit]

Titles[edit]

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

People & Organizations[edit]

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

Counts & Indexes[edit]

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

Dates[edit]

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

Identifiers[edit]

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

Flags[edit]

Name ID3v1.1 [1] ID3v2.3 [2] ID3v2.4 [3] iTunes MP4 WMA Vorbis Comment APEv2 Matroska RIFF UPnP
Compilation TCMP TCMP cpil [4] COMPILATION S [12] [4] Compilation [4]
Podcast [14] PCST [17] PCST [17] pcst [4]

Ripping & Encoding[edit]

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

URLs[edit]

Name ID3v1.1 [1] ID3v2.3 [2] ID3v2.4 [3] iTunes MP4 WMA Vorbis Comment APEv2 Matroska RIFF UPnP
Audio Source Webpage URL [9] WOAS [2] WOAS
Chapter URL [11] CHAPTERxxxURL
Commercial Information URL [9] WCOM [2] WCOM
Copyright URL WCOP [2] WCOP
File Webpage URL [9] WOAF [2] WOAF
Track Artist Web Page URL 7 WOAR [2] WOAR
Internet Radio Webpage URL WORS [2] WORS
Radio Station URL [14] WORS [2] WORS
Payment URL [9] WPAY [2] WPAY
Publisher ?URL? [9] TPUB [2] not URL TPUB
Podcast URL [14] WFED [17] WFED [17] purl [4]

Style[edit]

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

Miscellaneous[edit]

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

Additional Information[edit]

Issues[edit]

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.

Notes[edit]

  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 http://id3.org/ID3v1
  2. 2.00 2.01 2.02 2.03 2.04 2.05 2.06 2.07 2.08 2.09 2.10 2.11 2.12 2.13 2.14 2.15 2.16 2.17 2.18 2.19 2.20 2.21 2.22 2.23 2.24 2.25 2.26 2.27 2.28 2.29 2.30 2.31 2.32 2.33 2.34 2.35 2.36 2.37 2.38 2.39 2.40 2.41 2.42 2.43 2.44 2.45 2.46 2.47 2.48 2.49 2.50 2.51 2.52 2.53 2.54 2.55 2.56 2.57 2.58 2.59 2.60 2.61 2.62 2.63 2.64 2.65 2.66 2.67 2.68 2.69 2.70 2.71 2.72 2.73 2.74 ID3v2.3 at id3.org http://id3.org/id3v2.3.0
  3. 3.0 3.1 3.2 3.3 3.4 3.5 3.6 3.7 3.8 3.9 ID3v2.4 at id3.org http://id3.org/id3v2.4.0-frames
  4. 4.000 4.001 4.002 4.003 4.004 4.005 4.006 4.007 4.008 4.009 4.010 4.011 4.012 4.013 4.014 4.015 4.016 4.017 4.018 4.019 4.020 4.021 4.022 4.023 4.024 4.025 4.026 4.027 4.028 4.029 4.030 4.031 4.032 4.033 4.034 4.035 4.036 4.037 4.038 4.039 4.040 4.041 4.042 4.043 4.044 4.045 4.046 4.047 4.048 4.049 4.050 4.051 4.052 4.053 4.054 4.055 4.056 4.057 4.058 4.059 4.060 4.061 4.062 4.063 4.064 4.065 4.066 4.067 4.068 4.069 4.070 4.071 4.072 4.073 4.074 4.075 4.076 4.077 4.078 4.079 4.080 4.081 4.082 4.083 4.084 4.085 4.086 4.087 4.088 4.089 4.090 4.091 4.092 4.093 4.094 4.095 4.096 4.097 4.098 4.099 4.100 4.101 4.102 4.103 4.104 4.105 4.106 4.107 4.108 4.109 4.110 4.111 4.112 4.113 4.114 4.115 4.116 4.117 4.118 4.119 4.120 4.121 4.122 4.123 4.124 4.125 4.126 4.127 4.128 4.129 4.130 4.131 4.132 4.133 4.134 4.135 4.136 4.137 4.138 4.139 4.140 4.141 4.142 4.143 4.144 4.145 4.146 4.147 4.148 4.149 4.150 4.151 4.152 4.153 4.154 4.155 4.156 MusicBrainz Picard tag mapping http://wiki.musicbrainz.org/MusicBrainz_Picard/Tags/Mapping
  5. 5.00 5.01 5.02 5.03 5.04 5.05 5.06 5.07 5.08 5.09 5.10 5.11 5.12 5.13 5.14 http://xiph.org/vorbis/doc/v-comment.html
  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 6.15 6.16 6.17 6.18 6.19 6.20 6.21 6.22 6.23 6.24 6.25 6.26 6.27 6.28 6.29 http://age.hobba.nl/audio/mirroredpages/ogg-tagging.html
  7. 7.0 7.1 7.2 7.3 7.4 7.5 7.6 foobar2k RIFF WAV tagging http://www.hydrogenaudio.org/forums/index.php?showtopic=105749&st=0&p=865737&#entry865737
  8. 8.0 8.1 8.2 8.3 8.4 8.5 8.6 8.7 8.8 Twonky http://www.twonkyforum.com/mediawiki/index.php/Mapping_your_Media_file_tags_to_the_Twonky_Database
  9. 9.00 9.01 9.02 9.03 9.04 9.05 9.06 9.07 9.08 9.09 9.10 9.11 9.12 9.13 9.14 9.15 9.16 9.17 9.18 9.19 9.20 9.21 9.22 9.23 9.24 9.25 9.26 9.27 9.28 9.29 9.30 foobar2k ID3 Tag Mapping http://wiki.hydrogenaudio.org/index.php?title=Foobar2000:ID3_Tag_Mapping
  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 Age Bosma http://age.hobba.nl/audio/tag_frame_reference.html
  11. 11.0 11.1 11.2 http://wiki.xiph.org/Chapter_Extension
  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 dBPowerAMP
  13. 13.0 13.1 13.2 13.3 13.4 13.5 13.6 13.7 http://wiki.xiph.org/Field_names
  14. 14.00 14.01 14.02 14.03 14.04 14.05 14.06 14.07 14.08 14.09 14.10 14.11 14.12 14.13 14.14 14.15 14.16 14.17 14.18 14.19 mp3tag main tags http://help.mp3tag.de/main_tags.html
  15. 15.0 15.1 15.2 15.3 15.4 UPnP http://www.upnp.org/specs/av/UPnP-av-ContentDirectory-v3-Service.pdf
  16. 16.00 16.01 16.02 16.03 16.04 16.05 16.06 16.07 16.08 16.09 16.10 DinkyPumpkin https://github.com/dinkypumpkin/get_iplayer/wiki/tagging
  17. 17.0 17.1 17.2 17.3 17.4 17.5 17.6 17.7 Podcast extensions https://github.com/judwhite/IdSharp/pull/1
  18. 18.0 18.1 18.2 18.3 18.4 18.5 18.6 18.7 18.8 http://wiki.xiph.org/VorbisComment

Links[edit]