ManagerI18n

homey.manager.i18n

Manages internationalization in the app. You can access this manager through the Homey instance as self.homey.i18n.

Methods

def get_strings(self) ‑> dict[str, Translations]

Get the locale manifest for the language the Homey uses.

def translate(self, key: str, **tags: str) ‑> str | None

Translate a string, as defined in the app's /locales/<language>.json file.

Example:

/locales/en.json

{ "welcome": "Welcome, __name__!" }

/app.py

welcome_message = self.homey.i18n.translate("welcome", name="Dave")
self.log(welcome_message)

Name	Type	Description
`key`	str	The key in the `<language.json>` file, with dots separating nesting. For example `"errors.missing"`.
`tags`	str	A keyword mapping of tags in the string to replace. For example, for `Hello, __name__!` you could pass `name="Dave"`.

The translated string, or None if the key was not found.

def get_language(self) ‑> str

Get the language the Homey uses.

A 2-character language code.

def get_units(self) ‑> Literal['metric', 'imperial']

Get the units the Homey uses.