matroska_tags.xml

<?xml version="1.0"?>
<matroska_tagging_registry version="2018-01-14">
  <classes>
    <class name="Nesting Information">
      <description lang="en">Nesting Information tags are intended to contain other tags.</description>
    </class>
    <class name="Organization Information"/>
    <class name="Titles"/>
    <class name="Nested Information">
      <description lang="en">Nested Information includes tags contained in other tags.</description>
    </class>
    <class name="Entities"/>
    <class name="Search and Classification"/>
    <class name="Temporal Information"/>
    <class name="Spatial Information"/>
    <class name="Personal"/>
    <class name="Technical Information"/>
    <class name="Identifiers"/>
    <class name="Commercial"/>
    <class name="Legal"/>
  </classes>
  <tags>
    <tag name="ORIGINAL" class="Nesting Information" type="nested">
      <description lang="en">A special tag that is meant to have other tags inside (using nested tags)
to describe the original work of art that this item is based on.
All tags can be used "under" the "ORIGINAL" tag like "LYRICIST", "LEAD_PERFORMER", etc.</description>
    </tag>
    <tag name="SAMPLE" class="Nesting Information" type="nested">
      <description lang="en">A tag that contains other tags to describe a sample used in the
targeted item taken from another work of art. All tags in this list can be used
"under" the "SAMPLE" tag like "TITLE", "ARTIST", "DATE_RELEASED", etc.</description>
    </tag>
    <tag name="COUNTRY" class="Nesting Information" type="UTF-8">
      <description lang="en">The name of the country
that is meant to have other tags inside (using nested tags) to country specific information about the item,
in the Matroska countries form, i.e. [@!RFC5646] two-letter region subtags, without the UK exception.
All tags can be used "under" the "COUNTRY" tag like "LABEL", "RATING", etc.
</description>
    </tag>
    <tag name="TOTAL_PARTS" class="Organization Information" type="UTF-8">
      <description lang="en">Total number of parts defined at the first lower level. (e.g., if `TargetType` is "ALBUM",
the total number of tracks of an audio CD).</description>
    </tag>
    <tag name="PART_NUMBER" class="Organization Information" type="UTF-8">
      <description lang="en">Number of the current part of the current level. (e.g., if `TargetType` is "TRACK",
the track number of an audio CD).</description>
    </tag>
    <tag name="PART_OFFSET" class="Organization Information" type="UTF-8">
      <description lang="en">A number to add to "PART_NUMBER", when the parts at that level don't start at 1
(e.g., if `TargetType` is "TRACK", the track number of the second audio CD).</description>
    </tag>
    <tag name="TITLE" class="Titles" type="UTF-8">
      <description lang="en">The title of this item. For example, for music you might label this "Canon in D",
or for video's audio track you might use "English 5.1" This is akin to the "TIT2" tag in [@!ID3v2.3].</description>
    </tag>
    <tag name="SUBTITLE" class="Titles" type="UTF-8">
      <description lang="en">Sub Title of the entity.</description>
    </tag>
    <tag name="URL" class="Nested Information" type="UTF-8">
      <description lang="en">URL corresponding to the tag it's included in.</description>
    </tag>
    <tag name="SORT_WITH" class="Nested Information" type="UTF-8">
      <description lang="en">A child `SimpleTag` element to indicate what alternative value the parent `SimpleTag` element can have
to be sorted -- for example, "Pet Shop Boys" instead of "The Pet Shop Boys".
Or "Marley Bob" and "Marley Robert Nesta" (no comma needed).</description>
    </tag>
    <tag name="INSTRUMENTS" class="Nested Information" type="UTF-8">
      <description lang="en">The instruments that are being used/played, separated by a comma.
It **SHOULD** be a child of the following tags: "ARTIST", "LEAD_PERFORMER", or "ACCOMPANIMENT".</description>
    </tag>
    <tag name="EMAIL" class="Nested Information" type="UTF-8">
      <description lang="en">Email corresponding to the tag it's included in.</description>
    </tag>
    <tag name="ADDRESS" class="Nested Information" type="UTF-8">
      <description lang="en">The physical address of the entity. The address **SHOULD** include a country code.
