User:LordSputnik/Unified Metadata Format

From MusicBrainz Wiki

Unified Metadata Format is a proposed structure for storing data within and exchanging data between metadata applications. It is based on the JSON format.

Key Features

  • JSON-based - supports key-value pairs, nesting and lists.
  • A standard set of key names which can be mapped to both MusicBrainz webservice data and tags in common metadata formats.
  • Non-standard names are stored in common metadata formats in a block, so they aren't lost on conversion and can be read back into UMF if needed.
  • Everything is an entity or a basic value (string, integer, date, etc.) - entities always have mappings to MusicBrainz IDs, and sometimes other IDs too.

Basic Conceptual Types

A sequence of unicode characters.
A whole number.
A number which may have a decimal point.
A combination of a date and a time.
Just a time, with no particular point of reference.
A piece of binary data.

Entity Properties

specifies a MusicBrainz MBID related to the entity.
specifies an Amazon ASIN related to the entity.

Release Properties

Key Description Standard Type ID3 Mapping
title The title of the release string TALB
artist The artists credited on the release string TPE2

Recording Properties

Key Description ID3 Mapping
title The title of the recording string TIT2
artist The artists featured on the recording string TPE1

Track Properties

Key Description ID3 Mapping
title The title of the track, usually as given on the release string TIT2
artist The artists performing on the track, as credited on the release string TPE1
id The number or text used to identify the track. Commonly referred to as the track number. string TPE2
position The position of the track within the medium. integer TRCK
medium The number of the medium that the track comes from. integer TPOS


       "release": {
           "title":"Vol. 3: (The Subliminal Verses)",
                           "recording": {