Initial commit: WLED Screen Controller with FastAPI server and Home Assistant integration

This is a complete WLED ambient lighting controller that captures screen border pixels
and sends them to WLED devices for immersive ambient lighting effects.

## Server Features:
- FastAPI-based REST API with 17+ endpoints
- Real-time screen capture with multi-monitor support
- Advanced LED calibration system with visual GUI
- API key authentication with labeled tokens
- Per-device brightness control (0-100%)
- Configurable FPS (1-60), border width, and color correction
- Persistent device storage (JSON-based)
- Comprehensive Web UI with dark/light themes
- Docker support with docker-compose
- Windows monitor name detection via WMI (shows "LG ULTRAWIDE" etc.)

## Web UI Features:
- Device management (add, configure, remove WLED devices)
- Real-time status monitoring with FPS metrics
- Settings modal for device configuration
- Visual calibration GUI with edge testing
- Brightness slider per device
- Display selection with friendly monitor names
- Token-based authentication with login/logout
- Responsive button layout

## Calibration System:
- Support for any LED strip layout (clockwise/counterclockwise)
- 4 starting position options (corners)
- Per-edge LED count configuration
- Visual preview with starting position indicator
- Test buttons to light up individual edges
- Smart LED ordering based on start position and direction

## Home Assistant Integration:
- Custom HACS integration
- Switch entities for processing control
- Sensor entities for status and FPS
- Select entities for display selection
- Config flow for easy setup
- Auto-discovery of devices from server

## Technical Stack:
- Python 3.11+
- FastAPI + uvicorn
- mss (screen capture)
- httpx (async WLED client)
- Pydantic (validation)
- WMI (Windows monitor detection)
- Structlog (logging)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

server/docker-compose.yml

@@ -0,0 +1,45 @@
+version: '3.8'
+
+services:
+  wled-controller:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    container_name: wled-screen-controller
+    restart: unless-stopped
+
+    ports:
+      - "8080:8080"
+
+    volumes:
+      # Persist device data
+      - ./data:/app/data
+      # Persist logs
+      - ./logs:/app/logs
+      # Mount configuration (optional override)
+      - ./config:/app/config
+      # Required for screen capture on Linux
+      - /tmp/.X11-unix:/tmp/.X11-unix:ro
+
+    environment:
+      # Server configuration
+      - WLED_SERVER__HOST=0.0.0.0
+      - WLED_SERVER__PORT=8080
+      - WLED_SERVER__LOG_LEVEL=INFO
+
+      # Display for X11 (Linux only)
+      - DISPLAY=${DISPLAY:-:0}
+
+      # Processing defaults
+      - WLED_PROCESSING__DEFAULT_FPS=30
+      - WLED_PROCESSING__BORDER_WIDTH=10
+
+    # Use host network for screen capture access
+    # network_mode: host  # Uncomment for Linux screen capture
+
+    networks:
+      - wled-network
+
+networks:
+  wled-network:
+    driver: bridge