It can be useful for a recording label.</description>
    </tag>
    <tag name="FAX" class="Nested Information" type="UTF-8">
      <description lang="en">The fax number corresponding to the tag it's included in.
It can be useful for a recording label.</description>
    </tag>
    <tag name="PHONE" class="Nested Information" type="UTF-8">
      <description lang="en">The phone number corresponding to the tag it's included in.
It can be useful for a recording label.</description>
    </tag>
    <tag name="ARTIST" class="Entities" type="UTF-8">
      <description lang="en">A person or band/collective generally considered responsible for the work.
This is akin to the "TPE1" tag in [@!ID3v2.3].</description>
    </tag>
    <tag name="LEAD_PERFORMER" class="Entities" type="UTF-8">
      <description lang="en">Lead Performer/Soloist(s). This can sometimes be the same as ARTIST.</description>
    </tag>
    <tag name="ACCOMPANIMENT" class="Entities" type="UTF-8">
      <description lang="en">Band/orchestra/accompaniment/musician. This is akin to the "TPE2" tag in [@!ID3v2.3].</description>
    </tag>
    <tag name="COMPOSER" class="Entities" type="UTF-8">
      <description lang="en">The name of the composer of this item. This is akin to the "TCOM" tag in [@!ID3v2.3].</description>
    </tag>
    <tag name="ARRANGER" class="Entities" type="UTF-8">
      <description lang="en">The person who arranged the piece (e.g., Ravel).</description>
    </tag>
    <tag name="LYRICS" class="Entities" type="UTF-8">
      <description lang="en">The lyrics corresponding to a song (in case audio synchronization is not known
or as a doublon to a subtitle track). Editing this value, when subtitles are found, **SHOULD** also result
in editing the subtitle track for more consistency.</description>
    </tag>
    <tag name="LYRICIST" class="Entities" type="UTF-8">
      <description lang="en">The person who wrote the lyrics for a musical item. This is akin to the "TEXT" tag in [@!ID3v2.3].</description>
    </tag>
    <tag name="CONDUCTOR" class="Entities" type="UTF-8">
      <description lang="en">Conductor/performer refinement. This is akin to the "TPE3" tag in [@!ID3v2.3].</description>
    </tag>
    <tag name="DIRECTOR" class="Entities" type="UTF-8">
      <description lang="en">This is akin to the "IART" tag [@?RIFF.tags].</description>
    </tag>
    <tag name="ASSISTANT_DIRECTOR" class="Entities" type="UTF-8">
      <description lang="en">The name of the assistant director.</description>
    </tag>
    <tag name="DIRECTOR_OF_PHOTOGRAPHY" class="Entities" type="UTF-8">
      <description lang="en">The name of the director of photography, also known as cinematographer.
This is akin to the "ICNM" tag in [@?RIFF.tags].</description>
    </tag>
    <tag name="SOUND_ENGINEER" class="Entities" type="UTF-8">
      <description lang="en">The name of the sound engineer or sound recordist.</description>
    </tag>
    <tag name="ART_DIRECTOR" class="Entities" type="UTF-8">
      <description lang="en">The person who oversees the artists and craftspeople who build the sets.</description>
    </tag>
    <tag name="PRODUCTION_DESIGNER" class="Entities" type="UTF-8">
      <description lang="en">Artist responsible for designing the overall visual appearance of a movie.</description>
    </tag>
    <tag name="CHOREGRAPHER" class="Entities" type="UTF-8">
      <description lang="en">The name of the choregrapher</description>
    </tag>
    <tag name="COSTUME_DESIGNER" class="Entities" type="UTF-8">
      <description lang="en">The name of the costume designer</description>
    </tag>
    <tag name="ACTOR" class="Entities" type="UTF-8">
      <description lang="en">An actor or actress playing a role in this movie. This is the person's real name,
not the character's name the person is playing.</description>
    </tag>
    <tag name="CHARACTER" class="Entities" type="UTF-8">
      <description lang="en">The name of the character an actor or actress plays in this movie.
