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` endpoint for integration with Grafana dashboards
• Captive portal — easy Wi-Fi setup on first boot
• mDNS — accessible by hostname (e.g. `http://candle.local`)

Hardware

• 9×16 LED matrix
• IS31FL3731 PWM controller

Software Stack

• Framework: Arduino (via PlatformIO)
• Web server: ESPAsyncWebServer
• Filesystem: LittleFS
• JSON: ArduinoJson 7
• LED driver: Adafruit IS31FL3731 Library

https://youtube.com/shorts/UzqbhlGrOIw?si=qKoooSAt5Xdp81i5

https://github.com/RootShell-coder/Candle