Tag Mapping

From Hydrogenaudio Knowledgebase

Jump to: navigation, search

Contents

[edit] Introduction

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.


[edit] Mapping Tables

[edit] Titles

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] upnp:album [7]
Album Title Sort Order TSOA [8] / XSOA [4] TSOA soal [4] WM/AlbumSortOrder [4] ALBUMSORT [4] ALBUMSORT [4]
Original Album Title [8] TOAL [2] TOAL
Disc [4] / Set [8] Subtitle (for multi-disc sets) TSST [8] 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 [8] 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 [9] dc:title [7]
Track Title Sort Order TSOT [8] / XSOT [4] TSOT sonm [4] WM/TitleSortOrder [4] TITLESORT [4] TITLESORT [4]
Track Subtitle[8] 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 [10]

[edit] People & Organizations

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 [11] [4] Album Artist [4] upnp:albumArtist [7]
Album Artist Sort Order TSO2 [8] / 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] upnp:artist [7]
Track Artist Sort Order [8] TSOP [8] / 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]
Writer [4] WRITER [4] Writer [4]
Composer TCOM [2] TCOM ©wrt [4] WM/Composer [4] COMPOSER M [6] [12] Composer [4] IMUS [9] upnp:author [7]
Composer Sort Order [8] TSOC TSOC 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 [13] IPLS [2] TIPL
Lyricist TEXT [2] [8] [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 [13] TMCL
Organisation ORGANIZATION [5]
Original Artist [8] TOPE [2] TOPE
Original Lyricist [13] 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 [9] upnp:producer [14]
Publisher TPUB [2] TPUB PUBLISHER S [6] upnp:publisher [14]
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 [8] TRSN [2] TRSN
(internet[2]) Radio Station Owner [8] TRSO [2] TRSO
Remixed By [8] / Mix Artist [13] TPE4 [2] TPE4 ----:com.apple.iTunes:REMIXER [4] WM/ModifiedBy [4] MixArtist [4]
Soloists SOLOISTS [11]

[edit] Counts & Indexes

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 [12] 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 [9] upnp:originalTrackNumber [7]
Track Total TRCK=Track Number/Track Total [2] " trkn [4] TRACKTOTAL [12] and TOTALTRACKS [4] Track [4] IFRM [9]
Part Number PARTNUMBER M [6]
Chapter start time CHAPTERxxx [10]
Length [13] TLEN [2] TLEN
Popularimeter [13] or Rating [4] POPM [2] POPM WM/SharedUserRating [4] RATING:user@email [4]
Rating (double meaning) rate PG not popularity RATING [11] popularity? pv:rating [7] PG not popularity

[edit] Dates

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

[edit] Identifiers

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 [12]
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 [11]
MusicBrainz IDs [4] Various Various Various
CDDB ID?
AccurateRip Disc ID ACCURATERIPDISCID S [11]
Podcast ID TGID [13] TGID [13]

[edit] Flags

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 [11] [4] Compilation [4]
Podcast [13] PCST [16] PCST [16] pcst [4]

[edit] Ripping & Encoding

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] [17] [12] EncodedBy [4] ITCH [9]
Encoder ENCODER [17] [12]
Encoder Settings TSSE [2] TSSE ENCODER SETTINGS S [11]
Encoding Time [13] TDEN
Encoding ENCODING S [6]
Gapless Playback pgap [4]
File Type [13] TFLT [2] TFLT
Media Type [8] / Release Format [4] TMED [2] [8] TMED ----:com.apple.iTunes:MEDIA [4] WM/Media [4] MEDIA [4] Media [4] ISRF [9]
Source Media SOURCEMEDIA S [6] [12]
Source SOURCE [11]
Original Filename [13] TOFN [2] TOFN
AccurateRip Result ACCURATERIPRESULT S [11]
ReplayGain Album Gain TXXX[2]:REPLAYGAIN_ALBUM_GAIN " REPLAYGAIN_ALBUM_GAIN S [17]
ReplayGain Album Peak TXXX[2]:REPLAYGAIN_ALBUM_PEAK " REPLAYGAIN_ALBUM_PEAK S [17]
ReplayGain Track Gain TXXX[2]:REPLAYGAIN_TRACK_GAIN " REPLAYGAIN_TRACK_GAIN S [17]
ReplayGain Track Peak TXXX[2]:REPLAYGAIN_TRACK_PEAK " REPLAYGAIN_TRACK_PEAK S [17]

