Show the languages in the README, with what the firmware costs

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Max Gramser
2026-09-20 11:46:55 +02:00
parent 227d0d5fc3
commit 8a81ff4d93
6 changed files with 26 additions and 6 deletions
+25 -5
View File
@@ -138,11 +138,31 @@ https://github.com/user-attachments/assets/f9f6a933-d388-4c8b-9c9a-011dfa37617b
## In your language
The screens, the editor and the app speak English (US and UK), Dutch, German, French, Italian, Spanish, Portuguese and
Polish. ESP Screens takes Home Assistant's language and uses its words, so a door says what it says in the Home
Assistant app. Settings → Language & region picks another language, the clock and how numbers are written, for every
screen at once. Most languages still need someone who speaks them to check the texts:
[Translating ESP Screens](docs/TRANSLATING.md) says how, and how to add a language.
<p align="center">
<img src="docs/images/guition-german.png" width="31%" alt="A Guition in German: Dienstag 15 Sept. beside the analog clock, Teilweise bewölkt with the days Di Mi Do Fr Sa, the table lamp at 75 %">
<img src="docs/images/guition-french.png" width="31%" alt="The same screen in French: mardi 15 sept., Éclaircies with the days ma me je ve sa, and Sam is Maison">
<img src="docs/images/guition-polish.png" width="31%" alt="The same screen in Polish: wtorek 15 wrz, częściowe zachmurzenie with the days wt śr cz pt sb, and Sam is w domu">
</p>
<p align="center"><sub>The same home in German, French and Polish. The screens follow your Home Assistant: its language, its words for a light or a robot, and how your country writes a date, a time and a number — 75 % in German and French, 75% in Polish and English.</sub></p>
The screens, the editor and its messages speak **English (US and UK), Nederlands, Deutsch, Français, Italiano,
Español, Português and Polski**. Nothing to set up: ESP Screens takes the language of your Home Assistant.
<p align="center">
<img src="docs/images/editor-language.png" width="36%" alt="Language and region in ESP Screens: the screen language set to Home Assistant's language, the time format and the number format, each following the language">
</p>
<p align="center"><sub>Settings → Language & region, when you want something else than Home Assistant's own.</sub></p>
- **The editor** follows the language of your Home Assistant profile, so two people in one house each read their own.
- **A screen** carries one language, built into its firmware: change it and press **Update** on the screen (or let
the nightly round do it). The clock (24 hours or 12 with AM/PM) and the number format change straight away, on
every screen at once.
- **Words from Home Assistant stay Home Assistant's**: what a door, an airco or a robot says on a tile and in its
card is the word its own dashboard shows, in your language.
Most languages still need someone who speaks them to read the texts through, and a new language is one file.
[Translating ESP Screens](docs/TRANSLATING.md) walks through both; a language without a file falls back to English
while it keeps your country's clock and numbers.
## Alerts
Binary file not shown.

After

Width:  |  Height:  |  Size: 88 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 35 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 36 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 36 KiB

+1 -1
View File
@@ -8,7 +8,7 @@ ESP Screens speaks your language: the screens, the editor and its messages in ni
- **Home Assistant's own words stay Home Assistant's.** What a door, an airco or a robot says, and the words in their cards (fan and swing modes, suction, the mop), come from your Home Assistant in your language, exactly as its own dashboard writes them. A space in front of a percent sign follows the same rule as Home Assistant: 54% in English and Dutch, 54 % in German, French, Czech, Finnish, Slovak and Swedish.
- **Room for longer words.** The weather columns show two-letter days, a long weather word ends in an ellipsis instead of running into them, and the line under a tile's name keeps the part that carries the news: "Yest. 9:15 PM" where the full wording doesn't fit, and a robot's battery stays readable behind Home Assistant's word for its state.
- **Add or improve a language yourself.** Every text of one language sits in one file, `screen_manager/translations/<code>.json`, and docs/TRANSLATING.md walks through starting a new one, checking it with `tools/i18n.py check` (it measures the lines under a tile's name in the screens' own font) and sending it in. A language without a file falls back to English, with its own clock and number style.
- **What it costs.** The letters of the European languages are in the fonts of both boards. A CYD's firmware is FLASH_LINE
- **What it costs.** The letters of the European languages sit in the fonts of both boards, and one language's texts in the firmware: 48 KB on a CYD. Built with the ESPHome this add-on ships (2026.9.0) its firmware is 1,632,896 bytes, 89.0 % of its update slot (0.2.89: 1,585,136 bytes, 86.4 %); built with the oldest ESPHome the packages accept (2026.6.2), 1,657,808 bytes or 90.3 %. A Guition, with 16 MB of flash, stays around a quarter of its own. Both boards keep building with ESPHome 2026.6.2 or newer.
## 0.2.89 (firmware 0.2.75)