Ubuntu Manpage: disco-mix - manage your DiscoDOS mixes

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!