[edit] URLs

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

[edit] Style

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] upnp:genre [7] [14]
Initial Key TKEY [2] TKEY
Mood [13] TMOO TMOO ----:com.apple.iTunes:MOOD [4] WM/Mood [4] MOOD [4] Mood [4]
Style STYLE M [11]
Beats Per Minute 7 TBPM [2] TBPM tmpo [4] WM/BeatsPerMinute BPM [4] BPM [4]

[edit] Miscellaneous

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 [9]
Description TIT3(!) [15] " desc [15] DESCRIPTION [5]
Podcast [13] / Long [15] Description TDES [16] [13] TDES [16] [13] ldes [15]
Contact CONTACT [5]
Copyright Message TCOP [2] TCOP cprt [4] Copyright [4] COPYRIGHT S [5] [6] Copyright [4] ICOP [9]
Cover Art APIC [2] APIC METADATA_BLOCK_PICTURE [17] [12] not COVERART [17] which is depreciated
Instrument INSTRUMENT [11] with performer? see [4]
Language [8] TLAN [2] TLAN ----:com.apple.iTunes:LANGUAGE [4] WM/Language [4] LANGUAGE [4] Language [4] ILNG [9] dc:language [14]
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 [8] TOWN [2] TOWN
Podcast Category [13] TCAT [16] TCAT [16] catg [15]
Podcast Keywords [15] TKWD TKWD keyw [15]
Podcast GUID [15] TGID TGID egid [15]
Rights RIGHTS [17] proposed
Script [4] TXXX[2]:SCRIPT TXXX:SCRIPT ----:com.apple.iTunes:SCRIPT WM/Script SCRIPT Script
Unsynced Lyrics [8] USLT [2] USLT ©lyr [4] WM/Lyrics [4] LYRICS [4] Lyrics [4]

[edit] Additional Information

[edit] 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.

[edit] 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 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 7.7 7.8 Twonky http://www.twonkyforum.com/mediawiki/index.php/Mapping_your_Media_file_tags_to_the_Twonky_Database
  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 foobar2k ID3 Tag Mapping http://wiki.hydrogenaudio.org/index.php?title=Foobar2000:ID3_Tag_Mapping
  9. 9.0 9.1 9.2 9.3 9.4 9.5 9.6 9.7 9.8 9.9 Age Bosma http://age.hobba.nl/audio/tag_frame_reference.html
  10. 10.0 10.1 10.2 http://wiki.xiph.org/Chapter_Extension
  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 dBPowerAMP
  12. 12.0 12.1 12.2 12.3 12.4 12.5 12.6 12.7 http://wiki.xiph.org/Field_names
  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 13.16 13.17 13.18 13.19 mp3tag main tags http://help.mp3tag.de/main_tags.html
  14. 14.0 14.1 14.2 14.3 14.4 UPnP http://www.upnp.org/specs/av/UPnP-av-ContentDirectory-v3-Service.pdf
  15. 15.00 15.01 15.02 15.03 15.04 15.05 15.06 15.07 15.08 15.09 15.10 DinkyPumpkin https://github.com/dinkypumpkin/get_iplayer/wiki/tagging
  16. 16.0 16.1 16.2 16.3 16.4 16.5 16.6 16.7 Podcast extensions https://github.com/judwhite/IdSharp/pull/1
  17. 17.0 17.1 17.2 17.3 17.4 17.5 17.6 17.7 17.8 http://wiki.xiph.org/VorbisComment

[edit] Links

Personal tools