DISCO-IMPORT(1) | General Commands Manual | DISCO-IMPORT(1) |
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),
June 15, 2020 | DiscoDOS |