NAME

       disco-mix - manage your DiscoDOS mixes

SYNOPSIS

       disco                          mix                          [--help]                          [--verbose]
             [--create-m-i-xdelete-m-i-xed-i-tedit-m-i-xbulk-ed-i-tadd-to-m-i-xreorder-trac-k-sdelete-tra-c-kc-o-pdyiscogs-up-d-abtreainz-update]
             [--pos] [--resume] [mix_name]

DESCRIPTION

       the  mix  command  is  used  to manage your DiscoDOS mixes. A mix is basically just a list of tracks in a
       specific order, a playlist, a track pool, you name it.

ARGUMENTS

       [mix_name]
               mix name or mix ID being displayed, edited, created, copied, deleted, etc. If  mix_name  is  left
               out, a list of available mixes is shown and all other arguments are ignored.

OPTIONS

       -h, --help
               show this help message and exit

       -v, --verbose, --vv
               increases  mix  tracklist  view detail.  -v adds tracknames, artists, transition rating/notes and
               general track notes.  -vv shows when and how  MusicBrainz  matching  was  done  and  also  direct
               weblinks to Discogs releases, MusicBrainz releases/recordings and AccousticBrainz recordings.

       -c, --create-mix
               creates new mix (named as given in mix_name argument).

       -D, --delete-mix
               deletes the mix (given in mix_name) and all its contained tracks!

       -e POSITION, --edit POSITION
               edits/adds details of a track in a mix (editable fields: key, BPM, track number, position in mix,
               key notes, transition rating, transition notes, general track notes, custom MusicBrainz recording
               ID).

       -E, --edit-mix
               edits/adds general info about a mix (name, played date, venue).

       -b FIELDS, --bulk-edit FIELDS
               bulk-edits specific fields of each track in mix. Syntax of FIELDS argument: <field1>,<field2>,...
               available                fields:               key,bpm,track_no,track_pos,key_notes,trans_rating,
               trans_notes,notes,m_rec_id_override.

       -a SEARCH_TERMS, --add-to-mix SEARCH_TERMS
               searches for release/track in collection and adds it to  the  mix,  This  option  is  actually  a
               shortcut  to "disco search -m mix_name search_term" and behaves identically. If SEARCH_TERMS is a
               number, it is assumed being a Discogs release ID. A quick database check  is  done  and  if  non-
               existent  yet,  the  release  is 1) added to the Discogs collection and 2) imported to DiscoBASE.
               This is a convenience function eg when trying to quickly add a release to the mix that's  not  in
               the DiscoBASE yet (possibly an only recently gained record?).

       -r POSITION, --reorder-tracks POSITION
               reorders  tracks  in  current  mix,  starting  at  POSITION ; Note that this is a troubleshooting
               function and usually shouldn't be necessary to use.

       -d POSITION, --delete-track POSITION
               removes the track at the given position from the mix.

       --copy  copies the mix given in mix_name argument. Asks for new name!

       -u, --discogs-update
               updates tracks in current mix with additional info from Discogs. Can be combined with -p when mix
               ID provided or with --resume when mix ID not provided (all tracks in mixes update).

       -z, --brainz-update, --zz
               updates tracks in current mix with additional info from MusicBrainz and AcousticBrainz. Leave out
               mix ID to update every track contained in any mix.  -z quick match,  -zz  detailed  match  (takes
               longer, but more results). Can be combined with -p when mix ID provided or with --resume when mix
               ID not provided (all tracks in mixes *Brainz matching).

       -p POSITION, --pos POSITION
               in  combination with -a this option adds the found release/track at the given position in the mix
               (rather than at the end). In combination with -u, -z or -zz the update process is started at  the
               given position in the mix.

       --resume OFFSET
               resumes  long-running  processes at the given offset position (expects a number). You can combine
               this option currently with "all tracks in mixes Discogs update" (disco mix  -u  )  or  with  "all
               tracks in mixes *Brainz matching" (disco mix -z, disco mix -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!

SEE ALSO

       disco-search(1), disco-import(1), disco-suggest(1), disco(1) discosync(1),

DiscoDOS                                          June 15, 2020                                     DISCO-MIX(1)