Skip to content

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.

Espframe displaying photos on a Guition ESP32-P4 touchscreen

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

ModelPanelStand
Guition ESP32-P4 10" JC8012P4A1AliExpressMakerWorld

Support This Project

If you find this project useful, consider buying me a coffee to support ongoing development!

Buy Me A Coffee
Buy Me A CoffeeBuy Me A Coffee