NAME

disco-search - search, edit and update DiscoDOS releases and tracks

SYNOPSIS

disco search [--help] [--mix | --discogs-update | --brainz-update | --edit] [--track] [--pos] [--resume] search_terms

DESCRIPTION

the search command searches for releases and tracks in the Discogs collection. Several actions can be executed on the found items, eg. adding to a mix, updating track info from Discogs or fetching additional information from MusicBrainz/AcousticBrainz or simply adding track information by hand (user-defined BPM/key, track notes, user-defined AcousticBrainz recording ID).

ARGUMENTS

search_terms: The collection is searched for these terms. When offline, it searches through all releases' artists/titles only (eg tracknames not considered). When online, the Discogs API search engine is used and also tracknames, artists, labels and catalog numbers are looked through. If your search term consists of multiple words, put them inside double quotes (eg. "foo bar term"). If you instead put a number as your search term, it is assumed you want to view exactly the Discogs release with the given ID. If search term is the special keyword "all", a list of all releases in the DiscoBASE is shown (including weblinks to Discogs/MusicBrainz release pages). In combination with -u, -z or -zz respectively, all tracks are updated. Note that this is exactely the same as " disco import " in combination with those options.

OPTIONS

-h, --help: show this help message and exit
-m MIX_NAME, --mix MIX_NAME: adds a track of the found release to the given mix ID (asks which track to add in case -t is missing).
-u, --discogs-update: updates found release/track with Discogs track/artist details (asks which track to update in case -t is missing).
-z, --brainz-update: updates found release/track with additional info from MusicBrainz and AcousticBrainz. (asks which track to update in case -t is missing) -z quick match, -zz detailed match (takes longer, but more results).
-e, --edit: edits/adds details to a found release/track. Editable fields: key, BPM, key notes, general track notes, custom MusicBrainz recording ID. (asks which track to edit in case -t is missing).
-t TRACK_NUMBER, --track TRACK_NUMBER: in combination with -m this option adds the given track number (eg. A1, AA, B2, ...) to the mix selected using .Fl m ; in combination with -z or -u the given track is the one being updated with *Brainz or Discogs details; in combination with -e the given track is to one to be edited.
-p POS_IN_MIX, --pos POS_IN_MIX: in combination with -m this option states that we'd like to insert the track at the given position (eg. 1, 14, ...), rather than at the end of the mix; in combination with -z, -zz, -u or -e this option is ignored.
--resume OFFSET: resumes long-running processes at the given offset position (expects a number). You can combine this option currently with *Brainz matching operations only ( -z, -zz )

EXAMPLES

Step by step tutorials and in-detail explanations of all DiscoDOS commands can be found on the README and User's Manual pages: https://github.com/JOJ0/discodos/blob/master/README.md https://github.com/JOJ0/discodos/blob/master/MANUAL.md

AUTHORS

J0J0 T <jt@peek-a-boo.at>

Special thanks go to Samplissimo for testing and feature ideas, to Schobernoise for motivation and a GUI draft and most of all to Gold Fisch for her patience while Doogie Howser wrote in his diary!