.env.example

# FXRoute environment configuration
#
# Copy to .env when configuring manually:
#   cp .env.example .env
#
# install.sh creates .env automatically and preserves an existing .env on reruns.

# Required: local music library root.
# Supports ~ and $HOME expansion. The installer defaults to ~/Music.
# NAS shares work too when mounted locally first, e.g. MUSIC_ROOT=/mnt/music.
MUSIC_ROOT=~/Music

# Subfolder inside MUSIC_ROOT used for URL/download imports.
DOWNLOADS_SUBDIR=incoming

# URL download transcoding policy.
# Leave unset to keep the source format whenever possible.
# Set only if you explicitly want yt-dlp downloads transcoded, for example:
# DOWNLOAD_TRANSCODE_FORMAT=mp3
# Legacy note: AUDIO_FORMAT is still accepted for backwards compatibility, but
# DOWNLOAD_TRANSCODE_FORMAT is preferred for new configs.

# Logging: DEBUG, INFO, WARNING, ERROR.
LOG_LEVEL=INFO

# Web server bind settings.
# HOST=0.0.0.0 exposes FXRoute to the LAN. Use 127.0.0.1 for local-only use.
HOST=0.0.0.0
PORT=8000

# Maximum concurrent URL downloads.
# Current supported/recommended value is 1.
MAX_DOWNLOADS=1

# Optional USB-CDC hardware controller.
# Leave unset to keep hardware control disabled. Set an explicit device path to
# enable serial access, e.g. HARDWARE_CONTROLLER_DEVICE=/dev/ttyACM0.
# HARDWARE_CONTROLLER_DEVICE=/dev/ttyACM0

# Optional desktop app / maintenance helpers.
# These are installer-managed and off by default.
# Values: on/off, true/false, yes/no, 1/0.
SPOTIFY_AUTOSTART=off
SPOTIFY_CACHE_CLEANUP=off
SPOTIFY_CACHE_CLEANUP_INTERVAL_HOURS=24
SYSTEM_AUTO_UPDATE=off
SYSTEM_AUTO_UPDATE_INTERVAL_HOURS=24

# Notes:
# - EasyEffects mode is auto-detected. Fresh installs prefer Flatpak EasyEffects;
#   existing native/user-managed EasyEffects installs are accepted.
# - Optional .local naming and HTTPS/Caddy setup are configured interactively by
#   install.sh, not through .env.
# - Measurement calibration files, saved runs, and FXRoute runtime state live under
#   the user's config/state directories, not in this file.