# =============================================================================
# Medeia-Macina Environment Variables
# =============================================================================
# Copy this file to .env and adjust values as needed.
#
# All variables are optional unless noted otherwise. The application auto-detects
# sensible defaults for most settings.

# ---------------------------------------------------------------------------
# Core / Debug
# ---------------------------------------------------------------------------

# Enable debug mode (verbose logging, diagnostic output, rich tracebacks).
# Set to "1" to enable.
# Default: disabled (unless the database config key `debug` is "1"/"true"/"yes"/"on")
MM_DEBUG=0

# Enable raw HTTP request/response body logging in debug output. When set to
# "0", "false", "no", or "off", raw bodies are suppressed even while MM_DEBUG
# is active. Any other value (or unset) follows MM_DEBUG.
MM_HTTP_RAW=0

# ---------------------------------------------------------------------------
# Repository / Paths
# ---------------------------------------------------------------------------

# Application root directory. Searched for medios.db, CLI.py, and config.conf.
# Precedence: MM_REPO > MM_ROOT > REPO > auto-detection from CWD.
MM_REPO=

# Alternative root directory name (checked if MM_REPO is not set).
MM_ROOT=

# Legacy / generic repository path (checked after MM_REPO and MM_ROOT).
REPO=

# Semicolon-separated list of external plugin directories. Plugins placed in
# these directories are discovered and registered at startup.
# Example: C:\extra-plugins;C:\more-plugins
MM_PLUGIN_PATH=

# Legacy alias for MM_PLUGIN_PATH (checked second).
MEDEIA_PLUGIN_PATH=

# ---------------------------------------------------------------------------
# Networking
# ---------------------------------------------------------------------------

# Custom SSL/TLS CA certificate bundle path (PEM format).
# Overrides system-wide trust stores for all TLS connections made by the
# application. Useful behind corporate MITM proxies or custom CAs.
SSL_CERT_FILE=

# ---------------------------------------------------------------------------
# MPV Integration
# ---------------------------------------------------------------------------

# Override the default MPV IPC socket / named-pipe path. Used by the CLI,
# the pipeline helper, and the lyrics overlay to communicate with mpv.
# Default (Windows): \\.\pipe\mpv-medios-macina
# Default (macOS/Linux): /tmp/mpv-medios-macina.sock
MEDEIA_MPV_IPC=

# Legacy alias for MEDEIA_MPV_IPC (checked second).
MPV_IPC_SERVER=

# Minimum log level for mpv's internal message stream forwarded to the helper
# log. Valid values: "fatal", "error", "warn" (default), "info", "debug", "v",
# "trace".
MEDEIA_MPV_HELPER_MPVLOG=warn

# ---------------------------------------------------------------------------
# Dependencies / Updates
# ---------------------------------------------------------------------------

# Automatically update Python dependencies on client startup.
# Set to "1" to force `pip install --upgrade` on the requirements file.
MM_UPDATE_DEPS=0

# ---------------------------------------------------------------------------
# Playwright / Browser Automation
# ---------------------------------------------------------------------------

# Path to the ffmpeg executable. Used by Playwright for video recording and
# processing. Resolution order:
#   1. Plugin config key `plugin.playwright.ffmpeg_path`
#   2. Environment variable `FFMPEG_PATH`
#   3. Environment variable `PLAYWRIGHT_FFMPEG_PATH` (legacy)
#   4. Project-bundled ffmpeg (MPV/ffmpeg/bin/)
#   5. System PATH lookup (`which ffmpeg`)
FFMPEG_PATH=

# Legacy Playwright-specific ffmpeg path. Prefer `FFMPEG_PATH` instead.
PLAYWRIGHT_FFMPEG_PATH=

# ---------------------------------------------------------------------------
# Internet Archive
# ---------------------------------------------------------------------------

# Internet Archive S3-like API access key. Used for uploads. Can also be
# configured in the plugin section of the config (key: `access_key`).
IA_ACCESS_KEY=

# Internet Archive S3-like API secret key. Used for uploads. Can also be
# configured in the plugin section of the config (key: `secret_key`).
IA_SECRET_KEY=

# ---------------------------------------------------------------------------
# Soulseek
# ---------------------------------------------------------------------------

# Enable verbose aioslsk library output (normally suppressed).
# Set to "1" to see debug-level noise from the Soulseek networking layer.
DOWNLOAD_SOULSEEK_VERBOSE=0
# Note: The old name `DOWNLOW_SOULSEEK_VERBOSE` (typo) is deprecated.