Espframe Screen Brightness and Display Settings
The Device settings page is divided into Display, Sleep & Schedule, and System sections. Display includes brightness (day/night), tone, rotation, and clock settings; the NTP servers are in Clock's Advanced panel. These controls are available in the web UI and, where applicable, Home Assistant.
Screen Brightness
Screen Brightness sets day and night levels; the frame switches by sunrise/sunset from your timezone. Sunrise/sunset shown below the sliders. In HA: Screen: Backlight (on/off + brightness).
| Setting | Default | Description |
|---|---|---|
| Daytime Brightness | 100% | Day (10-100%) |
| Nighttime Brightness | 75% | Night (10-100%) |
Night Schedule
Night Schedule turns the display fully off outside a time window: it switches to a black page, pauses LVGL, turns the backlight light off, and forces the physical PWM output off. When Schedule Screen Off is off, only day/night brightness applies. On/Off are hour-of-day (0–23). In HA: Screen: Schedule Enabled, Screen: Schedule On Hour, Screen: Schedule Off Hour, Screen: Schedule Wake Timeout.
| Setting | Default | Description |
|---|---|---|
| Schedule Screen Off | Off | Use scheduled on/off |
| On Time | 6 | Backlight on (hour) |
| Off Time | 23 | Backlight off (hour) |
| When Woken, Idle Time To Screen Off | 60 seconds | How long a touch wake stays on during the off period |
In Home Assistant, Screen: Sleep and Screen: Wake expose the same sleep/wake behavior as the touchscreen controls. Sleep pauses the slideshow fetch loop instead of only dimming the panel.
Rotation
Rotation rotates the LVGL display layer, so the picture and touch input turn together. This uses ESPHome 2026.4's LVGL rotation support.
The setting only exposes normal and upside-down orientations. On the 10" model, the firmware keeps its internal 90-degree panel offset and maps these two choices onto the correct LVGL values.
90 and 270 degree rotations are hidden unless Developer Features is enabled. Turning Developer Features off resets portrait rotation back to 0 degrees.
| Setting | Default | Description |
|---|---|---|
| Rotation | 0 degrees | Rotate the screen to 0 or 180 degrees. |
Frame Name
Open Device → System → Frame Name to give a frame a recognizable name, such as Living Room. Check the live network address preview, then click Save & Restart. The confirmation dialog links to the new hostname and current IP. The web title and backup filename use the saved name immediately; the network hostname and Home Assistant friendly name apply on restart. Follow the displayed address to reconnect, or use the frame's IP.
Hostnames use the first 19 characters of a simplified name plus the last four MAC characters, for example living-room-b2c3.local. Names without Latin letters or digits use frame as the hostname prefix. The displayed name supports Unicode up to 120 UTF-8 bytes. Home Assistant names you assigned manually take precedence.
Existing firmware names stay unchanged until you save a name. Leave the field blank and choose Save & Restart to restore the firmware defaults. Saved names survive normal OTA updates and power cycles. If storage is full, a save reports an error and retains the previous name; it never clears other settings to make room.
