Candle box

# Candle Matrix

A smart ambient light device based on a 9×16 LED matrix that simulates a flickering candle flame. Built on the **ESP32-S3** microcontroller with Wi-Fi connectivity and a built-in web interface.

---

## Features

- **Candle animation** — smooth flickering light effect on a 9×16 LED matrix
- **Auto sun mode** — automatically turns on at dusk and off at sunrise based on GPS coordinates; sunrise/sunset and twilight times are calculated on-device using NOAA solar formulas (no external API required)
- **Moon phase display** — dedicated moon phase animation mode
- **Sun position visualization** — real-time sun position indicator mode
- **Adjustable brightness** — 0–100% via web UI or HTTP API
- **NTP time sync** — accurate local time using a configurable NTP server and POSIX timezone
- **Web interface** — responsive UI served from LittleFS (no cloud dependency)
- **HTTP REST API** — control and monitor the device programmatically
- **Prometheus metrics** — `/metrics` endpoin