A standalone digital photo frame that displays your Immich photo library on a 10" touchscreen — no additional services required.
Built with ESPHome on the ESP32-P4, the frame connects directly to your Immich server over HTTP and streams photos to your display, completely in private over your local network.
- Fully standalone — runs on bare hardware, no hub or cloud service needed
- Photo sources — show all photos, favourites, specific albums, specific people, or "on this day" memories
- Display tone adjustment — adjust colour temperature (e.g. warm the image if the panel looks too blue)
- Night tone — automatically adjust screen tone between sunset and sunrise
- Screen scheduling — schedule when to turn off the display; set daytime and night-time brightness separately
- Smart portrait pairing — detects portrait photos and pairs them side-by-side from the same day
- Accent colour fill — letterboxed areas are tinted with a colour sampled from the photo
- Configuration options — change Immich URL, API key, slideshow interval, and more via the built-in web UI
| Item | Link |
|---|---|
| Panel | AliExpress |
| Printable stand | MakerWorld |
The easiest way to get started is with the web installer — flash the firmware directly from your browser with no toolchain or build step.
You'll need a USB-C data cable and Chrome or Edge on desktop.
Getting started, configuration, and troubleshooting guides are available at:
jtenniswood.github.io/espframe
If you find this project useful, consider buying me a coffee to support ongoing development!
