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
- Smart Photo Filters — Combine albums, people, tags, favorites, ratings, dates, locations, exclusions, and orientation.
- 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 by default, with optional ±1-day or ±2-day matching for a side-by-side display that fills the screen edge-to-edge.
- 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, original (2627 or lower) and new (2628 or higher) panels | AliExpress | MakerWorld |
Support This Project
If you find this project useful, consider buying me a coffee to support ongoing development!
