Espframe for Immich
Espframe is a standalone Immich digital photo frame for a supported Guition ESP32-P4 touchscreen. It turns an ESP32 photo frame into a private, self-hosted photo frame that displays your Immich library directly from your own server.
The firmware runs on ESP32-P4 hardware with ESPHome and connects to Immich over HTTP or HTTPS. It does not need Home Assistant, a cloud account, or a separate bridge service.

Features
- Photo Sources — Show all photos, favorites only, specific albums, specific people, "on this day" memories, or photos within a date range.
- Display Tone Adjustment — Adjust colour temperature so the panel looks right (e.g. warm the image if it’s 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 levels separately.
- Portrait Pairing — Automatically pairs portrait photos taken on the same day for a side-by-side display that fills the screen edge-to-edge.
- Accent Color Fill — Replaces black letterbox bars with a muted color sampled from the photo itself.
- Clock Overlay — Displays the current time over your photos when enabled in settings.
- No Hub Required — Connects directly to your Immich server over HTTP or HTTPS — no Home Assistant, cloud service, or extra software needed.
Where to Buy
| Model | Panel | Stand |
|---|---|---|
Guition ESP32-P4 10" JC8012P4A1 | AliExpress | MakerWorld |
Support This Project
If you find this project useful, consider buying me a coffee to support ongoing development!
