NAME

     disco-import - import and update DiscoDOS releases and tracks

SYNOPSIS

     disco import [--help] [--add-to-collection | --tracks | --brainz] [--resume] [RELEASE_ID]

DESCRIPTION

     the import command imports your whole Discogs collection or just single releases and tracks.
     It is also used to get extended track information from Discogs, MusicBrainz and
     AcousticBrainz (BPM, musical key, links to MusicBrainz releases and recordings, links to
     AcousticBrainz recordings).

ARGUMENTS

     [RELEASE_ID]
             the Discogs release ID you want to import to DiscoBASE. If left empty, the whole
             collection will be imported. If the additional option
     -a is used, the release will be added to your Discogs collection _and_ imported to
     DiscoBASE. Note that a regular import of a given release ID is quite time consuming: We have
     to check wether or not this release ID is already in the Discogs collection (we don't want
     duplicates), thus we have to run through all of your releases via the Discogs API.
     Unfortunately Discogs does not allow us to search for release IDs in our collection, we only
     can "iterate" through them. Therefore the recommended way of adding newly gained releases is
     by using the -a option.

OPTIONS

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

     -a, --add-to-collection
             This is the recommended (and fastest) way of adding newly gained releases to your
             collection. The given release ID is added to your Discogs collection (same as when
             you click an "Add to collection" in the Discogs Webinterface. Additionally the
             release is added to the DiscoBASE. Note that for performance's sake, we don't do a
             time-consuming check if the release is already in your Discogs collection by asking
             the Discogs API, but only do a quick check if the ID is in the local DiscoBASE
             already.

     -u, --tracks
             extends the Discogs import (releases and also tracks will be downloaded) - takes
             siginficantly longer than the regular import. Note: This is the same as " disco
             search all -u ".

     -z, --brainz
             imports additional information from MusicBrainz/AcousticBrainz. This action takes a
             long time.  -z quick match, -zz detailed match (takes even longer, but more
             results). Notes: This is the same as " disco search all -z ". Prior to using this
             option, an extended Discogs import is recommended (disco import --tracks ).
             Otherwise only tracks that were already downloaded to the DiscoBASE (eg used in
             mixes and updated using " disco mix -u ") will be updated.

     --resume OFFSET
             resumes long-running processes at the given offset position (expects a number). You
             can combine this option currently with the *Brainz matching import operation 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!

SEE ALSO

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