#file: noinspection SpellCheckingInspection # Tag mapping adapted from https://picard-docs.musicbrainz.org/downloads/MusicBrainz_Picard_Tag_Map.html # # NOTE FOR USERS: # # This file can be used as a reference to understand how Navidrome maps the tags in your music files to its fields. # If you want to customize these mappings, please refer to https://www.navidrome.org/docs/usage/customtags/ # # # NOTE FOR DEVELOPERS: # # This file contains the mapping between the tags in your music files and the fields in Navidrome. # You can add new tags, change the aliases, or add new split characters to the existing tags. # The artists and roles keys are used to define how to split the tag values into multiple values. # The tags are divided into two categories: main and additional. # The main tags are handled directly by Navidrome, while the additional tags are available as fields for smart playlists. # # Applies to single valued ARTIST and ALBUMARTIST tags. Won't be applied if the tag is multivalued or the multivalued # versions are available (ARTISTS and ALBUMARTISTS) artists: split: [" / ", " feat. ", " feat ", " ft. ", " ft ", "; "] # Applies to all remaining single-valued role tags (composer, lyricist, arranger...) roles: split: ["/", ";"] # These tags are handled directly by Navidrome. You can add/remove/reorder aliases, but changing the tag name # may require code changes main: title: aliases: [ tit2, title, ©nam, inam ] titlesort: aliases: [ tsot, titlesort, sonm, wm/titlesortorder ] artist: aliases: [ tpe1, artist, ©art, author, iart ] artistsort: aliases: [ tsop, artistsort, artistsort, soar, wm/artistsortorder ] artists: aliases: [ txxx:artists, artists, ----:com.apple.itunes:artists, wm/artists ] artistssort: aliases: [ artistssort ] arranger: aliases: [ tipl:arranger, ipls:arranger, arranger ] composer: aliases: [ tcom, composer, ©wrt, wm/composer, imus, writer, txxx:writer, iwri, # If you need writer separated from composer, remove these tagss from the line above # and uncomment the two lines below ] #writer: # aliases: [ WRITER, TXXX:Writer, IWRI ] composersort: aliases: [ tsoc, txxx:composersort, composersort, soco, wm/composersortorder ] lyricist: aliases: [ text, lyricist, ----:com.apple.itunes:lyricist, wm/writer ] lyricistsort: aliases: [ lyricistsort ] conductor: aliases: [ tpe3, conductor, ----:com.apple.itunes:conductor, wm/conductor ] director: aliases: [ txxx:director, director, ©dir, wm/director ] djmixer: aliases: [ tipl:dj-mix, ipls:dj-mix, djmixer, ----:com.apple.itunes:djmixer, wm/djmixer ] mixer: aliases: [ tipl:mix, ipls:mix, mixer, ----:com.apple.itunes:mixer, wm/mixer ] engineer: aliases: [ tipl:engineer, ipls:engineer, engineer, ----:com.apple.itunes:engineer, wm/engineer, ieng ] producer: aliases: [ tipl:producer, ipls:producer, producer, ----:com.apple.itunes:producer, wm/producer, ipro ] remixer: aliases: [ tpe4, remixer, mixartist, ----:com.apple.itunes:remixer, wm/modifiedby ] albumartist: aliases: [ tpe2, albumartist, album artist, aart, wm/albumartist ] albumartistsort: aliases: [ tso2, txxx:albumartistsort, albumartistsort, soaa, wm/albumartistsortorder ] albumartists: aliases: [ txxx:album artists, albumartists ] albumartistssort: aliases: [ albumartistssort ] album: aliases: [ talb, album, ©alb, wm/albumtitle, iprd ] albumsort: aliases: [ tsoa, albumsort, soal, wm/albumsortorder ] albumversion: aliases: [albumversion, musicbrainz_albumcomment, musicbrainz album comment, version] album: true genre: aliases: [ tcon, genre, ©gen, wm/genre, ignr ] split: [ ";", "/", "," ] album: true mood: aliases: [ tmoo, mood, ----:com.apple.itunes:mood, wm/mood ] split: [ ";", "/", "," ] album: true compilation: aliases: [ tcmp, compilation, cpil, wm/iscompilation ] track: aliases: [ track, trck, tracknumber, trkn, wm/tracknumber, itrk ] tracktotal: aliases: [ tracktotal, totaltracks ] album: true disc: aliases: [ tpos, disc, discnumber, disk, wm/partofset ] disctotal: aliases: [ disctotal, totaldiscs ] album: true discsubtitle: aliases: [ tsst, discsubtitle, ----:com.apple.itunes:discsubtitle, setsubtitle, wm/setsubtitle ] bpm: aliases: [ tbpm, bpm, tmpo, wm/beatsperminute ] lyrics: aliases: [ uslt:description, lyrics, ©lyr, wm/lyrics ] maxLength: 32768 type: pair # ex: lyrics:eng, lyrics:xxx comment: aliases: [ comm:description, comment, ©cmt, description, icmt ] maxLength: 4096 originaldate: aliases: [ tdor, originaldate, ----:com.apple.itunes:originaldate, wm/originalreleasetime, tory, originalyear, ----:com.apple.itunes:originalyear, wm/originalreleaseyear ] type: date recordingdate: aliases: [ tdrc, date, recordingdate, icrd, record date ] type: date releasedate: aliases: [ tdrl, releasedate, ©day, wm/year, year ] type: date catalognumber: aliases: [ txxx:catalognumber, catalognumber, ----:com.apple.itunes:catalognumber, wm/catalogno ] musicbrainz_artistid: aliases: [ txxx:musicbrainz artist id, musicbrainz_artistid, musicbrainz artist id, ----:com.apple.itunes:musicbrainz artist id, musicbrainz/artist id ] type: uuid musicbrainz_recordingid: aliases: [ ufid:http://musicbrainz.org, musicbrainz_trackid, musicbrainz track id, ----:com.apple.itunes:musicbrainz track id, musicbrainz/track id ] type: uuid musicbrainz_trackid: aliases: [txxx:musicbrainz release track id, musicbrainz_releasetrackid, ----:com.apple.itunes:musicbrainz release track id, musicbrainz/release track id] type: uuid musicbrainz_albumartistid: aliases: [ txxx:musicbrainz album artist id, musicbrainz_albumartistid, musicbrainz album artist id, ----:com.apple.itunes:musicbrainz album artist id, musicbrainz/album artist id ] type: uuid musicbrainz_albumid: aliases: [ txxx:musicbrainz album id, musicbrainz_albumid, musicbrainz album id, ----:com.apple.itunes:musicbrainz album id, musicbrainz/album id ] type: uuid musicbrainz_releasegroupid: aliases: [ txxx:musicbrainz release group id, musicbrainz_releasegroupid, ----:com.apple.itunes:musicbrainz release group id, musicbrainz/release group id ] type: uuid musicbrainz_composerid: aliases: [ txxx:musicbrainz composer id, musicbrainz_composerid, musicbrainz_composer_id, ----:com.apple.itunes:musicbrainz composer id, musicbrainz/composer id ] type: uuid musicbrainz_lyricistid: aliases: [ txxx:musicbrainz lyricist id, musicbrainz_lyricistid, musicbrainz_lyricist_id, ----:com.apple.itunes:musicbrainz lyricist id, musicbrainz/lyricist id ] type: uuid musicbrainz_directorid: aliases: [ txxx:musicbrainz director id, musicbrainz_directorid, musicbrainz_director_id, ----:com.apple.itunes:musicbrainz director id, musicbrainz/director id ] type: uuid musicbrainz_producerid: aliases: [ txxx:musicbrainz producer id, musicbrainz_producerid, musicbrainz_producer_id, ----:com.apple.itunes:musicbrainz producer id, musicbrainz/producer id ] type: uuid musicbrainz_engineerid: aliases: [ txxx:musicbrainz engineer id, musicbrainz_engineerid, musicbrainz_engineer_id, ----:com.apple.itunes:musicbrainz engineer id, musicbrainz/engineer id ] type: uuid musicbrainz_mixerid: aliases: [ txxx:musicbrainz mixer id, musicbrainz_mixerid, musicbrainz_mixer_id, ----:com.apple.itunes:musicbrainz mixer id, musicbrainz/mixer id ] type: uuid musicbrainz_remixerid: aliases: [ txxx:musicbrainz remixer id, musicbrainz_remixerid, musicbrainz_remixer_id, ----:com.apple.itunes:musicbrainz remixer id, musicbrainz/remixer id ] type: uuid musicbrainz_djmixerid: aliases: [ txxx:musicbrainz djmixer id, musicbrainz_djmixerid, musicbrainz_djmixer_id, ----:com.apple.itunes:musicbrainz djmixer id, musicbrainz/djmixer id ] type: uuid musicbrainz_conductorid: aliases: [ txxx:musicbrainz conductor id, musicbrainz_conductorid, musicbrainz_conductor_id, ----:com.apple.itunes:musicbrainz conductor id, musicbrainz/conductor id ] type: uuid musicbrainz_arrangerid: aliases: [ txxx:musicbrainz arranger id, musicbrainz_arrangerid, musicbrainz_arranger_id, ----:com.apple.itunes:musicbrainz arranger id, musicbrainz/arranger id ] type: uuid releasetype: aliases: [ txxx:musicbrainz album type, releasetype, musicbrainz_albumtype, ----:com.apple.itunes:musicbrainz album type, musicbrainz/album type ] album: true split: [ "," ] replaygain_album_gain: aliases: [ txxx:replaygain_album_gain, replaygain_album_gain, ----:com.apple.itunes:replaygain_album_gain ] replaygain_album_peak: aliases: [ txxx:replaygain_album_peak, replaygain_album_peak, ----:com.apple.itunes:replaygain_album_peak ] replaygain_track_gain: aliases: [ txxx:replaygain_track_gain, replaygain_track_gain, ----:com.apple.itunes:replaygain_track_gain ] replaygain_track_peak: aliases: [ txxx:replaygain_track_peak, replaygain_track_peak, ----:com.apple.itunes:replaygain_track_peak ] r128_album_gain: aliases: [r128_album_gain] r128_track_gain: aliases: [r128_track_gain] performer: aliases: [performer] type: pair musicbrainz_performerid: aliases: [ txxx:musicbrainz performer id, musicbrainz_performerid, musicbrainz_performer_id, ----:com.apple.itunes:musicbrainz performer id, musicbrainz/performer id ] type: pair explicitstatus: aliases: [ itunesadvisory, rtng ] # Additional tags. You can add new tags without the need to modify the code. They will be available as fields # for smart playlists additional: asin: aliases: [ txxx:asin, asin, ----:com.apple.itunes:asin ] barcode: aliases: [ txxx:barcode, barcode, ----:com.apple.itunes:barcode, wm/barcode ] copyright: aliases: [ tcop, copyright, cprt, icop ] encodedby: aliases: [ tenc, encodedby, ©too, wm/encodedby, ienc ] encodersettings: aliases: [ tsse, encodersettings, ----:com.apple.itunes:encodersettings, wm/encodingsettings ] grouping: aliases: [ grp1, grouping, ©grp, wm/contentgroupdescription ] album: true key: aliases: [ tkey, key, ----:com.apple.itunes:initialkey, wm/initialkey ] isrc: aliases: [ tsrc, isrc, ----:com.apple.itunes:isrc, wm/isrc ] language: aliases: [ tlan, language, ----:com.apple.itunes:language, wm/language, ilng ] license: aliases: [ wcop, txxx:license, license, ----:com.apple.itunes:license ] media: aliases: [ tmed, media, ----:com.apple.itunes:media, wm/media, imed ] album: true movementname: aliases: [ mvnm, movementname, ©mvn ] movementtotal: aliases: [ movementtotal, mvc ] movement: aliases: [ mvin, movement, mvi ] recordlabel: aliases: [ tpub, label, publisher, ----:com.apple.itunes:label, wm/publisher, organization ] album: true musicbrainz_discid: aliases: [ txxx:musicbrainz disc id, musicbrainz_discid, musicbrainz disc id, ----:com.apple.itunes:musicbrainz disc id, musicbrainz/disc id ] type: uuid musicbrainz_workid: aliases: [ txxx:musicbrainz work id, musicbrainz_workid, musicbrainz work id, ----:com.apple.itunes:musicbrainz work id, musicbrainz/work id ] type: uuid releasecountry: aliases: [ txxx:musicbrainz album release country, releasecountry, ----:com.apple.itunes:musicbrainz album release country, musicbrainz/album release country, icnt ] album: true releasestatus: aliases: [ txxx:musicbrainz album status, releasestatus, musicbrainz_albumstatus, ----:com.apple.itunes:musicbrainz album status, musicbrainz/album status ] album: true script: aliases: [ txxx:script, script, ----:com.apple.itunes:script, wm/script ] subtitle: aliases: [ tit3, subtitle, ----:com.apple.itunes:subtitle, wm/subtitle ] website: aliases: [ woar, website, weblink, wm/authorurl ] work: aliases: [ txxx:work, tit1, work, ©wrk, wm/work ]