# Discogs Wizard Release Details

This step of the wizard displays the details for a single release.

Note that if all the files in the current selection already have a common Discogs id, the wizard will open immediately to this panel. If you want to look for a different release, you can click on the New Search button.

The table at the top of the window presents the type of data which can be imported from the release. The importing of each item type may be enabled or disabled by checking or clearing the Import column. Setting the Import value to - implies that the field should only be imported if the associated value in a file is not empty. ie. current non empty values will not be overwritten. The value associated with some items can be edited inline. Yate will retain an item type's enable/disable state until you change it again. Additional information as to how the import column is preset can be found in Discogs & MusicBrainz Import Settings.

Further import granularity is available on a per file basis by means of The Discogs Exclusion Window which is activated from the Actions menu.

The following items may be imported:

> Album
>   The name of the album.
> Album artist
>   The Album Artist name.
> Album artist URLS
>   URLs linking to the Discogs webpages referencing the album artist(s). These items are stored as UDURLs with names of DISCOGS_ALBUM_ARTIST_URL.
> Artist
>   The Artist names.
> Artist List
>   If the Discogs preference Combine multiple value items into a single value option is not set this data will be identical to the artist field. The field contains a list of artists separated by the multi-value delimiter. The information is stored as a User Defined Text Info item named DISCOGS_ARTIST_LIST. Storing this field is only meaningful if you combine multiple artists into a single artist but you still want to be able to iterate the artists.
> Artist Name Variations
>   This field stores a list associating artist names to Artist Name Variations (ANVs). Each element in the list has the format: artist name=anv. Successive elements in the list are separated by the multi value delimiter. The information is stored as a UDTI named Discogs Artist Names Variations. Note that the artist name is always the actual artist name from the data even if you have selected the Prefer Artist Name Variations (ANV) Discogs preference.
> Artist URLs
>   URLs linking to the Discogs webpages referencing artists. These items are UDURLs with names of DISCOGS_ARTIST_URL .
> Artwork
>   This item specifies whether artwork is to be imported. Any artwork item can be marked for import via the artwork display. The number of artwork items pre-marked for import is controlled by the Import all artwork option in Preferences - Discogs. The field displays the number of loaded items, items with errors, items to be loaded. It may also display the time at which the next artwork item can be loaded.
> Artwork URL
>   A URL to reference artwork for the release on the Discogs site. This item will be a UDURL named DISCOGS_ARTWORK_URL.
> Barcode
>   The barcode associated with the album. This item is stored as a UDTI with a name of Barcode.
> Catalog number
>   The catalog number. This value is placed in the Catalog field. It is the catalog number associated with the first label associated with the track.
> Catalog number (per label)
>   The per label catalog number(s). These items are UDTIs with names of Discogs Catalog Number. The value field will be label: catalog number
> Composer
>   The Composer's name.
> Conductor
>   The Conductor's name.
> Copyright
>   All instances of copyright and phonographic copyright found in the data.
> Country
>   The country where the album was released. This item is stored as a UDTI named Country. Note that this item will initially contain the same value as Release Country. The item is included as it writes the metadata to a UDTI read by Roon.
> Disc Numbers
>   The number of the disc which contains a track.
> Disc Count
>   The total number of discs.
> Genre
>   The genre(s).
> Import Settings
>   You can elect to save the current import settings within tracks so that the next time the wizard is run with the same release, the same set of import settings will be used. Additional information on track retained import settings can be found in Discogs & MusicBrainz Import Settings.
> Involved People
>   Yate will attempt to extract all non musician (vocal or instrument) credit information from the Discogs data. This information will be displayed in the Involved People field. Note that where there is a dedicated field for a credit it will be displayed in the field (eg. Composer, Conductor, Lyricist and Remixer). The determination as to where a credit belongs is based on our analysis of the documented list of Discogs credits. If you feel that a credit is being placed incorrectly, you can alter the behaviour in the Combined Credits Editor option.
> Label
>   This item controls the import of the name of the label.
> Label URLs
>   URLs to reference the Discogs webpages referencing labels. The URLs will be stored to UDURLs with names of DISCOGS_LABEL_URL.
> Lyricist
>   The Lyricist's name.
> Master Id
>   The identifier associated with a release's master release. It is stored as a UDTI named Discogs Master Id. The ID will be prefixed with an 'm' to ease the use of the ID in the wizard's search field.
> Master URL
>   The URL to a release's master release on the Discogs web site. It is stored as a UDURL with a name of DISCOGS_MASTER_URL.
> Media subtitles
>   This item controls the import of a media item's subtitle. The values, if present, will be written to a track's Set Subtitle field. The values are extracted when possible from Discogs Index Tracks and Headings.
> Media type
>   This item controls the import of the release's media type. If more than one media type is available, they will be written as multiple values to the media type field.
> Mood
>   This item controls the import of the Discogs style values. The values are stored to the mood field. If more than one mood is available, they will be written as multiple values to the mood field.
> Musician Credits
>   Yate will attempt to extract all musician (vocal or instrument) credit information from the Discogs data. This information will be displayed in the Musician Credits field. The determination as to where a credit belongs is based on our analysis of the documented list of Discogs credits. If you feel that a credit is being placed incorrectly, you can alter the behaviour in the Combined Credits Editor.
> Part of a compilation
>   This item controls the import of the part of a compilation value. The displayed field will contain a 1 if the release is part of a compilation, otherwise a 0.
> Publisher
>   The Publisher(s).
> Release country
>   The country where the album was released. This item is stored as a UDTI named Discogs Release Country. See Country for an alternate storage location processed by Roon.
> Release id
>   The Discogs release id. Stored as a UDTI named Discogs Release Id. This field must be present in order to map a track with the Access Discogs action function. When extracting metadata from a Discogs master release, this field will be prefixed with an m. This is done as a lot of the Discogs functionality looks at the Discogs Release Id and not the Discogs Master Id UDTI.
> Release Notes
>   The Discogs release notes. Stored as a UDTI named Discogs Release Notes.
> Release ordinal position
>   This is the relative position of a track in the Discogs track list. It has no purpose except to assist when mapping tracks via the Access Discogs action function. This information along with Track Position must be present or the Access Discogs action function will not map the track. The field is also used to assist in mapping files to tracks when the wizard is run subsequently after importing.
> Release URL
>   URL which references the Discogs webpage describing the release. Stored as a UDURL named DISCOGS_RELEASE_URL.
> Remixer
>   The name of the remixer.
> Titles
>   This item controls the import of track titles.
> Track Numbers
>   This item controls the import of track numbers.
> Track Count
>   The total number of tracks on a single disc.
> Track positon
>   The symbolic representation of a track's number as specified in the Discogs data. The information is stored as a UDTI named Track Number Text. This information along with Release ordinal position must be present or the Access Discogs action function will not map the track. The field is also used to assist in mapping files to tracks when the wizard is run subsequently after importing. This information can be displayed in the main list of files by displaying the Position column.
> Year
>   This item controls the import of the year of the album's release.

