Files
Medios-Macina/.env.example
T

116 lines
4.6 KiB
Bash
Raw Normal View History

2026-07-24 20:55:58 -07:00
# =============================================================================
# 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.