metalfinder(1)

CLI tool to find concerts from a music directory

Section 1 metalfinder bookworm source

Description

METALFINDER

NAME

metalfinder - CLI tool to find concerts from a music directory

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.

OPTIONS

-h | --help

Show the help screen

--version

Output version information

--verbose

Run the program in verbose mode

-d | --directory <directory>

Music directory to scan to create artist list

-o | --output <output>

Path to the desired output file. You can either chose a text file
(foo.txt), a JSON file (foo.json) or an ATOM file (foo.atom)

-l | --location <location>

Name of the city to use when looking for concerts

-b | --bit-appid <app_id>

Bandsintown App ID (API key). 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 (ISO 8601)

ENVIRONMENT VARIABLES

metalfinder uses the following environment variables:

METALFINDER_BIT_APPID

Bandsintown API key. Useful to keep your API key from leaking when
running metalfinder on the command line.

EXAMPLES

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

BUGS

Bugs can be reported to your distribution's bug tracker or upstream at https://gitlab.com/baldurmen/metalfinder/issues.