METALFINDER(1)

💖 NAME 💖

okay so metalfinder — it's a CLI tool that finds concerts based on a music directory 🎸✨ like, you point it at your music, it goes and hunts down shows for you. bestie behaviour fr fr.

---

✨ SYNOPSIS ✨

metalfinder [-d <directory>] -o <output> -l <location> -b <app_id> [-c <cache>] [-m <date>] [--verbose]
metalfinder (-h | --help)
metalfinder --version

---

🎀 DESCRIPTION 🎀

metalfinder is a command-line tool that scans a music directory to find concerts near a specified location. that's it, that's the whole vibe — your library in, concerts near you out 💅

---

🦋 OPTIONS 🦋

• -h, --help — pops up the help screen, no thoughts head empty just answers 🌸
• --version — spits out the version info, so you know what you're working with ⭐
• --verbose — runs the program in verbose mode, i.e. it tells you everything that's happening, main character narration energy 👑
• -d, --directory <directory> — the music directory it scans to build up the artist list. your library, your lineup 🎧
• -o, --output <output> — path to the output file you want. you can pick a text file (foo.txt), a JSON file (foo.json) or an ATOM file (foo.atom) — choose your fighter 🫶
• -l, --location <location> — name of the city to use when looking for concerts. where we're going bestie 📍
• -b, --bit-appid <app_id> — the Bandsintown App ID (that's your API key). it's optional when the METALFINDER_BIT_APPID environment variable is set 🔑
• -c, --cache-dir <cache_dir> — path to the cache directory. defaults to $HOME/.cache/metalfinder/ 💾
• -m, --max-date <date> — max date in YYYY-MM-DD format (that's ISO 8601, iykyk) 📅

---

🌈 ENVIRONMENT VARIABLES 🌈

metalfinder uses the following environment variables:

• METALFINDER_BIT_APPID — the Bandsintown API key. super useful to keep your API key from leaking when you're running metalfinder on the command line 🙈 keep that secret secret

---

🌸 EXAMPLES 🌸

$ export METALFINDER_BIT_APPID=mysecretapikey
$ metalfinder -d "/home/foo/Music" -o "/home/foo/metalfinder.atom" -l "Montreal"

look at that. iconic. ate and left no crumbs 🍓

---

💀 BUGS 💀

if something's broken (not in the slay way), bugs can be reported to your distribution's bug tracker or upstream at https://gitlab.com/baldurmen/metalfinder/issues. they wanna hear from you fr fr 🧚

---

💜 AUTHOR 💜

Louis-Philippe Véronneau — the legend behind all this ✨

---

and that's the whole page babes 💖 this was the metalfinder(1) page from the General Commands Manual, dated 2022 — mwah, go find some concerts 🎀🔥