Difference between revisions of "Development/Release Editor Seeding"

From MusicBrainz Wiki
(Tracklists and Mediums: fix variable)
(Tracklists and Mediums)
Line 67: Line 67:
 
; mediums.''n''.track.''m''.name
 
; mediums.''n''.track.''m''.name
 
: The name of track ''m'' on medium ''n''
 
: The name of track ''m'' on medium ''n''
 +
 +
; mediums.''n''.track.''m''.number
 +
: The free-form track number of track ''m'' on medium ''n''
  
 
; mediums.''n''.track.''m''.artist_credit.names.''x''.mbid  
 
; mediums.''n''.track.''m''.artist_credit.names.''x''.mbid  

Revision as of 11:20, 7 June 2012

This page documents a list of parameters you can POST to the release editor to "seed" it. All values are optional unless otherwise stated.

To create a new release: http://musicbrainz.org/release/add

Release data

name
The name of the release. Non-empty string. Required
comment
A disambiguation comment for the release. Non-empty string
annotation
Text to place in the releases annotation
barcode
The barcode of the release. May be any valid barcode without whitespace
date.year
date.month
date.day
The date of the release. Each field is an integer
country
The country the release was released in. May be any valid country ISO code (for example, GB, US, FR)
language
The language of the release. May be any valid ISO 639-2/T code (for example, eng, deu, jpn)
script
The script of the text on the release. May be any valid ISO 15924 code (for example, Latn, Cyrl)
status
The status of the release, as defined by MusicBrainz. Possible values: official, promotion, bootleg, pseudo
type
The type of the release group, if a release group will be created. Possible values: album, single, ep, compilation, soundtrack, spokenword, interview, audiobook, live, remix, other
packaging
The type of packaging of the release. Possible values: jewel-case, slim-jewel-case, digipak, paper-sleeve, other

Labels and catalog numbers

Releases may be associated with multiple labels and catalog numbers, so the fields for specifying these is a little different. You must specify a positive integer for the n part of the field name to specify which label/catalog number pair you are referring to. For example: label.0.mbid and label.0.catalog_number

labels.n.mbid
The MBID of the label.
labels.n.catalog_number
The catalog number of this release, for label n.
labels.n.name
The name of the label. If an MBID is present, this value is ignored.

Artist credit

A release may be credited to multiple artists via what is known as an "artist credit." To specify the artists a release is credited, you can use the following fields:

artist_credit.names.n.mbid
The MBID of the artist. If omitted you will be able to either create the artist in the RE, or search MusicBrainz for this artist.
artist_credit.names.n.name
The name of the artist, as credited on the release. Optional, if omitted it will default to the artist's current name
artist_credit.names.n.artist.name
The name of the artist as it is usually referred too.
artist_credit.names.n.join_phrase
An optional phrase to join this artist with the next artist. For example, you could use " & " to join "Calvin" with "Hobbes" to get the final text "Calvin & Hobbes"

Tracklists and Mediums

As with labels above, their may be multiple mediums and tracklists may contain multiple tracks, so again you will need to fill in the n and m parameters accordingly. As with others, n and m are 0-indexed. Values for n must be in consecutive order starting with 0; with at least 1 track for each medium.

mediums.n.format
Any valid medium format name: may be any one of auto generate me
mediums.n.position
The position of this medium in the list of mediums. If omitted, it will be inferred from the order of all mediums passed in (which is normally what you want).
mediums.n.name
The name of medium n (for example "Live & Unreleased")
mediums.n.track.m.name
The name of track m on medium n
mediums.n.track.m.number
The free-form track number of track m on medium n
mediums.n.track.m.artist_credit.names.x.mbid
mediums.n.track.m.artist_credit.names.x.name
mediums.n.track.m.artist_credit.names.x.artist.name
mediums.n.track.m.artist_credit.names.x.join_phrase
As like the release artist credit, these parameters allow you to specify the artist credit for a track. Defaults to the release artist credit.
mediums.n.track.m.length
The tracks duration, in MM:SS form or a single integer as milliseconds

Other data

edit_note
Specify the contents of an edit note