DISCO(1)

📦 version 2.0, in ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute

💿 DISCO(1) — the General Commands Manual, bestie ✨

okay so welcome to the disco page, section 1 of the general commands manual, and honestly? she ate. let's get into it 🫶

🌸 NAME 🌸

disco — the DiscoDOS CLI 💅

✨ SYNOPSIS ✨

disco [--help] [--verbose] [--offline] {search,mix,suggest,import,setup}
      ...

that's it, that's the whole vibe. one command, five subcommands, and a dream 🎀

🦋 DESCRIPTION 🦋

DiscoDOS helps a DJ remember and analyze what they played in their sets, or what they could possibly play in the future. it's based on data pulled from a user's Discogs record collection. tracks can be organized into playlists and mix-transitions rated. additionally the collection can be linked to the online music information services MusicBrainz and AcousticBrainz, so further information (like musical key and BPM) is made available to the user. like, free extra lore for your tracks?? obsessed 😭💖

DiscoDOS currently is available as a command line tool only, though prototypes of a mobile and a desktop app exist already. and despite of what the name implies — bestie, it's just the look that is reminiscent of the 80s/90s operating system 👾 — its usability follows most standards of a typical shell utility you would find on a UNIX-like operating system. it is aimed to support modern Linux, MacOS and Windows systems. main character energy across platforms fr fr 👑

🎀 SUBCOMMANDS 🎀

  • search — searches for releases and tracks in the Discogs collection. several actions can be executed on the found items, eg. adding to a mix, updating track info from Discogs or fetching additional information from MusicBrainz/AcousticBrainz. view this subcommand's help: disco search -h .
  • mix — manages your mixes. view this subcommand's help: disco mix -h .
  • suggest — suggests tracks based on what you've played before or views tracks based on BPM or musical key. view this subcommand's help: disco suggest -h .
  • import — imports your whole Discogs collection or just single releases. view this subcommand's help: disco import -h .
  • setup — sets up the DiscoBASE and handles database schema upgrades. view this subcommand's help: disco setup -h .

💅 OPTIONS 💅

  • -h, --help — show this help message and exit. the classic. the goat. 🐐
  • -v, --verbose — increases output verbosity / shows what DiscoDOS is doing under the hood ( -v is INFO level, -vv is DEBUG level). not me wanting to see everything she's thinking 🙈
  • -o, --offline — DiscoDOS checks for connectivity to online services (Discogs, MusicBrainz, AcousticBrainz) itself. this option forces offline mode. a lot of options work in on- and offline mode. some behave differently, depending on connection state. so like, watch out — the vibe changes depending on your wifi 💀

🍓 FILES 🍓

  • ~/.discodos/config.yaml — the DiscoDOS configuration file.
  • ~/.discodos/discobase.db — the DiscoDOS database file (aka the DiscoBASE).
  • ~/.discodos/debug.log — the DiscoDOS log file.

🌈 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

go read them, iykyk 📚✨

👑 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! 😭💖 iconic behavior from everyone involved, no cap.

🔥 SEE ALSO 🔥

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

this whole thing is DiscoDOS, dated June 15, 2020 — and that's the page, bestie. slay, periodt, go rate some mix transitions 💅🎧💖
📦 where this page comes from