Localization (Dicts)
Some DVs include a dicts array that provides translations for static
text widgets. The active language is controlled by devcfg.ui.lang.
How it works
Section titled “How it works”- A static widget’s
valueis a key (e.g.,"system_config"), not the final displayed text. - The device looks up that key in the active language’s dictionary.
- The dictionary’s value replaces the widget’s value at render time.
Which DVs have dicts
Section titled “Which DVs have dicts”| DV | Languages | Keys translated |
|---|---|---|
syscfg | en, fr, de | system_config, lang, lock_enable, log_level, etc. |
sysctrl | en, fr, de | system_controls |
sysinfo | en, fr, de | system_sensors, system_versions, system_ids, YES/NO |
allocated_home | en only | orient values: FU, FD, UK, VU, VD, EU, ED → ALERT/OK |
Supported languages
Section titled “Supported languages”| Code | Language | Used in |
|---|---|---|
en | English | All dict‑enabled DVs |
fr | French | syscfg, sysctrl, sysinfo |
de | German | syscfg, sysctrl, sysinfo |
Setting the language
Section titled “Setting the language”The language is changed via the devcfg.ui.lang widget in syscfg.
The format is code:Label:Active (e.g., en:English:1,fr:Francais:0).
The 1 indicates the active language.
Related
Section titled “Related”- syscfg DV — where language is changed
- UI config (MQTT) — setting
devcfg.ui.langremotely