---
name: "metalfinder"
section: "1"
platform: "linux"
package: "metalfinder"
version: "2.1.6-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/metalfinder"
---

# metalfinder(1)

CLI tool to find concerts from a music directory

## 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*.

## AUTHOR

Louis-Philippe Véronneau