Development/Seeding/Release Editor: Difference between revisions
Ianmcorvidae (talk | contribs) (MBS-4734 is marked as fixed, removing warning) |
No edit summary |
||
Line 28: | Line 28: | ||
: 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 (this can be specified multiple times to select multiple secondary types, though only one primary type should be specified). |
: 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 (this can be specified multiple times to select multiple secondary types, though only one primary type should be specified). |
||
; packaging |
; packaging |
||
: The type of packaging of the release. Possible values: jewel |
: The type of packaging of the release. Possible values: 'jewel case', 'slim jewel case', 'digipak', 'cardboard/paper sleeve', 'other', 'keep case' |
||
=== Labels and catalog numbers === |
=== Labels and catalog numbers === |
Revision as of 21:14, 8 December 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 (this can be specified multiple times to select multiple secondary types, though only one primary type should be specified).
- packaging
- The type of packaging of the release. Possible values: 'jewel case', 'slim jewel case', 'digipak', 'cardboard/paper sleeve', 'other', 'keep case'
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