DISCO-SEARCH(1)

💿 DISCO-SEARCH(1) — the disco-search page, bestie edition ✨

okay so you're in the General Commands Manual section, page DISCO-SEARCH(1), and honestly? this one's a whole mood. it's about searching, editing and updating DiscoDOS releases and tracks. let's go 💅

---

🌸 NAME 🌸

disco-search — search, edit and update DiscoDOS releases and tracks

---

🎀 SYNOPSIS 🎀

disco search [--help]
      [--mix | --discogs-update | --brainz-update | --edit] [--track]
      [--pos] [--resume] search_terms

---

✨ DESCRIPTION ✨

so the search command goes hunting for releases and tracks inside your Discogs collection. and like, that's not all it does — you can run a bunch of actions on the stuff you find. adding to a mix? yep. updating track info from Discogs? obviously. pulling extra info from MusicBrainz/AcousticBrainz? say less. or just adding track info by hand (user-defined BPM/key, track notes, user-defined AcousticBrainz recording ID) — also iconic. 🫶

---

🦋 ARGUMENTS 🦋

• search_terms — the collection gets searched for these terms, periodt. when you're offline, it only looks through all releases' artists/titles (eg tracknames not considered). when you're online, the Discogs API search engine is used and also tracknames, artists, labels and catalog numbers are looked through. If your search term consists of multiple words, put them inside double quotes (eg. "foo bar term"). If you instead put a number as your search term, it is assumed you want to view exactly the Discogs release with the given ID. If search term is the special keyword "all", a list of all releases in the DiscoBASE is shown (including weblinks to Discogs/MusicBrainz release pages). In combination with -u, -z or -zz respectively, all tracks are updated. Note that this is exactely the same as disco import in combination with those options. 👑

ngl the "exactely" typo is in the original and I'm keeping it because I'm not a snitch 💖

---

💅 OPTIONS 💅

• -h, --help — show this help message and exit
• -m MIX_NAME, --mix MIX_NAME — adds a track of the found release to the given mix ID (asks which track to add in case -t is missing).
• -u, --discogs-update — updates found release/track with Discogs track/artist details (asks which track to update in case -t is missing).
• -z, --brainz-update — updates found release/track with additional info from MusicBrainz and AcousticBrainz. (asks which track to update in case -t is missing) -z quick match, -zz detailed match (takes longer, but more results).
• -e, --edit — edits/adds details to a found release/track. Editable fields: key, BPM, key notes, general track notes, custom MusicBrainz recording ID. (asks which track to edit in case -t is missing).
• -t TRACK_NUMBER, --track TRACK_NUMBER — in combination with -m this option adds the given track number (eg. A1, AA, B2, ...) to the mix selected using .Fl m ; in combination with -z or -u the given track is the one being updated with *Brainz or Discogs details; in combination with -e the given track is to one to be edited.
• -p POS_IN_MIX, --pos POS_IN_MIX — in combination with -m this option states that we'd like to insert the track at the given position (eg. 1, 14, ...), rather than at the end of the mix; in combination with -z, -zz, -u or -e this option is ignored.
• --resume OFFSET — resumes long-running processes at the given offset position (expects a number). You can combine this option currently with *Brainz matching operations 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-import(1), disco-suggest(1), disco-mix(1), disco(1) discosync(1)

---

and that's the whole page, bestie 🫶 this was DiscoDOS, dated June 15, 2020, and it's giving main character energy from start to finish. slay, stay hydrated, and go search something cute 💅✨