.env.example

# Samsung Frame TV Artwork Sync - Environment Variables

# Comma-separated list of TV IP addresses (REQUIRED)
# Example: TV_IPS=192.168.1.100,192.168.1.101,192.168.1.102
TV_IPS=192.168.1.100

# How often to check and sync artwork (in minutes)
# Default: 5
SYNC_INTERVAL_MINUTES=5

# Matte/border style for artwork
# Format: {style}_{color} (combines both) or "none" for no border
#
# Available Styles:
#   modernthin, modern, modernwide, flexible, shadowbox, panoramic, triptych, mix, squares
#
# Available Colors:
#   black, neutral, antique, warm, polar, sand, seafoam, sage, burgandy, navy,
#   apricot, byzantine, lavender, redorange, skyblue, turquoise
#
# Examples: shadowbox_polar (shadowbox style in polar color)
#           modern_apricot (modern style in apricot color)
#           flexible_antique (flexible style in antique color)
#           none (no matte/border - full screen)
#
# Default: none
MATTE_STYLE=none

# Optional: Slideshow & Brightness Control
#
# DEFAULT BEHAVIOR (if none of these are set):
#   The script preserves and restores your TV's current slideshow settings
#
# OVERRIDE BEHAVIOR (if any slideshow variable is set):
#   The script controls slideshow via these environment variables
#   All slideshow vars use defaults for unset values
#
# Uncomment to override slideshow settings:
# SLIDESHOW_ENABLED=true
# SLIDESHOW_INTERVAL=15  # Use a value supported by your TV model (e.g., 3, 15, 60, 720, 1440)
# SLIDESHOW_TYPE=shuffle  # shuffle or sequential

# Brightness Control (choose one):
#
# Option 1: Manual brightness (fixed value, applied every sync run)
# BRIGHTNESS=5  # Use value supported by your TV model (commonly 0-10 or 0-50)
#
# Option 2: Solar-based brightness (automatic adjustment based on sun position, applied every sync run)
# SOLAR_BRIGHTNESS_ENABLED=true
# LOCATION_LATITUDE=42.3601  # Your location's latitude
# LOCATION_LONGITUDE=-71.0589  # Your location's longitude
# LOCATION_TIMEZONE=America/New_York  # Your timezone (see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)
# BRIGHTNESS_MIN=2   # Brightness when sun is below horizon
# BRIGHTNESS_MAX=10  # Brightness when sun is at zenith (90°)
#
# Note: Solar brightness takes precedence over manual BRIGHTNESS if both are set

# Cleanup Control:
# When enabled, removes images from TV that were uploaded outside this script
# or before the script started tracking them. When disabled, preserves existing images.
# Default: false (preserves existing images)
REMOVE_UNKNOWN_IMAGES=false

# Auto-Off Control:
# Automatically turn off TVs at a specific time, but only when in art mode.
# TVs being used for other content (e.g., HDMI) are left alone.
# Requires LOCATION_TIMEZONE to be set.
#
# AUTO_OFF_TIME=22:00           # Time to turn off (24-hour format)
# AUTO_OFF_GRACE_HOURS=2        # Hours after AUTO_OFF_TIME to keep trying (default: 2)

# Client Name:
# Name sent to the TV during WebSocket connection, shown in the TV's authorized devices list.
# Default: FrameTVArtworkSync
# CLIENT_NAME=FrameTVArtworkSync

# Connection tuning (advanced — defaults work for most setups):
# Tune only if you see flaky connects, repeated re-auth prompts, or pairing failures.
#
# CONNECTION_TIMEOUT=10.0          # WebSocket timeout (s) for normal connects with an existing token
# AUTH_TIMEOUT=30.0                # WebSocket timeout (s) during first-time pairing
# KEEPALIVE_INTERVAL=60            # Seconds between keepalive pings between syncs (>= 1)
# CONNECT_MAX_ATTEMPTS=3           # Retry budget for connect errors (excludes pairing retries)
# CHANNEL_DROP_RETRY_DELAY=3.0     # Seconds between connect retries after a channel drop
# PAIRING_MAX_RETRIES=5            # Retries while waiting for first-time pairing approval on TV
# PAIRING_RETRY_DELAY=5.0          # Seconds between pairing retries (sized for human reaction time)

# Local paths for testing (uncomment these for local testing without Docker)
# ARTWORK_DIR=./artwork
# TOKEN_DIR=./tokens