.env.example

# Tracklistify Configuration Example
# Copy this file to .env and modify as needed

# Base Settings
TRACKLISTIFY_OUTPUT_DIR=~/.tracklistify/output       # Directory for output files
TRACKLISTIFY_CACHE_DIR=~/.tracklistify/cache         # Directory for caching processed audio segments
TRACKLISTIFY_TEMP_DIR=~/.tracklistify/temp           # Directory for temporary files
TRACKLISTIFY_VERBOSE=true                            # Enable verbose logging
TRACKLISTIFY_DEBUG=true                              # Enable debug mode

# Track Identification Settings
TRACKLISTIFY_SEGMENT_LENGTH=60                      # Length of audio segments in seconds (10 to 300)
TRACKLISTIFY_MIN_CONFIDENCE=0.0                     # Minimum confidence threshold (0.0 to 1.0)
TRACKLISTIFY_TIME_THRESHOLD=60.0                    # Time threshold between tracks in seconds (0.0 to 300.0)
TRACKLISTIFY_MAX_DUPLICATES=2                       # Maximum number of duplicate tracks (0 to 10)
TRACKLISTIFY_OVERLAP_DURATION=10                    # Overlap duration between segments in seconds (0 to 30)
TRACKLISTIFY_OVERLAP_STRATEGY=weighted              # Overlap strategy (weighted, longest)
TRACKLISTIFY_MIN_SEGMENT_DURATION=10                # Minimum segment duration in seconds (1 to 60)

# Provider Settings
TRACKLISTIFY_PRIMARY_PROVIDER=shazam              # Primary track identification provider
TRACKLISTIFY_FALLBACK_ENABLED=false                  # Enable provider fallback
TRACKLISTIFY_FALLBACK_PROVIDERS=["acrcloud"]          # List of fallback providers

# ACRCloud Provider Settings
TRACKLISTIFY_ACRCLOUD_HOST=identify-eu-west-1.acrcloud.com  # ACRCloud API host
TRACKLISTIFY_ACRCLOUD_TIMEOUT=10                    # ACRCloud request timeout (1 to 60 seconds)
TRACKLISTIFY_ACR_ACCESS_KEY=your_access_key_here
TRACKLISTIFY_ACR_ACCESS_SECRET=your_access_secret_here

# Shazam Provider Settings
TRACKLISTIFY_SHAZAM_ENABLED=true                    # Enable Shazam provider
TRACKLISTIFY_SHAZAM_TIMEOUT=10                      # Shazam request timeout (1 to 60 seconds)

# Spotify Provider Settings
TRACKLISTIFY_SPOTIFY_TIMEOUT=10                     # Spotify request timeout (1 to 60 seconds)
TRACKLISTIFY_SPOTIFY_CLIENT_ID=your_spotify_client_id_here
TRACKLISTIFY_SPOTIFY_CLIENT_SECRET=your_spotify_client_secret_here
TRACKLISTIFY_SPOTIFY_COOKIES=~/.mozilla/firefox/profile/cookies.sqlite
TRACKLISTIFY_SPOTIFY_QUALITY=AAC_256
TRACKLISTIFY_SPOTIFY_FORMAT=m4a
TRACKLISTIFY_OUTPUT_DIR=~/Music/Tracklistify
TRACKLISTIFY_TEMP_DIR=./.tracklistify/temp
TRACKLISTIFY_VERBOSE=true

# Provider Retry Settings
TRACKLISTIFY_RETRY_STRATEGY=exponential             # Retry strategy (exponential, linear, constant)
TRACKLISTIFY_RETRY_MAX_ATTEMPTS=3                   # Maximum retry attempts (1 to 10)
TRACKLISTIFY_RETRY_BASE_DELAY=1.0                   # Base delay between retries (0.1 to 10.0 seconds)
TRACKLISTIFY_RETRY_MAX_DELAY=30.0                   # Maximum retry delay (1.0 to 300.0 seconds)

