# This is the configuration file for listenbrainz-mpd.

# This section configures how the application will submit your listens to ListenBrainz.
[submission]
# The user token.
#
# If you use listenbrainz.org, obtain this from https://listenbrainz.org/profile and put it
# between the quotes.
#
# The `LISTENBRAINZ_TOKEN` environment variable will be preferred over this field if present.
token = ""
# Alternatively you can specify a path to a file that contains the token. This file will be read
# at runtime. Leading and trailing whitespace will be removed prior to use.
#token_file = ""

# Submit genre tags on the played songs as folksonomy tags.
#genres_as_folksonomy = true

# Split genres at the given separator character (and remove whitespace). This can be used if your
# genre tags are not multiple values, but separated with something like semicolons or slashes.
# Defaults to no splitting.
#genre_separator = ";"

# Base URL of the submission API. Change this if you want to use a different provider than
# listenbrainz.org.
#api_url = "https://api.listenbrainz.org"

# Listens that are not immediately sucessfully transmitted (e.g. because you are offline or the
# target server is having an outage) can be saved to a local cache for later submission and will
# automatically be retried.
# This is enabled by default, but can be disabled if undesired.
#enable_cache = true

# Path to the cache file that stores failed listens. Defaults to:
# Linux: 
#   `$XDG_DATA_HOME/listenbrainz-mpd/submission-cache.sqlite3` or
#   `$HOME/.local/share/listenbrainz-mpd/submission-cache.sqlite3` if XDG_DATA_HOME is not set.
# macOS:
#   `$HOME/Library/Application Support/listenbrainz-mpd/submission-cache.sqlite3`
# Windows:
#   `{FOLDERID_LocalAppData}\listenbrainz-mpd\submission-cache.sqlite3`
#
# If directory components of the path do not exist, they will be created.
#cache_file = "/some/other/path/filename.db"

# This section configures how the application connects to your MPD server.
#
# The `MPD_HOST` and `MPD_PORT` environment variables will be preferred over the settings from
# this section if present. Their syntax is compatible to that used by mpc.
[mpd]
# Address of the MPD server.
# This may be an IP address or a hostname. If no port is specified, port 6600 is assumed.
# IPv6 addresses need to be enclosed in square brackets to specify a port.
# If the value starts with a slash ("/"), it specifies a path to a Unix socket instead.
# If the value starts with an at ("@"), it specifies the name of an abstract socket (Linux only).
# Examples:
#address = "localhost"
#address = "mpd.example.com:6601"
#address = "127.0.0.1:1234"
#address = "::1"
#address = "[fe80::1%1]:6600"
#address = "/run/user/1000/mpd"
#address = "@mpd"

# MPD server password.
# Defaults to no password.
#password = ""
# Alternatively you can specify a path to a file that contains the password. This file will be
# read at runtime.
# Defaults to no path.
#password_file = ""
