update refactoring and add new features

.env.example

@@ -0,0 +1,115 @@
+# =============================================================================
+# 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.