.env.example

# yubal configuration

# Paths
# YUBAL_ROOT=                 # Project root (required, set by justfile for local dev)
YUBAL_DATA=./data             # Music library (default: {root}/data)
YUBAL_CONFIG=./config         # Config dir, cookies at ytdlp/cookies.txt (default: {root}/config)
# YUBAL_TEMP=                 # Temp directory (default: system temp)

# Server
YUBAL_HOST=127.0.0.1.         # Bind address (default: 127.0.0.1)
YUBAL_PORT=8000               # Server port (default: 8000)
YUBAL_RELOAD=false            # Auto-reload on code changes (default: false)
YUBAL_DEBUG=false             # Enable debug mode (default: false)
YUBAL_LOG_LEVEL=INFO          # DEBUG, INFO, WARNING, ERROR (default: INFO)
YUBAL_CORS_ORIGINS='["*"]'    # Allowed CORS origins (default: ["*"])

# Audio
YUBAL_AUDIO_FORMAT=opus       # opus, mp3, m4a (default: opus)
YUBAL_AUDIO_QUALITY=0         # 0 (best) to 10 (worst) (default: 0)

# Lyrics
YUBAL_FETCH_LYRICS=true       # Fetch lyrics from lrclib.net (default: true)

# Downloads
YUBAL_DOWNLOAD_UGC=false      # Download user-generated content to _Unofficial/ (default: false)

# Filenames
YUBAL_ASCII_FILENAMES=false   # Transliterate unicode to ASCII in filenames (default: false)

# Jobs
YUBAL_JOB_TIMEOUT_SECONDS=1800  # Job execution timeout in seconds (default: 1800)

# Scheduler
YUBAL_SCHEDULER_ENABLED=true       # Enable scheduled sync (default: true)
YUBAL_SCHEDULER_CRON="0 0 * * *"   # Cron schedule (default: daily at midnight)

# Timezone
YUBAL_TZ=UTC                  # IANA format (default: UTC)