Application icon

Search Discogs

The action performs a Discogs search equivalent to the search performed by the Discogs wizard.

All text fields may contain any of the escape sequences described in Escape Sequences.

You can search using album and artist metadata or by barcode.

When searching by barcode the barcode field must not resolve to be empty. At runtime all characters which are not decimal digits are removed before searching.

When not searching by barcode you must specify at least one of the album or artist fields. While searching Discogs it is possible to explicitly constrain a pattern to a particular database field. This can be forced in the via the Explicit checkboxes. It has been found that non explicit searches are far more forgiving as to how data is specified. While Yate contains numerous workarounds for the explicit data representations there are likely more exceptions which have not been accounted for. Performing a search without any explicit components more closely matches the results found when searching on discogs.com. It is possible that explicit searches can return a smaller more meaningful set of results.

You can choose to return the results in a named variable or in a container.

The search results are returned in a named variable as a list of matches which are separated by the List Secondary Delimiter \: (●). Each match is stored as a key-value list. The key-value list is constructed such that items are separated by the default list delimiter \~ (⏎). Keys are separated by values with the list key-value delimiter \k (≔).

When the results are returned in a container, the container is an array where each element is an object.

The following keys may be present: Album, Artist, Catalog number, Country, Genre, Label, Master id, Media, Mood, Release id and Year.

Any item which has more than one value will separate the values with the multi-value delimiter \m.

As in the Discogs Wizard you can specify the maximum number of results to return. You can override this at runtime by setting named variable Search Discogs/MusicBrainz Limit to the number you'd prefer. The number is adjusted to be one of 25, 50, 75 or 100. If the named variable is empty, the specified value will be used. Note that the named variable is also used by the Search MusicBrainz statement.

If a network error occurred, the Data Source Access Error will describe the error.

These types of requests are rate limited and can pause an action if multiple requests are made. While running, one or more status messages may be displayed in the main window's status bar. If the Status Bar Message Suffix named variable is not empty, it's contents will be appended to the displayed message. This can be used to display a means of soft cancelling a repeated sequence. For example you can test if a modifier key is pressed.