This **SHOULD** be a sub-tag of an `ACTOR` tag in order to not cause ambiguities.</description>
    </tag>
    <tag name="WRITTEN_BY" class="Entities" type="UTF-8">
      <description lang="en">The author of the story or script (used for movies and TV shows).</description>
    </tag>
    <tag name="SCREENPLAY_BY" class="Entities" type="UTF-8">
      <description lang="en">The author of the screenplay or scenario (used for movies and TV shows).</description>
    </tag>
    <tag name="EDITED_BY" class="Entities" type="UTF-8">
      <description lang="en">This is akin to the "IEDT" tag in [@?RIFF.tags].</description>
    </tag>
    <tag name="PRODUCER" class="Entities" type="UTF-8">
      <description lang="en">Produced by. This is akin to the "IPRO" tag in [@?RIFF.tags].</description>
    </tag>
    <tag name="COPRODUCER" class="Entities" type="UTF-8">
      <description lang="en">The name of a co-producer.</description>
    </tag>
    <tag name="EXECUTIVE_PRODUCER" class="Entities" type="UTF-8">
      <description lang="en">The name of an executive producer.</description>
    </tag>
    <tag name="DISTRIBUTED_BY" class="Entities" type="UTF-8">
      <description lang="en">This is akin to the "IDST" tag in [@?RIFF.tags].</description>
    </tag>
    <tag name="MASTERED_BY" class="Entities" type="UTF-8">
      <description lang="en">The engineer who mastered the content for a physical medium or
for digital distribution.</description>
    </tag>
    <tag name="ENCODED_BY" class="Entities" type="UTF-8">
      <description lang="en">This is akin to the "TENC" tag in [@!ID3v2.3].</description>
    </tag>
    <tag name="MIXED_BY" class="Entities" type="UTF-8">
      <description lang="en">DJ mix by the artist specified</description>
    </tag>
    <tag name="REMIXED_BY" class="Entities" type="UTF-8">
      <description lang="en">Interpreted, remixed, or otherwise modified by. This is akin to
the "TPE4" tag in [@!ID3v2.3].</description>
    </tag>
    <tag name="PRODUCTION_STUDIO" class="Entities" type="UTF-8">
      <description lang="en">This is akin to the "ISTD" tag in [@?RIFF.tags].</description>
    </tag>
    <tag name="THANKS_TO" class="Entities" type="UTF-8">
      <description lang="en">A very general tag for everyone else that wants to be listed.</description>
    </tag>
    <tag name="PUBLISHER" class="Entities" type="UTF-8">
      <description lang="en">This is akin to the "TPUB" tag in [@!ID3v2.3].</description>
    </tag>
    <tag name="LABEL" class="Entities" type="UTF-8">
      <description lang="en">The record label or imprint on the disc.</description>
    </tag>
    <tag name="GENRE" class="Search and Classification" type="UTF-8">
      <description lang="en">The main genre (classical, ambient-house, synthpop, sci-fi, drama, etc.).
The format follows the infamous "TCON" tag in [@!ID3v2.3].</description>
    </tag>
    <tag name="MOOD" class="Search and Classification" type="UTF-8">
      <description lang="en">Intended to reflect the mood of the item with a few keywords (e.g., "Romantic",
"Sad" or "Uplifting"). The format follows that of the "TMOO" tag in [@!ID3v2.4].</description>
    </tag>
    <tag name="ORIGINAL_MEDIA_TYPE" class="Search and Classification" type="UTF-8">
      <description lang="en">Describes the original type of the media, such as, "DVD", "CD", "computer image,"