# Rate Limiting Settings
TRACKLISTIFY_RATE_LIMIT_ENABLED=true                # Enable rate limiting
TRACKLISTIFY_MAX_REQUESTS_PER_MINUTE=60             # Global maximum requests per minute (1 to 1000)
TRACKLISTIFY_MAX_CONCURRENT_REQUESTS=10             # Global maximum concurrent requests (1 to 100)

# Circuit Breaker Settings
TRACKLISTIFY_CIRCUIT_BREAKER_ENABLED=true          # Enable circuit breaker
TRACKLISTIFY_CIRCUIT_BREAKER_THRESHOLD=5           # Failures before opening circuit (1 to 100)
TRACKLISTIFY_CIRCUIT_BREAKER_RESET_TIMEOUT=60.0    # Seconds before half-open (1.0 to 3600.0)

# Rate Limit Alert Settings
TRACKLISTIFY_RATE_LIMIT_ALERT_ENABLED=true         # Enable rate limit alerts
TRACKLISTIFY_RATE_LIMIT_ALERT_THRESHOLD=5.0        # Alert if wait exceeds this (0.1 to 60.0 seconds)
TRACKLISTIFY_RATE_LIMIT_ALERT_COOLDOWN=300.0       # Minimum time between alerts (1.0 to 3600.0)

# Per-Provider Rate Limits
TRACKLISTIFY_SPOTIFY_MAX_RPM=120                    # Spotify maximum requests per minute (1 to 1000)
TRACKLISTIFY_SPOTIFY_MAX_CONCURRENT=20              # Spotify maximum concurrent requests (1 to 100)
TRACKLISTIFY_SHAZAM_MAX_RPM=60                     # Shazam maximum requests per minute (1 to 1000)
TRACKLISTIFY_SHAZAM_MAX_CONCURRENT=10              # Shazam maximum concurrent requests (1 to 100)
TRACKLISTIFY_ACRCLOUD_MAX_RPM=30                   # ACRCloud maximum requests per minute (1 to 1000)
TRACKLISTIFY_ACRCLOUD_MAX_CONCURRENT=5             # ACRCloud maximum concurrent requests (1 to 100)

# Cache Settings
TRACKLISTIFY_CACHE_ENABLED=true                     # Enable caching
TRACKLISTIFY_CACHE_TTL=3600                        # Cache TTL in seconds (1 to 86400)
TRACKLISTIFY_CACHE_MAX_SIZE=1000                   # Maximum cache size (1 to 1000000)
TRACKLISTIFY_CACHE_STORAGE_FORMAT=json             # Cache storage format
TRACKLISTIFY_CACHE_COMPRESSION_ENABLED=true        # Enable cache compression
TRACKLISTIFY_CACHE_COMPRESSION_LEVEL=6             # Cache compression level (1 to 9)
TRACKLISTIFY_CACHE_CLEANUP_ENABLED=true            # Enable cache cleanup
TRACKLISTIFY_CACHE_CLEANUP_INTERVAL=3600           # Cache cleanup interval in seconds (60 to 86400)
TRACKLISTIFY_CACHE_MAX_AGE=86400                  # Maximum cache age in seconds (3600 to 2592000)
TRACKLISTIFY_CACHE_MIN_FREE_SPACE=104857600       # Minimum free space in bytes (1MB to 1GB)

# Output Settings
TRACKLISTIFY_OUTPUT_FORMAT=json                    # Output format (json, markdown, m3u)

# Download Settings
TRACKLISTIFY_DOWNLOAD_QUALITY=192                  # Download quality (e.g., 192 for 192kbps)
TRACKLISTIFY_DOWNLOAD_FORMAT=mp3                   # Download format (e.g., mp3, flac)
TRACKLISTIFY_DOWNLOAD_MAX_RETRIES=3               # Maximum download retries (1 to 10)