Nederlands • English • Deutsch • Français

Translations

Show your S0tool in your own language. Pick a language file, add one line to Home Assistant and every sensor gets a name you can read. Nothing is re-flashed and nothing breaks.

How it works

The S0tool entities are named in Dutch by default, for example Actuele energie and Totaal opgebracht. The translation files change only the displayed name (friendly_name) in Home Assistant. The entity IDs stay the same.

Safe to use: your dashboards, utility meters, templates and the Energy dashboard keep working, because they use the entity IDs. The firmware is not touched, so you do not need to update or re-flash your S0tool.

Pick your language

Choose a language to get the exact line for your configuration.yaml and a preview of every name.

1. Add this to configuration.yaml

Copy the s0tool_translations folder to your Home Assistant config/ folder first (see Quick start below).

All languages (.zip)

2. Preview

Entity ID	Default	Your language

Quick start

Download the translations and copy the s0tool_translations folder to your Home Assistant config/ folder.
Add one language to your configuration.yaml:

homeassistant:
  customize: !include s0tool_translations/s0tool_eng.yaml

Restart Home Assistant, or run Developer tools → YAML → Reload customizations.

To switch language, use another file name. To go back to Dutch, remove the lines.

Download translations (.zip) View on GitHub

Available languages

Language	File
Nederlands (default names)	`s0tool_nl.yaml`
English	`s0tool_eng.yaml`
Deutsch	`s0tool_de.yaml`
Français	`s0tool_fr.yaml`

Each file translates the same 49 entities: the ESPHome sensors, the version sensors, the template sensors and the utility meters.

What it looks like

The entity ID is the same in every language. Only the name you see changes.

Entity ID	Nederlands	English	Deutsch	Français
`sensor.actuele_energie`	Actuele energie	Current power	Aktuelle Leistung	Puissance actuelle
`sensor.totaal_opgebracht`	Totaal opgebracht	Total energy	Gesamtenergie	Énergie totale
`sensor.actuele_meterstand`	Actuele meterstand	Current meter reading	Aktueller Zählerstand	Index du compteur actuel
`sensor.watermeter_totaal`	watermeter Totaal	Water meter total	Wasserzähler gesamt	Compteur d'eau total
`sensor.watermeter_stand`	watermeter stand	Water meter reading	Wasserzähler Stand	Index du compteur d'eau
`sensor.watermeter_flow`	watermeter flow	Water meter flow	Wasserzähler Durchfluss	Débit du compteur d'eau
`number.pulsrate_kwh`	Pulsrate kWh	Pulse rate kWh	Impulsrate kWh	Taux d'impulsions kWh
`select.pulsrate_water_per_m3`	Pulsrate water per m3	Pulse rate water per m3	Impulsrate Wasser pro m3	Taux d'impulsions eau par m3

Good to know

Only what you see in Home Assistant changes. The ESPHome web interface of the device (port 80) keeps its names.
Use one language file at a time. Already have a customize file? Copy the entries you want into it.
Entities that contain your device name in the ID (... online sinds, ... IP-adres, ... Mac-adres) are included as commented examples at the bottom of each file. Adjust them to your device name.
Some views in newer Home Assistant versions, such as the device page, show the entity's own name instead of friendly_name. Rename the entity under Settings → Entities in that case.

Add your language

Missing your language, or want a better translation? It is a small, friendly contribution:

Copy s0tool_eng.yaml to s0tool_<code>.yaml, for example s0tool_es.yaml.
Translate the friendly_name values. Do not change the entity IDs (the lines ending in :) or the icon lines.
Keep the first line in this format: # S0tool - Español (es).
Send a pull request. GitHub checks your file automatically and tells you what to fix.

That is all: this page and the download update themselves on the next site build.

Want to Learn More?

Check out the GitHub repository or join our community:

GitHub Repo Discord Contributing