"drawing," "lithograph," and so forth. This is akin to the "TMED" tag in [@!ID3v2.3].</description>
    </tag>
    <tag name="CONTENT_TYPE" class="Search and Classification" type="UTF-8">
      <description lang="en">The type of the item (e.g., Documentary, Feature Film, Cartoon, Music Video, Music, Sound FX).</description>
    </tag>
    <tag name="SUBJECT" class="Search and Classification" type="UTF-8">
      <description lang="en">Describes the topic of the file, such as "Aerial view of Seattle."</description>
    </tag>
    <tag name="DESCRIPTION" class="Search and Classification" type="UTF-8">
      <description lang="en">A short description of the content, such as "Two birds flying."</description>
    </tag>
    <tag name="KEYWORDS" class="Search and Classification" type="UTF-8">
      <description lang="en">Keywords to the item separated by a comma, used for searching.</description>
    </tag>
    <tag name="SUMMARY" class="Search and Classification" type="UTF-8">
      <description lang="en">A plot outline or a summary of the story.</description>
    </tag>
    <tag name="SYNOPSIS" class="Search and Classification" type="UTF-8">
      <description lang="en">A description of the story line of the item.</description>
    </tag>
    <tag name="INITIAL_KEY" class="Search and Classification" type="UTF-8">
      <description lang="en">The initial key that a musical track starts in. The format is identical to "TKEY" tag in [@!ID3v2.3].</description>
    </tag>
    <tag name="PERIOD" class="Search and Classification" type="UTF-8">
      <description lang="en">Describes the period that the piece is from or about. For example, "Renaissance".</description>
    </tag>
    <tag name="LAW_RATING" class="Search and Classification" type="UTF-8">
      <description lang="en">Depending on the "COUNTRY" it's the format of the rating of a movie (P, R, X in the USA,
