Show the settings on the screen, tap actions and Override YAML in the README
The README pictures now match the released screens and ESP Screens: the light pages had the sliders and clock from before 0.2.43, the editor showed firmware 0.2.34, and the vacuum and climate cards carried Dutch names. New pictures show the settings page on the screen with Dark mode, the Screen settings cards, Perform action in the tile settings and Override YAML; the full reference gets the same and short notes on tap actions, Home Assistant's words and icons, and Override YAML. Rendered from the host firmware and the real add-on on the demo home, like the earlier pictures. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@@ -14,11 +14,13 @@ lights, the heating or the vacuum.
|
|||||||
**What.** Firmware for two affordable panels, the 2.8-inch CYD and the 4-inch Guition, with up to
|
**What.** Firmware for two affordable panels, the 2.8-inch CYD and the 4-inch Guition, with up to
|
||||||
twenty tiles over four pages: lights, climate, blinds and curtains, the vacuum, media, the weather,
|
twenty tiles over four pages: lights, climate, blinds and curtains, the vacuum, media, the weather,
|
||||||
history graphs, clocks and timers. An automation can put an alert on every screen when someone rings
|
history graphs, clocks and timers. An automation can put an alert on every screen when someone rings
|
||||||
the bell, and a Guition shows who is there with the doorbell camera's picture.
|
the bell, and a Guition shows who is there with the doorbell camera's picture. A tap can run any
|
||||||
|
action Home Assistant has for a tile, and Dark mode suits a screen beside the bed.
|
||||||
|
|
||||||
**How.** ESP Screen Manager is an app inside Home Assistant. It flashes a new screen over USB, updates
|
**How.** ESP Screen Manager is an app inside Home Assistant. It flashes a new screen over USB, updates
|
||||||
it over Wi-Fi and sends it your tiles. Changing a screen is pick, drag and **Save & send to screen**:
|
it over Wi-Fi and sends it your tiles. Changing a screen is pick, drag and **Save & send to screen**:
|
||||||
no reflash, no YAML to write, no blueprint, MQTT or token.
|
no reflash, no YAML to write, no blueprint, MQTT or token. Brightness, night hours and Dark mode can
|
||||||
|
also be changed on the screen or by an automation, and your own YAML for one screen survives every update.
|
||||||
|
|
||||||
**[Install it](#installing-from-home-assistant)** · [Full reference](README_EXTENDED.md) · [What's new](screen_manager/CHANGELOG.md)
|
**[Install it](#installing-from-home-assistant)** · [Full reference](README_EXTENDED.md) · [What's new](screen_manager/CHANGELOG.md)
|
||||||
|
|
||||||
@@ -57,6 +59,12 @@ no reflash, no YAML to write, no blueprint, MQTT or token.
|
|||||||
<img src="docs/images/guition-dark-page-4.png" width="32%" alt="Dark mode with pastel backgrounds: the coffee machine and the good-night script keep their colour, deeper">
|
<img src="docs/images/guition-dark-page-4.png" width="32%" alt="Dark mode with pastel backgrounds: the coffee machine and the good-night script keep their colour, deeper">
|
||||||
</p>
|
</p>
|
||||||
<p align="center"><sub>Dark mode, for a screen beside the bed: the same pages, darker. It is a switch on the screen, in ESP Screens and in Home Assistant, so an automation can turn it on at bedtime.</sub></p>
|
<p align="center"><sub>Dark mode, for a screen beside the bed: the same pages, darker. It is a switch on the screen, in ESP Screens and in Home Assistant, so an automation can turn it on at bedtime.</sub></p>
|
||||||
|
<p align="center">
|
||||||
|
<img src="docs/images/guition-settings-screen.png" width="32%" alt="The settings page on the Guition, Screen: the 12 or 24-hour clock, back to page 1 by itself and after how long, also on standby, swiping between pages and the rotation">
|
||||||
|
<img src="docs/images/guition-settings.png" width="32%" alt="The settings page on the Guition, Brightness: the brightness with minus and plus, Dark mode off, Auto standby on, standby after 10 minutes and the standby brightness">
|
||||||
|
<img src="docs/images/guition-dark-settings.png" width="32%" alt="The same Brightness page right after turning Dark mode on: a black page with graphite rows and soft white text">
|
||||||
|
</p>
|
||||||
|
<p align="center"><sub>Settings on the screen itself: hold the top bar. The same brightness, Dark mode, standby, night hours, clock and rotation as in ESP Screens, and every one of them is an entity in Home Assistant.</sub></p>
|
||||||
|
|
||||||
## Managed from Home Assistant
|
## Managed from Home Assistant
|
||||||
|
|
||||||
@@ -65,15 +73,23 @@ no reflash, no YAML to write, no blueprint, MQTT or token.
|
|||||||
</p>
|
</p>
|
||||||
<p align="center"><sub>ESP Screens, a page in Home Assistant: every screen on the left, its top bar and tiles on the right.</sub></p>
|
<p align="center"><sub>ESP Screens, a page in Home Assistant: every screen on the left, its top bar and tiles on the right.</sub></p>
|
||||||
<p align="center">
|
<p align="center">
|
||||||
<img src="docs/images/editor-tiles.png" width="59%" alt="Choosing tiles: every page in the screen preview, next to the entity picker with filters">
|
<img src="docs/images/editor-tiles.png" width="63%" alt="Choosing tiles: every page in the screen preview, next to the entity picker with filters">
|
||||||
<img src="docs/images/editor-tile-settings.png" width="37%" alt="Tile settings: name, icon, display, width, direct control, tap action and pastel background">
|
<img src="docs/images/editor-tile-settings.png" width="33%" alt="Tile settings of the curtains: double-width with open, stop and close on the tile, and on tap Perform action with Set cover position at 50 %">
|
||||||
</p>
|
</p>
|
||||||
<p align="center"><sub>Search your home, drop a tile on the preview, tap it for its name, width, control and color. Save, and the screen has it.</sub></p>
|
<p align="center"><sub>Search your home, drop a tile on the preview, tap it for its name, width, control and color, and for what a tap does: open its card, switch it, or run any action Home Assistant has for it, such as the curtains to 50 %. Save, and the screen has it.</sub></p>
|
||||||
<p align="center">
|
<p align="center">
|
||||||
<img src="docs/images/editor-top-bar.png" width="31%" alt="Add to the top bar: the time, an analog clock, the date and suggestions from your own home">
|
<img src="docs/images/editor-top-bar.png" width="31%" alt="Add to the top bar: the time, an analog clock, the date and suggestions from your own home">
|
||||||
<img src="docs/images/editor-settings.png" width="65%" alt="Settings in ESP Screens: New screen and Firmware & USB, the firmware updates, the Alerts cheatsheet, and the Claude skill">
|
<img src="docs/images/editor-settings.png" width="65%" alt="Settings in ESP Screens: New screen and Firmware & USB, the firmware updates, the Alerts cheatsheet, and the Claude skill">
|
||||||
</p>
|
</p>
|
||||||
<p align="center"><sub>A top bar built from your own home, firmware updates over Wi-Fi (every night if you like), and a skill so Claude can rearrange your screens.</sub></p>
|
<p align="center"><sub>A top bar built from your own home, firmware updates over Wi-Fi (every night if you like), and a skill so Claude can rearrange your screens.</sub></p>
|
||||||
|
<p align="center">
|
||||||
|
<img src="docs/images/editor-screen-settings.png" width="98%" alt="Screen settings in ESP Screens: Brightness with Dark mode and standby, Night with its hours and brightness, and Screen with the clock, back to page 1, swiping and the rotation">
|
||||||
|
</p>
|
||||||
|
<p align="center"><sub>Screen settings apply at once, and a change made on the screen or by an automation shows up here too.</sub></p>
|
||||||
|
<p align="center">
|
||||||
|
<img src="docs/images/editor-override-yaml.png" width="50%" alt="Override YAML for the living room screen: a small file of its own, loaded after the shared package, here with the example that changes the display controller">
|
||||||
|
</p>
|
||||||
|
<p align="center"><sub>Other hardware, such as a different display controller? Every screen has an Override YAML of its own, checked by ESPHome before a build and kept through every update.</sub></p>
|
||||||
|
|
||||||
## Alerts
|
## Alerts
|
||||||
|
|
||||||
|
|||||||
@@ -49,6 +49,15 @@ on the screen itself, and how updates work.
|
|||||||
− / + or a slider (numbers), previous/next (select), start/pause and
|
− / + or a slider (numbers), previous/next (select), start/pause and
|
||||||
cancel (timer), and a single button for scenes, scripts, and buttons. Configurable
|
cancel (timer), and a single button for scenes, scripts, and buttons. Configurable
|
||||||
per tile; **None** keeps the regular card.
|
per tile; **None** keeps the regular card.
|
||||||
|
- **On tap** (app 0.2.67 / firmware 0.2.58): **Automatic**, **Open control**, **View only**,
|
||||||
|
**On / off** for everything Home Assistant can toggle, covers included, or **Perform action**:
|
||||||
|
any action Home Assistant has for the tile's entity, under Home Assistant's own names and with
|
||||||
|
its fields, such as Set cover position at 50 %. Holding the tile still opens its card, and the
|
||||||
|
tile settings only offer what Home Assistant supports for that entity.
|
||||||
|
- **Home Assistant's words and icons** (app 0.2.67 / firmware 0.2.58): a blind says Open or
|
||||||
|
Closing, a speaker Playing and a door Open or Closed, a sensor shows the decimals Home Assistant
|
||||||
|
shows, and a tile without an icon of its own gets the one Home Assistant shows, following its
|
||||||
|
state. A light or binary sensor that is off turns grey (firmware 0.2.53+).
|
||||||
- **Weather card** with current weather, the coming hours and days including chance of
|
- **Weather card** with current weather, the coming hours and days including chance of
|
||||||
rain or millimeters; **climate card** with an on/off button, mode, fan, and swing settings.
|
rain or millimeters; **climate card** with an on/off button, mode, fan, and swing settings.
|
||||||
The target temperature sits big between − / + keys with one row of mode keys below; the
|
The target temperature sits big between − / + keys with one row of mode keys below; the
|
||||||
@@ -92,6 +101,9 @@ on the screen itself, and how updates work.
|
|||||||
orientation and its own calibration.
|
orientation and its own calibration.
|
||||||
- **Inspector:** check entities, status, and configuration in ESP Screens.
|
- **Inspector:** check entities, status, and configuration in ESP Screens.
|
||||||
Action feedback shows that a command is on its way.
|
Action feedback shows that a command is on its way.
|
||||||
|
- **Override YAML per screen** (app 0.2.61): your own ESPHome YAML for one screen, such as another
|
||||||
|
display controller, kept through updates. See
|
||||||
|
[Updates and keeping your settings](#updates-and-keeping-your-settings).
|
||||||
|
|
||||||
<p align="center">
|
<p align="center">
|
||||||
<img src="docs/images/guition-tiles-controls.png" width="32%" alt="Double-width tiles with direct control: heating mode keys with heat selected, previous, pause and next for the Sonos, and a ceiling fan's speed slider">
|
<img src="docs/images/guition-tiles-controls.png" width="32%" alt="Double-width tiles with direct control: heating mode keys with heat selected, previous, pause and next for the Sonos, and a ceiling fan's speed slider">
|
||||||
@@ -292,10 +304,10 @@ value. Click **Save & send to screen** to apply the changes.
|
|||||||
After the first supporting firmware update, this requires no new flash.
|
After the first supporting firmware update, this requires no new flash.
|
||||||
|
|
||||||
<p align="center">
|
<p align="center">
|
||||||
<img src="docs/images/editor-tile-settings.png" width="36%" alt="Tile settings: name, icon, display, width, direct control, tap action and pastel background">
|
<img src="docs/images/editor-tile-settings.png" width="39%" alt="Tile settings of the curtains: double-width with open, stop and close on the tile, and on tap Perform action with Set cover position at 50 %">
|
||||||
<img src="docs/images/guition-controls.png" width="60%" alt="The result on the screen: a double-width Heating tile with temperature − and +">
|
<img src="docs/images/guition-page-3.png" width="57%" alt="The result on the screen: the double-width Curtains tile with open, stop and close, above a kitchen timer, a scene and the sun path">
|
||||||
</p>
|
</p>
|
||||||
<p align="center"><sub>The settings of the Heating tile, and that tile on the screen: double-width with temperature − / +.</sub></p>
|
<p align="center"><sub>The settings of the Curtains tile, and that tile on the screen: open, stop and close on the tile, and a tap on its name sets the curtains to 50 %.</sub></p>
|
||||||
|
|
||||||
A color is a fixed choice for that tile: it stays red, for example,
|
A color is a fixed choice for that tile: it stays red, for example,
|
||||||
even when you run the all-off script. The entity status and action feedback
|
even when you run the all-off script. The entity status and action feedback
|
||||||
@@ -351,11 +363,21 @@ Home Assistant, `esphome.<screen>_open_settings` opens it too (`page` 0 menu, 1
|
|||||||
| Screen | 12/24-hour clock, back to page 1 by itself and after how long, also on standby, swiping between pages, rotation (boards that turn) |
|
| Screen | 12/24-hour clock, back to page 1 by itself and after how long, also on standby, swiping between pages, rotation (boards that turn) |
|
||||||
| This screen | Name, IP address, firmware version, Home Assistant connected, Restart |
|
| This screen | Name, IP address, firmware version, Home Assistant connected, Restart |
|
||||||
|
|
||||||
|
<p align="center">
|
||||||
|
<img src="docs/images/guition-settings-menu.png" width="32%" alt="The settings menu on the Guition: Brightness, Night, Screen and This screen">
|
||||||
|
<img src="docs/images/guition-settings.png" width="32%" alt="The Brightness page: the brightness with minus and plus, Dark mode off, Auto standby on, standby after 10 minutes and the standby brightness">
|
||||||
|
<img src="docs/images/guition-settings-night.png" width="32%" alt="The Night page: Night mode on, starting at 22:00 and ending at 07:00, and the night brightness">
|
||||||
|
</p>
|
||||||
|
|
||||||
Tap a toggle to flip it, `-` and `+` to change a number or a time — hold them and a time walks
|
Tap a toggle to flip it, `-` and `+` to change a number or a time — hold them and a time walks
|
||||||
whole hours — and tap a chip like the clock to cycle it. Every change is saved on the screen,
|
whole hours — and tap a chip like the clock to cycle it. Every change is saved on the screen,
|
||||||
takes effect at once, and appears in ESP Screens within a second, so both sides always show
|
takes effect at once, and appears in ESP Screens within a second, so both sides always show
|
||||||
the same value. The **Screen settings** cards in ESP Screens have the same rows.
|
the same value. The **Screen settings** cards in ESP Screens have the same rows.
|
||||||
|
|
||||||
|
<p align="center">
|
||||||
|
<img src="docs/images/editor-screen-settings.png" width="98%" alt="Screen settings in ESP Screens: Brightness with Dark mode and standby, Night with its hours and brightness, and Screen with the clock, back to page 1, swiping and the rotation">
|
||||||
|
</p>
|
||||||
|
|
||||||
**In Home Assistant** (firmware 0.2.49+), every setting is an entity on the screen's device, under
|
**In Home Assistant** (firmware 0.2.49+), every setting is an entity on the screen's device, under
|
||||||
*Configuration*: `number.<screen>_normal_brightness`, `switch.<screen>_night_mode`,
|
*Configuration*: `number.<screen>_normal_brightness`, `switch.<screen>_night_mode`,
|
||||||
`time.<screen>_night_starts`, `switch.<screen>_24_hour_clock`, `select.<screen>_rotation` on a
|
`time.<screen>_night_starts`, `switch.<screen>_24_hour_clock`, `select.<screen>_rotation` on a
|
||||||
@@ -371,6 +393,7 @@ and setting a value the screen already has costs nothing. The full list is in
|
|||||||
| Screen settings | Change them in ESP Screens (they apply at once), on the screen, or on their entities in Home Assistant |
|
| Screen settings | Change them in ESP Screens (they apply at once), on the screen, or on their entities in Home Assistant |
|
||||||
| New version of the management page | Update ESP Screen Manager in the HA App store |
|
| New version of the management page | Update ESP Screen Manager in the HA App store |
|
||||||
| New feature on the physical screen | The **Update** button on the screen (badge *Update x.y.z*), or **Update automatically every night** under Settings |
|
| New feature on the physical screen | The **Update** button on the screen (badge *Update x.y.z*), or **Update automatically every night** under Settings |
|
||||||
|
| Your own YAML for one screen | **Override YAML** in ESP Screens; kept through updates (app 0.2.61) |
|
||||||
|
|
||||||
Every app version belongs to one firmware version. After an app update, the list
|
Every app version belongs to one firmware version. After an app update, the list
|
||||||
shows per screen whether newer firmware is available. **Update** builds that screen's own profile
|
shows per screen whether newer firmware is available. **Update** builds that screen's own profile
|
||||||
@@ -386,6 +409,17 @@ screen preferences stay stored on the device. Updates don't replace this
|
|||||||
user data. Do still make normal Home Assistant backups and keep your
|
user data. Do still make normal Home Assistant backups and keep your
|
||||||
device profiles; removing an app or wiping flash memory is not an update.
|
device profiles; removing an app or wiping flash memory is not an update.
|
||||||
|
|
||||||
|
**Your own YAML for one screen (app 0.2.61).** **Override YAML** in ESP Screens edits a small
|
||||||
|
`<screen>.local.yaml` beside the screen's profile, for hardware-specific changes such as another
|
||||||
|
display controller. It is loaded after the shared board package and stays in place when the app or
|
||||||
|
the firmware package updates. The screen's name, Wi-Fi, API, OTA, packages, external components and
|
||||||
|
captive portal stay managed and are refused there. **Save & check** runs ESPHome's full validation
|
||||||
|
of the complete profile, and a build never starts from an invalid one.
|
||||||
|
|
||||||
|
<p align="center">
|
||||||
|
<img src="docs/images/editor-override-yaml.png" width="60%" alt="Override YAML for the living room screen: a small file of its own, loaded after the shared package, here with the example that changes the display controller">
|
||||||
|
</p>
|
||||||
|
|
||||||
**Efficient, even with many screens (0.2.39 / firmware 0.2.33).** The app sends a
|
**Efficient, even with many screens (0.2.39 / firmware 0.2.33).** The app sends a
|
||||||
screen only the tile that changed, as a single action
|
screen only the tile that changed, as a single action
|
||||||
(`esphome.<device_name>_screen_message`) instead of chunks in a text field.
|
(`esphome.<device_name>_screen_message`) instead of chunks in a text field.
|
||||||
|
|||||||
|
Before Width: | Height: | Size: 22 KiB After Width: | Height: | Size: 22 KiB |
|
Before Width: | Height: | Size: 16 KiB After Width: | Height: | Size: 16 KiB |
|
Before Width: | Height: | Size: 20 KiB After Width: | Height: | Size: 20 KiB |
|
Before Width: | Height: | Size: 18 KiB After Width: | Height: | Size: 17 KiB |
|
Before Width: | Height: | Size: 239 KiB After Width: | Height: | Size: 245 KiB |
|
Before Width: | Height: | Size: 176 KiB After Width: | Height: | Size: 188 KiB |
|
After Width: | Height: | Size: 301 KiB |
|
After Width: | Height: | Size: 187 KiB |
|
Before Width: | Height: | Size: 284 KiB After Width: | Height: | Size: 272 KiB |
|
Before Width: | Height: | Size: 174 KiB After Width: | Height: | Size: 160 KiB |
|
Before Width: | Height: | Size: 302 KiB After Width: | Height: | Size: 266 KiB |
|
Before Width: | Height: | Size: 193 KiB After Width: | Height: | Size: 192 KiB |
|
Before Width: | Height: | Size: 373 KiB After Width: | Height: | Size: 354 KiB |
|
Before Width: | Height: | Size: 30 KiB After Width: | Height: | Size: 29 KiB |
|
Before Width: | Height: | Size: 29 KiB After Width: | Height: | Size: 29 KiB |
|
Before Width: | Height: | Size: 29 KiB After Width: | Height: | Size: 29 KiB |
|
After Width: | Height: | Size: 28 KiB |
|
Before Width: | Height: | Size: 36 KiB After Width: | Height: | Size: 36 KiB |
|
After Width: | Height: | Size: 16 KiB |
|
After Width: | Height: | Size: 21 KiB |
|
After Width: | Height: | Size: 29 KiB |
|
After Width: | Height: | Size: 27 KiB |
|
Before Width: | Height: | Size: 28 KiB After Width: | Height: | Size: 28 KiB |
|
Before Width: | Height: | Size: 35 KiB After Width: | Height: | Size: 35 KiB |
|
Before Width: | Height: | Size: 36 KiB After Width: | Height: | Size: 34 KiB |