DISCO-IMPORT(1)

🌸 NAME 🌸

disco-import — the one that imports and updates DiscoDOS releases and tracks, bestie 💖

---

🦋 SYNOPSIS 🦋

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

---

✨ DESCRIPTION ✨

okay so import is the command that pulls your whole Discogs collection in, or just single releases and tracks if that's all you need 🎀

it's also the plug for getting extended track information from Discogs, MusicBrainz and AcousticBrainz — we're talking BPM, musical key, links to MusicBrainz releases and recordings, and links to AcousticBrainz recordings 🌈

---

🎀 ARGUMENTS 🎀

• [RELEASE_ID] — the Discogs release ID you wanna import into DiscoBASE 🫶 leave it empty and the whole collection gets imported instead. and if you're also passing -a, the release gets added to your Discogs collection and imported to DiscoBASE, both, no cap.

lowkey important: a regular import of a given release ID is quite time consuming 😭 we have to check whether or not that release ID is already sitting in your Discogs collection (we are NOT doing duplicates, bestie), so we have to run through all of your releases via the Discogs API. unfortunately Discogs doesn't let us search for release IDs in our collection — we can only "iterate" through them 🌀 so the recommended way of adding newly gained releases is by using the -a option. periodt.

---

💅 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 gets added to your Discogs collection — same thing 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 of whether the release is already in your Discogs collection by asking the Discogs API — we only do a quick check of whether the ID is already in the local DiscoBASE. iykyk.
• -u, --tracks — extends the Discogs import so releases and also tracks get downloaded 🔥 takes significantly longer than the regular import, fair warning. 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 is a quick match, -zz is a 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 currently combine this option 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, bestie — go read them, they're giving study guide energy 📚

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),

---

and that's the whole vibe check 🦋 this lil page comes to you from DiscoDOS, dated June 15, 2020 — go import something iconic, bestie 💅✨