.env.example

# Server Configuration
PORT=3000

# Game Library Directories
# Comma or semicolon-separated list of absolute paths to scan for games
# For bare metal: Use your actual host paths
# For Docker: This is ignored - edit docker-compose.yml volumes instead
# Examples:
#   Single directory: GAMES_DIRS=/data/games
#   Multiple directories: GAMES_DIRS=/mnt/nas/games,/mnt/usb/games,/data/backups
GAMES_DIRS=/data/games

# Cache TTL (seconds) for shop data. Higher values reduce filesystem scans (useful for network mounts).
# Set to 0 to disable caching.
CACHE_TTL=300

# Success Message (Optional)
# Custom message displayed in Tinfoil when the shop loads. Great for MOTD or greetings.
# Leave empty to disable.
# SUCCESS_MESSAGE=Welcome to your game library!

# Log Format
# Morgan-style log format: tiny, short, dev, common, combined
# tiny: GET /shop.tfl 200 - 287ms
# short: GET /shop.tfl 200 2.5MB - 287ms
# dev: GET /shop.tfl 200 2.5MB - 287ms (with colors)
# common: Apache Common Log Format
# combined: Apache Combined Log Format (includes User-Agent)
LOG_FORMAT=dev

# --- Authentication (Optional) ---
# Enable HTTP Basic Auth by setting either:
# 1) Separate user & pass (take precedence when set)
# AUTH_USER=
# AUTH_PASS=
# or
# 2) Combined credentials as user:pass
# AUTH_CREDENTIALS=

# --- TitleDB & Metadata Enrichment ---
# Enable TitleDB integration for rich game metadata (titles, icons, categories, versions)
TITLEDB_ENABLED=true

# TitleDB Region & Language
# Region: US, EU, JP, etc. | Language: en, es, fr, de, ja, etc.
TITLEDB_REGION=US
TITLEDB_LANGUAGE=en

# TitleDB Cache Directory
# Where to store downloaded TitleDB files (titles, versions)
TITLEDB_CACHE_DIR=./data/titledb

# Auto-update TitleDB on server start
# If false, TitleDB will only be downloaded once and cached permanently
TITLEDB_AUTO_UPDATE=true

# --- Media Cache Configuration ---
# Where to store downloaded game artwork (icons, banners)
MEDIA_CACHE_DIR=./data/media

# Media cache TTL in seconds (default: 7 days = 604800 seconds)
MEDIA_CACHE_TTL=604800