You can enable or disable the import all of the items at once by right clicking in the table and selecting the appropriate context menu item. You can also choose to import all items only if they are currently empty. Note that certain items may contain more than one value separated by the multi value delimiter.

If an item's field value contains the text URL, you can open the associated web page by selecting Open URL from the context menu or by double clicking on the item. The context menu also allows you to copy the contents of the Value field to the clipboard.

If the Master id item is selected, it has a value and it is different that the Release id value, you can open the master by selecting Open Master id from the context menu or by double clicking on the item.

Using the context menu you can save the current Import column settings. These settings can be restored from the saved set.

The table at the bottom of the window displays the title, track position, track number and disc number for each track in the release. You can edit all of the information inline. Discogs information is submitted by users and as such various formats may be used to represent the information. All attempts are made to properly determine the correct track and disc numbers.

You can use the splitter bar separating the two tables, to change the size of the tables.

Various functions are available to you via the bottom table's context menu.

Set Disc Break is used to identify the selected track as the start of a new disc.

Clear Disc Break is used to merge the disc of the currently selected track with the preceding track's disc. The function will only do something if the selected track is the first on a disc.

Renumber Within Discs will renumber the tracks from 1 within each disc.

Renumber Eliminating Discs will renumber the tracks from 1 setting all the disc numbers to 1.

Merge Tracks can be used to merge consecutive tracks into a single track. This is only necessary if Yate was not able to properly determine a Discogs index set and its associated sub-tracks.

Split item into Separate Tracks can be used to split an appropriate track into separate tracks. This is only necessary if Yate incorrectly accumulated tracks into an index set. Such items are typically identified by having a Title field with multiple titles separated by space/space sequences. Depending on how the index set was accumulated you may have to edit out the first title before performing the function.

You can also choose to display the values in the Time column as milliseconds or as minutes:seconds. The setting you choose is sticky.

If this release does not meet your requirements you can click on the Back to Release button and choose a different release from the list. Note that all editing changes will have been lost if you subsequently choose the same release.

If artwork is available for the release, the View Artwork button will be visible. This will take you to the artwork display where you can view and manually save the artwork.

If there are artwork related functions which can be performed, there will be a disclosure button to the immediate right of the Help button. When clicking on the disclosure button, the displayed menu may contain the following functions:

> Show Artwork at Discogs
>   If artwork is available, selecting this function will take you to the Discogs site where the artwork available for the release will be displayed. Images from the web site may be dragged into Yate's artwork panel or main file list.
> Load Unloaded Artwork
>   If not all artwork has been loaded due to your preferences, selecting this item will start loading the artwork. If artwork is currently being loaded, this item will display so.

If an Import to Cue Sheet button is displayed, you can import metadata directly to a cue sheet. More information can be found here.

If you are satisfied with the release and its associated data you can click on the Continue button. This will take you to the File mapping display.

Discogs

Searching

The result list

File mapping

The view changes display

The Discogs Import Settings Manager