Ubuntu Manpage: disco-search - search, edit and update DiscoDOS releases and tracks

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!