an age in other countries or a URI defining a logo).</description>
    </tag>
    <tag name="DATE_RELEASED" class="Temporal Information" type="UTF-8">
      <description lang="en">The time that the item was originally released. This is akin to the "TDRL" tag in [@!ID3v2.4].</description>
    </tag>
    <tag name="DATE_RECORDED" class="Temporal Information" type="UTF-8">
      <description lang="en">The time that the recording began. This is akin to the "TDRC" tag in [@!ID3v2.4].</description>
    </tag>
    <tag name="DATE_ENCODED" class="Temporal Information" type="UTF-8">
      <description lang="en">The time that the encoding of this item was completed began. This is akin to the "TDEN" tag in [@!ID3v2.4].</description>
    </tag>
    <tag name="DATE_TAGGED" class="Temporal Information" type="UTF-8">
      <description lang="en">The time that the tags were done for this item. This is akin to the "TDTG" tag in [@!ID3v2.4].</description>
    </tag>
    <tag name="DATE_DIGITIZED" class="Temporal Information" type="UTF-8">
      <description lang="en">The time that the item was transferred to a digital medium. This is akin to the "IDIT" tag in [@?RIFF.tags].</description>
    </tag>
    <tag name="DATE_WRITTEN" class="Temporal Information" type="UTF-8">
      <description lang="en">The time that the writing of the music/script began.</description>
    </tag>
    <tag name="DATE_PURCHASED" class="Temporal Information" type="UTF-8">
      <description lang="en">Information on when the file was purchased; see also (#commercial) on purchase tags.</description>
    </tag>
    <tag name="DATE_STARTED" class="Temporal Information" type="UTF-8">
      <description lang="en">When the information of the parent `SimpleTag` element starts being valid.
      The information of the parent `SimpleTag` element is only valid between this date and the "DATE_ENDED" date of the same level.
      The "DATE_ENDED" is **OPTIONAL**. If empty or omitted the end date is unknown.</description>
    </tag>
    <tag name="DATE_ENDED" class="Temporal Information" type="UTF-8">
      <description lang="en">When the information is not valid anymore.
      The information of the parent `SimpleTag` element is only valid between the "DATE_STARTED" date of the same level and this date.
      The "DATE_STARTED" is **OPTIONAL**. If empty or omitted the start date is unknown.</description>
    </tag>
    <tag name="RECORDING_LOCATION" class="Spatial Information" type="UTF-8">
      <description lang="en">The location where the item was recorded,
in the Matroska countries form, i.e. [@!RFC5646] two-letter region subtags, without the UK exception.
This code is followed by a comma, then more detailed information such as state/province, another comma, and then city. For example,
"US, Texas, Austin". This will allow for easy sorting. It is okay to only store the country, or the country and the state/province.
More detailed information can be added after the city through the use of additional commas. In cases where the province/state
is unknown, but you want to store the city, simply leave a space between the two commas. For example, "US, , Austin".</description>
    </tag>
    <tag name="COMPOSITION_LOCATION" class="Spatial Information" type="UTF-8">
      <description lang="en">Location that the item was originally designed/written,
in the Matroska countries form, i.e. [@!RFC5646] two-letter region subtags, without the UK exception.
This code is followed by a comma, then more detailed information such as state/province, another comma, and then city.
For example, "US, Texas, Austin". This will allow for easy sorting. It is okay to only store the country, or the country and the state/province.
More detailed information can be added after the city through the use of additional commas. In cases where the province/state is unknown,
but you want to store the city, simply leave a space between the two commas. For example, "US, , Austin".</description>
    </tag>
    <tag name="COMPOSER_NATIONALITY" class="Spatial Information" type="UTF-8">
      <description lang="en">Nationality of the main composer of the item, mostly for classical music,
in the Matroska countries form, i.e. [@!RFC5646] two-letter region subtags, without the UK exception.</description>
    </tag>
    <tag name="COMMENT" class="Personal" type="UTF-8">
      <description lang="en">Any comment related to the content.</description>
    </tag>
    <tag name="PLAY_COUNTER" class="Personal" type="UTF-8">
      <description lang="en">The number of time the item has been played.</description>
    </tag>
    <tag name="RATING" class="Personal" type="UTF-8">
      <description lang="en">A numeric value defining how much a person likes the song/movie. The number is between
0 and 5 with decimal values possible (e.g., 2.7), 5(.0) being the highest possible rating.
Other rating systems with different ranges will have to be scaled.</description>
    </tag>
    <tag name="ENCODER" class="Technical Information" type="UTF-8">
      <description lang="en">The software or hardware used to encode this item. ("LAME" or "XviD")</description>
    </tag>
    <tag name="ENCODER_SETTINGS" class="Technical Information" type="UTF-8">
      <description lang="en">A list of the settings used for encoding this item. No specific format.</description>
    </tag>
    <tag name="BPS" class="Technical Information" type="UTF-8">
      <description lang="en">The average bits per second of the specified item. This is only the data in the `Block(s)`,
and excludes headers and any container overhead.</description>
    </tag>
    <tag name="FPS" class="Technical Information" type="UTF-8">
      <description lang="en">The average frames per second of the specified item. This is typically the average
number of Blocks per second. In the event that lacing is used, each laced chunk is to be counted as a separate frame.</description>
    </tag>
    <tag name="BPM" class="Technical Information" type="UTF-8">
      <description lang="en">Average number of beats per minute in the complete target (e.g., a chapter). Usually a decimal number.</description>
    </tag>
    <tag name="MEASURE" class="Technical Information" type="UTF-8">
      <description lang="en">In music, a measure is a unit of time in Western music like "4/4". It represents
a regular grouping of beats, a meter, as indicated in musical notation by the time signature.
The majority of the contemporary rock and pop music you hear on the radio these days is written in the 4/4 time signature.</description>
    </tag>
    <tag name="TUNING" class="Technical Information" type="UTF-8">
      <description lang="en">It is saved as a frequency in hertz to allow near-perfect tuning of instruments to
the same tone as the musical piece (e.g., "441.34" in Hertz).</description>
    </tag>
    <tag name="REPLAYGAIN_GAIN" class="Technical Information" type="UTF-8">
      <description lang="en">The gain to apply to reach 89dB SPL on playback. The value is computed according to the [@!ReplayGain] standard.
      The value in decibels (dB) is stored as a string (e.g., "-0.42 dB"). The decibel unit is **OPTIONAL**.
      Note that ReplayGain information can be found at all `TargetType` levels (track, album, etc).</description>
    </tag>
    <tag name="REPLAYGAIN_PEAK" class="Technical Information" type="UTF-8">
      <description lang="en">The maximum absolute peak amplitude of the item. The value is computed according to the [@!ReplayGain] standard.
      The value is a normalized absolute sample value of the target audio stored as a string without spaces (e.g., "1.0129").
      Note that ReplayGain information can be found at all `TargetType` levels (track, album, etc).</description>
    </tag>
    <tag name="ISRC" class="Identifiers" type="UTF-8">
      <description lang="en">The International Standard Recording Code [@!ISRC],
excluding the "ISRC" prefix and including hyphens.</description>
    </tag>
    <tag name="MCDI" class="Identifiers" type="binary">
      <description lang="en">This is a binary dump of the TOC of the CDROM that this item was taken from.
This holds the same information as the "MCDI" in [@!ID3v2.3].</description>
    </tag>
    <tag name="ISBN" class="Identifiers" type="UTF-8">
      <description lang="en">International Standard Book Number [@!ISBN].</description>
    </tag>
    <tag name="BARCODE" class="Identifiers" type="UTF-8">
      <description lang="en">European Article Numbering EAN-13 barcode defined in [@!GS1] General Specifications.</description>
    </tag>
    <tag name="CATALOG_NUMBER" class="Identifiers" type="UTF-8">
      <description lang="en">A label-specific string used to identify the release -- for example, TIC 01.</description>
    </tag>
    <tag name="LABEL_CODE" class="Identifiers" type="UTF-8">
      <description lang="en">A 4-digit or 5-digit number to identify the record label, typically printed as (LC) xxxx or (LC)
0xxxx on CDs medias or covers (only the number is stored).</description>
    </tag>
    <tag name="LCCN" class="Identifiers" type="UTF-8">
      <description lang="en">Library of Congress Control Number [@!LCCN].</description>
    </tag>
    <tag name="IMDB" class="Identifiers" type="UTF-8">
      <description lang="en">Internet Movie Database [@!IMDb] title identifier. "tt" followed by at least 7 digits for Movies, TV Shows, and Episodes.</description>
    </tag>
    <tag name="TMDB" class="Identifiers" type="UTF-8">
      <description lang="en">The Movie DB "movie_id" or "tv_id" identifier for movies/TV shows [@!MovieDB]. The variable length digits string **MUST** be prefixed with either "movie/" or "tv/".</description>
    </tag>
    <tag name="TVDB" class="Identifiers" type="UTF-8">
      <description lang="en">The TV Database "Series ID" or "Episode ID" identifier for TV shows [@!TheTVDB]. Variable length all-digits string identifying a TV Show to use with the "series/{id}" API.</description>
    </tag>
    <tag name="TVDB2" class="Identifiers" type="UTF-8">
      <description lang="en">The TV Database [@!TheTVDB] tag which can include movies. The variable length digits string representing a "Series ID", "Episode ID" or "Movie ID" identifier **MUST** be prefixed with "series/", "episodes/", or "movies/", respectively.</description>
    </tag>
    <tag name="PURCHASE_ITEM" class="Commercial" type="UTF-8">
      <description lang="en">URL to purchase this file. This is akin to the "WPAY" tag in [@!ID3v2.3].</description>
    </tag>
    <tag name="PURCHASE_INFO" class="Commercial" type="UTF-8">
      <description lang="en">Information on where to purchase this album. This is akin to the "WCOM" tag in [@!ID3v2.3].</description>
    </tag>
    <tag name="PURCHASE_OWNER" class="Commercial" type="UTF-8">
      <description lang="en">Information on the person who purchased the file. This is akin to the "TOWN" tag in [@!ID3v2.3].</description>
    </tag>
    <tag name="PURCHASE_PRICE" class="Commercial" type="UTF-8">
      <description lang="en">The amount paid for entity. There **SHOULD** only be a numeric value in here. Only numbers,
no letters or symbols other than ".". For instance, you would store "15.59" instead of "$15.59USD".</description>
    </tag>
    <tag name="PURCHASE_CURRENCY" class="Commercial" type="UTF-8">
      <description lang="en">The currency type used to pay for the entity. Use [@!ISO4217] for the 3 letter alphabetic code.</description>
    </tag>
    <tag name="COPYRIGHT" class="Legal" type="UTF-8">
      <description lang="en">The copyright information as per the copyright holder. This is akin to the "TCOP" tag in [@!ID3v2.3].</description>
    </tag>
    <tag name="PRODUCTION_COPYRIGHT" class="Legal" type="UTF-8">
      <description lang="en">The copyright information as per the production copyright holder. This is akin to the "TPRO" tag in [@!ID3v2.4].</description>
    </tag>
    <tag name="LICENSE" class="Legal" type="UTF-8">
      <description lang="en">The license applied to the content (like Creative Commons variants).</description>
    </tag>
    <tag name="TERMS_OF_USE" class="Legal" type="UTF-8">
      <description lang="en">The terms of use for this item. This is akin to the "USER" tag in [@!ID3v2.3].</description>
    </tag>
  </tags>
</matroska_tagging_registry>