Skip to content

Latest commit

 

History

History
118 lines (116 loc) · 72.3 KB

common_metadata.md

File metadata and controls

118 lines (116 loc) · 72.3 KB

Common Metadata

Common tags, and native to common tag mappings. n indicates the multiplicity. The tag mapping is strongly inspired on the MusicBrainz Picard tag-mapping.

Common tag n Description ID3v1 ID3v2.2 ID3v2.3 ID3v2.4 iTunes vorbis APEv2 asf exif matroska AIFF
year 1 Year year TYE TYER TYER YEAR
track 1 Track number on the media, e.g. {no: 1, of: 2} track TRK TRCK TRCK TRKN TRACKNUMBER TRACK WM/TrackNumber ITRK, IPRT TRACK:PART_NUMBER
disk 1 Disk or media number, e.g. {no: 1, of: 2} TPA TPOS TPOS DISK DISCNUMBER DISC, DISCNUMBER WM/PartOfSet ALBUM:PART_NUMBER
title 1 Track title title TT2 TIT2 TIT2 ©NAM TITLE TITLE Title INAM, TITL SEGMENT:TITLE, TRACK:TITLE NAME
artist 1 Literal written track artist e.g.: "Beth Hart & Joe Bonamassa". If not directly specified in a tag, this is automatically filled with common.artists. artist TP1 TPE1 TPE1 ©ART ARTIST ARTIST Author IART TRACK:ARTIST AUTH
artists * Track artists e.g.: ["Beth Hart", "Joe Bonamassa"]. If not directly specified in one or more tag, this is automatically filled with common.artist TXXX:ARTISTS, TXXX:DISCOGS_ARTISTS, TXXX:DISCOGS_ARTIST_NAME TXXX:ARTISTS, TXXX:DISCOGS_ARTISTS, TXXX:DISCOGS_ARTIST_NAME ----:COM.APPLE.ITUNES:ARTISTS ARTISTS, DISCOGS_ARTISTS, DISCOGS_ARTIST_NAME ARTISTS WM/ARTISTS
albumartist 1 Literal written album artist e.g.: "Beth Hart & Joe Bonamassa" TP2 TPE2, TXXX:DISCOGS_ALBUM_ARTISTS TPE2, TXXX:DISCOGS_ALBUM_ARTISTS AART, ----:COM.APPLE.ITUNES:BAND ALBUMARTIST, ALBUM ARTIST, DISCOGS_ALBUM_ARTISTS ALBUM ARTIST WM/AlbumArtist ALBUM:ARTIST
album 1 Album title album TAL TALB TALB ©ALB ALBUM ALBUM WM/AlbumTitle IPRD, IRPD ALBUM:TITLE
date 1 Date, formatted like: YYYY-MM-DD TDR TDRV, TDRC, TXXX:DISCOGS_RELEASED TDRV, TDRC, TXXX:DISCOGS_RELEASED ©DAY DATE, DISCOGS_RELEASED YEAR WM/Year ICRD
originaldate 1 Original (initial) release date, formatted like: YYYY-MM-DD TOR TDOR, TXXX:DISCOGS_DATE TDOR, TXXX:DISCOGS_DATE ----:COM.APPLE.ITUNES:ORIGINALDATE ORIGINALDATE, DISCOGS_DATE ORIGINALDATE WM/OriginalReleaseTime ALBUM:DATE_RECORDED
originalyear 1 Original (initial) release year TORY, TXXX:ORIGINALYEAR TORY, TXXX:ORIGINALYEAR ----:COM.APPLE.ITUNES:ORIGINALYEAR ORIGINALYEAR ORIGINALYEAR WM/OriginalReleaseYear
releasedate 1 Release date, formatted like: YYYY-MM-DD TDRL TDRL ----:COM.APPLE.ITUNES:RELEASEDATE RELEASEDATE RELEASEDATE ALBUM:DATE_RELEASED
comment * Comments comment COM COMM COMM ©CMT, ©COM, ----:COM.APPLE.ITUNES:NOTES COMMENT COMMENT Description COMM, ICMT ANNO
genre * Genres genre TCO TCON, TXXX:STYLE TCON, TXXX:STYLE ©GEN, GNRE GENRE, STYLE GENRE WM/Genre GNRE, IGNR TRACK:GENRE
picture * Embedded cover art PIC APIC APIC COVR METADATA_BLOCK_PICTURE COVER ART (FRONT), COVER ART (BACK) WM/Picture PICTURE
composer * Composer TCM TCOM TCOM ©WRT COMPOSER COMPOSER WM/Composer
lyrics * Lyricist USLT:DESCRIPTION, SYLT USLT:DESCRIPTION, SYLT ©LYR LYRICS LYRICS WM/Lyrics
albumsort 1 Album title, formatted for alphabetic ordering TSA TSOA TSOA SOAL ALBUMSORT ALBUMSORT WM/AlbumSortOrder
titlesort 1 Track title, formatted for alphabetic ordering TST TSOT TSOT SONM TITLESORT TITLESORT WM/TitleSortOrder
work 1 The canonical title of the work ©WRK WORK WORK WM/Work
artistsort 1 Track artist, formatted for alphabetic ordering TSP TSOP TSOP SOAR ARTISTSORT ARTISTSORT WM/ArtistSortOrder TRACK:ARTISTSORT
albumartistsort 1 Album artist, formatted for alphabetic ordering TS2 TSO2 TSO2 SOAA, ----:COM.APPLE.ITUNES:ALBUMARTISTSORT ALBUMARTISTSORT ALBUMARTISTSORT WM/AlbumArtistSortOrder ALBUM:ARTISTSORT
composersort 1 Composer, formatted for alphabetic ordering TSC TSOC TSOC SOCO COMPOSERSORT COMPOSERSORT WM/ComposerSortOrder
lyricist * Lyricist TXT TEXT TEXT ----:COM.APPLE.ITUNES:LYRICIST LYRICIST LYRICIST WM/Writer
writer * Writer TXXX:WRITER TXXX:WRITER WRITER WRITER IWRI
conductor * Conductor TP3 TPE3 TPE3 ----:COM.APPLE.ITUNES:CONDUCTOR CONDUCTOR CONDUCTOR WM/Conductor
remixer * Remixer(s) TPE4 TPE4 ----:COM.APPLE.ITUNES:REMIXER REMIXER MIXARTIST WM/ModifiedBy
arranger * Arranger(s) IPLS:ARRANGER, TIPL:ARRANGER IPLS:ARRANGER, TIPL:ARRANGER ARRANGER ARRANGER
engineer * Engineer(s) IPLS:ENGINEER, TIPL:ENGINEER IPLS:ENGINEER, TIPL:ENGINEER ----:COM.APPLE.ITUNES:ENGINEER ENGINEER ENGINEER WM/Engineer IENG
producer * Producer(s) IPLS:PRODUCER, TIPL:PRODUCER IPLS:PRODUCER, TIPL:PRODUCER ----:COM.APPLE.ITUNES:PRODUCER PRODUCER PRODUCER WM/Producer
technician * Technician who digitized subject ITCH
djmixer * Mix-DJ(s) IPLS:DJ-MIX, TIPL:DJ-MIX IPLS:DJ-MIX, TIPL:DJ-MIX ----:COM.APPLE.ITUNES:DJMIXER DJMIXER DJMIXER WM/DJMixer
mixer * Mixed by IPLS:MIX, TIPL:MIX IPLS:MIX, TIPL:MIX ----:COM.APPLE.ITUNES:MIXER MIXER MIXER WM/Mixer
label * Release label name(s) TPB TPUB, TXXX:DISCOGS_LABEL TPUB, TXXX:DISCOGS_LABEL ----:COM.APPLE.ITUNES:LABEL LABEL, DISCOGS_LABEL LABEL WM/Publisher TRACK:PUBLISHER
grouping 1 Content group description. Used to group track titles in sections. TT1 TIT1 TIT1 ©GRP GROUPING GROUPING WM/ContentGroupDescription
subtitle * Contains the subtitle of the content TT3 TIT3 TIT3 ----:COM.APPLE.ITUNES:SUBTITLE SUBTITLE SUBTITLE WM/SubTitle
discsubtitle 1 The Media Title given to a specific disc TSST TSST ----:COM.APPLE.ITUNES:DISCSUBTITLE DISCSUBTITLE DISCSUBTITLE WM/SetSubTitle
totaltracks 1 The total number of tracks TRACKTOTAL, TOTALTRACKS ALBUM:TOTAL_PARTS
totaldiscs 1 The total number of discs DISCTOTAL, TOTALDISCS EDITION:TOTAL_PARTS
compilation 1 Is part of compilation (unofficial iTunes Compilation Flag) TCP TCMP TCMP CPIL COMPILATION COMPILATION WM/IsCompilation
rating * Object holding rating score [0..1] (0.0 worst rating, 1.0 best rating) and source (e.g. user e-mail) POPM POPM RATE RATING WM/SharedUserRating RATE
bpm 1 Beats Per Minute (BPM) TBP TBPM TBPM TMPO BPM BPM WM/BeatsPerMinute
mood 1 Keywords to reflect the mood of the audio, e.g. "Romantic" or "Sad" TMOO TMOO ----:COM.APPLE.ITUNES:MOOD MOOD MOOD WM/Mood
media 1 Release format TMED TMED ----:COM.APPLE.ITUNES:MEDIA MEDIA MEDIA WM/Media IMED
catalognumber * Release catalog number(s) TXXX:CATALOGNUMBER, TXXX:DISCOGS_CATALOG, TXXX:CATALOGID TXXX:CATALOGNUMBER, TXXX:DISCOGS_CATALOG, TXXX:CATALOGID ----:COM.APPLE.ITUNES:CATALOGNUMBER CATALOGNUMBER, DISCOGS_CATALOG, CATALOGID CATALOGNUMBER WM/CatalogNo
tvShow 1 TV show title TVSH
tvShowSort 1 TV show title, formatted for alphabetic ordering SOSN
tvSeason 1 TV season title TVSN
tvEpisode 1 TV episode title TVES
tvEpisodeId 1 TV episode ID TVEN
tvNetwork 1 TV network TVNN
podcast 1 ToDo, see issues #13 PCS PCST PCST PCST
podcasturl 1 ToDo, see issues #13 WFD WFED WFED PURL
releasestatus 1 See releases status TXXX:MUSICBRAINZ ALBUM STATUS TXXX:MUSICBRAINZ ALBUM STATUS ----:COM.APPLE.ITUNES:MUSICBRAINZ ALBUM STATUS RELEASESTATUS MUSICBRAINZ_ALBUMSTATUS MusicBrainz/Album Status
releasetype * Release type, e,g,: Album TXXX:MUSICBRAINZ ALBUM TYPE TXXX:MUSICBRAINZ ALBUM TYPE ----:COM.APPLE.ITUNES:MUSICBRAINZ ALBUM TYPE RELEASETYPE MUSICBRAINZ_ALBUMTYPE MusicBrainz/Album Type
releasecountry 1 Release country describes the country in which an album was released. TXXX:MUSICBRAINZ ALBUM RELEASE COUNTRY, TXXX:RELEASECOUNTRY, TXXX:DISCOGS_COUNTRY TXXX:MUSICBRAINZ ALBUM RELEASE COUNTRY, TXXX:RELEASECOUNTRY, TXXX:DISCOGS_COUNTRY ----:COM.APPLE.ITUNES:MUSICBRAINZ ALBUM RELEASE COUNTRY RELEASECOUNTRY, DISCOGS_COUNTRY RELEASECOUNTRY MusicBrainz/Album Release Country ICNT
script 1 Release Script TXXX:SCRIPT TXXX:SCRIPT ----:COM.APPLE.ITUNES:SCRIPT SCRIPT SCRIPT WM/Script
language 1 Language used in metadata TLA TLAN TLAN ----:COM.APPLE.ITUNES:LANGUAGE LANGUAGE LANGUAGE WM/Language
copyright 1 Contain copyright message for the copyright holder of the original sound, begin with a year and a space character. TCR TCOP TCOP CPRT, ©CPY COPYRIGHT COPYRIGHT Copyright (c)
license 1 License Relationship Type (releases, recordings) WCP WCOP WCOP ----:COM.APPLE.ITUNES:LICENSE LICENSE LICENSE LICENSE
encodedby 1 Encoded by (person/organisation) TEN TENC TENC ©TOO ENCODEDBY ENCODEDBY WM/EncodedBy ISFT, CODE TRACK:ENCODER
encodersettings 1 Encoder Settings TSS TSSE TSSE ENCODERSETTINGS ENCODERSETTINGS WM/EncodingSettings TRACK:ENCODER_OPTIONS
gapless 1 Gapless album indicator (MP4) COM:ITUNPGAP PGAP
barcode 1 Release barcode. TXXX:BARCODE TXXX:BARCODE ----:COM.APPLE.ITUNES:BARCODE BARCODE BARCODE WM/Barcode
isrc * ISRC TXXX:ISRC, TSRC TXXX:ISRC, TSRC ----:COM.APPLE.ITUNES:ISRC ISRC ISRC WM/ISRC
asin 1 Amazon Standard Identification Number (ASIN) TXXX:ASIN TXXX:ASIN ----:COM.APPLE.ITUNES:ASIN ASIN ASIN ASIN
musicbrainz_recordingid 1 Release recording MBID UFID:HTTP://MUSICBRAINZ.ORG UFID:HTTP://MUSICBRAINZ.ORG ----:COM.APPLE.ITUNES:MUSICBRAINZ TRACK ID MUSICBRAINZ_TRACKID MUSICBRAINZ_TRACKID MusicBrainz/Track Id TRACK:MUSICBRAINZ_TRACKID
musicbrainz_trackid 1 Release track MBID TXXX:MUSICBRAINZ RELEASE TRACK ID TXXX:MUSICBRAINZ RELEASE TRACK ID ----:COM.APPLE.ITUNES:MUSICBRAINZ RELEASE TRACK ID MUSICBRAINZ_RELEASETRACKID MUSICBRAINZ_RELEASETRACKID MusicBrainz/Release Track Id
musicbrainz_albumid 1 Album (release) MBID TXXX:MUSICBRAINZ ALBUM ID TXXX:MUSICBRAINZ ALBUM ID ----:COM.APPLE.ITUNES:MUSICBRAINZ ALBUM ID MUSICBRAINZ_ALBUMID MUSICBRAINZ_ALBUMID MusicBrainz/Album Id TRACK:MUSICBRAINZ_ALBUMID
musicbrainz_artistid * Track artists MBID TXXX:MUSICBRAINZ ARTIST ID TXXX:MUSICBRAINZ ARTIST ID ----:COM.APPLE.ITUNES:MUSICBRAINZ ARTIST ID MUSICBRAINZ_ARTISTID MUSICBRAINZ_ARTISTID MusicBrainz/Artist Id TRACK:MUSICBRAINZ_ARTISTID
musicbrainz_albumartistid * Album artists artists MBID TXXX:MUSICBRAINZ ALBUM ARTIST ID TXXX:MUSICBRAINZ ALBUM ARTIST ID ----:COM.APPLE.ITUNES:MUSICBRAINZ ALBUM ARTIST ID MUSICBRAINZ_ALBUMARTISTID MUSICBRAINZ_ALBUMARTISTID MusicBrainz/Album Artist Id
musicbrainz_releasegroupid 1 Release group MBID TXXX:MUSICBRAINZ RELEASE GROUP ID TXXX:MUSICBRAINZ RELEASE GROUP ID ----:COM.APPLE.ITUNES:MUSICBRAINZ RELEASE GROUP ID MUSICBRAINZ_RELEASEGROUPID MUSICBRAINZ_RELEASEGROUPID MusicBrainz/Release Group Id
musicbrainz_workid 1 Work MBID TXXX:MUSICBRAINZ WORK ID TXXX:MUSICBRAINZ WORK ID ----:COM.APPLE.ITUNES:MUSICBRAINZ WORK ID MUSICBRAINZ_WORKID MUSICBRAINZ_WORKID MusicBrainz/Work Id
musicbrainz_trmid 1 TRM (TRM Recognizes Music) IDs were MusicBrainz’ first audio fingerprinting system. TXXX:MUSICBRAINZ TRM ID TXXX:MUSICBRAINZ TRM ID ----:COM.APPLE.ITUNES:MUSICBRAINZ TRM ID MUSICBRAINZ_TRMID MUSICBRAINZ_TRMID MusicBrainz/TRM Id
musicbrainz_discid 1 Disc ID is the code number which MusicBrainz uses to link a physical CD TXXX:MUSICBRAINZ DISC ID TXXX:MUSICBRAINZ DISC ID ----:COM.APPLE.ITUNES:MUSICBRAINZ DISC ID MUSICBRAINZ_DISCID MUSICBRAINZ_DISCID MusicBrainz/Disc Id
acoustid_id 1 (AcoustID)[https://en.wikipedia.org/wiki/Acoustic_fingerprint] is MusicBrainz’ third and most recent audio fingerprinting system. TXXX:ACOUSTID_ID, TXXX:ACOUSTID ID TXXX:ACOUSTID_ID, TXXX:ACOUSTID ID ----:COM.APPLE.ITUNES:ACOUSTID ID ACOUSTID_ID ACOUSTID_ID Acoustid/Id
acoustid_fingerprint 1 AcoustID Fingerprint. ToDo: Same as acoustid_id. TXXX:ACOUSTID FINGERPRINT TXXX:ACOUSTID FINGERPRINT ----:COM.APPLE.ITUNES:ACOUSTID FINGERPRINT ACOUSTID_ID_FINGERPRINT ACOUSTID_FINGERPRINT Acoustid/Fingerprint
musicip_puid 1 PUIDs were MusicBrainz’ second audio fingerprinting system. TXXX:MUSICIP PUID TXXX:MUSICIP PUID ----:COM.APPLE.ITUNES:MUSICIP PUID MUSICIP_PUID MUSICIP_PUID MusicIP/PUID
musicip_fingerprint 1 MusicIP Fingerprint), not sure which algorithm. TXXX:MUSICMAGIC FINGERPRINT TXXX:MUSICMAGIC FINGERPRINT ----:COM.APPLE.ITUNES:FINGERPRINT
website 1 URL of website WAR WOAR WOAR WEBSITE WEBLINK WM/AuthorURL TURL
performer:instrument * Performer relationship types, instrument can also be vocals.
averageLevel 1 Average gain level. PRIV:AVERAGELEVEL PRIV:AVERAGELEVEL
peakLevel 1 Peak gain level. PRIV:PEAKLEVEL PRIV:PEAKLEVEL
notes * Similar to comments NOTES
key 1 The 'Initial key' frame contains the musical key in which the sound starts. TKEY TKEY KEY WM/InitialKey
originalalbum 1 Original release title of the earliest release in the release group intended for the title of the original recording. TOT TOAL TOAL
originalartist 1 Original track artist of the earliest release in the release group intended for the performer(s) of the original recording. TOPE TOPE
discogs_artist_id * Discogs artist ID TXXX:DISCOGS_ARTIST_ID TXXX:DISCOGS_ARTIST_ID DISCOGS_ARTIST_ID
discogs_release_id 1 Discogs release identifier TXXX:DISCOGS_RELEASE_ID TXXX:DISCOGS_RELEASE_ID DISCOGS_RELEASE_ID
discogs_label_id 1 Discogs label ID TXXX:DISCOGS_LABEL_ID TXXX:DISCOGS_LABEL_ID DISCOGS_LABEL_ID
discogs_master_release_id 1 Discogs master release ID TXXX:DISCOGS_MASTER_RELEASE_ID TXXX:DISCOGS_MASTER_RELEASE_ID DISCOGS_MASTER_RELEASE_ID
discogs_votes 1 Discogs votes TXXX:DISCOGS_VOTES TXXX:DISCOGS_VOTES DISCOGS_VOTES
discogs_rating 1 Discogs rating TXXX:DISCOGS_RATING TXXX:DISCOGS_RATING DISCOGS_RATING
replaygain_track_peak 1 ReplayGain track peak: {ratio: number, dB: number} TXXX:REPLAYGAIN_TRACK_PEAK TXXX:REPLAYGAIN_TRACK_PEAK ----:COM.APPLE.ITUNES:REPLAYGAIN_TRACK_PEAK REPLAYGAIN_TRACK_PEAK REPLAYGAIN_TRACK_PEAK
replaygain_track_gain 1 ReplayGain track gain: {ratio: number, dB: number} TXXX:REPLAYGAIN_TRACK_GAIN TXXX:REPLAYGAIN_TRACK_GAIN ----:COM.APPLE.ITUNES:REPLAYGAIN_TRACK_GAIN REPLAYGAIN_TRACK_GAIN REPLAYGAIN_TRACK_GAIN
replaygain_album_peak 1 ReplayGain album peak: {ratio: number, dB: number} TXXX:REPLAYGAIN_ALBUM_PEAK TXXX:REPLAYGAIN_ALBUM_PEAK ----:COM.APPLE.ITUNES:REPLAYGAIN_ALBUM_PEAK REPLAYGAIN_ALBUM_PEAK
replaygain_album_gain 1 ReplayGain album gain: {ratio: number, dB: number} TXXX:REPLAYGAIN_ALBUM_GAIN TXXX:REPLAYGAIN_ALBUM_GAIN ----:COM.APPLE.ITUNES:REPLAYGAIN_ALBUM_GAIN REPLAYGAIN_ALBUM_GAIN
replaygain_track_minmax 1 Minimum & maximum global gain values for this file. TXXX:MP3GAIN_MINMAX TXXX:MP3GAIN_MINMAX ----:COM.APPLE.ITUNES:REPLAYGAIN_TRACK_MINMAX REPLAYGAIN_MINMAX MP3GAIN_MINMAX
replaygain_album_minmax 1 Minimum & maximum global gain values across a set of files scanned as an album. TXXX:MP3GAIN_ALBUM_MINMAX TXXX:MP3GAIN_ALBUM_MINMAX ----:COM.APPLE.ITUNES:REPLAYGAIN_ALBUM_MINMAX REPLAYGAIN_ALBUM_MINMAX
replaygain_undo 1 The global gain adjustment to restore the original values in the left and right channels, respectively, followed by an indicator of whether to wrap TXXX:MP3GAIN_UNDO TXXX:MP3GAIN_UNDO ----:COM.APPLE.ITUNES:REPLAYGAIN_UNDO REPLAYGAIN_UNDO MP3GAIN_UNDO
description * Description TDES TDES DESC
longDescription 1 Long description or synopsis LDES
category * Podcast Category TCAT TCAT CATG
hdVideo 1 iTunes Video Quality (2=Full HD, 1=HD, 0=SD) HDVD
keywords * Podcast Keywords TKWD TKWD KEYW
movement 1 Movement MVNM MVNM ©MVN
movementIndex 1 Movement Index/Total, e.g. {no: 1, of: 4} MVIN MVIN ©MVI
movementTotal 1 The total number of movements ©MVC
podcastId 1 Podcast Identifier TGID TGID EGID
showMovement 1 Show Movement SHWM
stik 1 iTunes Media Type (1=Normal, 2=Audiobook, 6=Music Video, 9=Movie, 10=TV Show, 11=Booklet, 14=Ringtone, https://github.com/sergiomb2/libmp4v2/wiki/iTunesMetadata#user-content-media-type-stik) STIK