Skip to content

Localization

Jump to bottom
tempus2016 edited this page May 4, 2026 · 2 revisions

TaskMate supports multiple languages for both the configuration UI and the Lovelace dashboard cards.

Supported Languages

Language Code Coverage
English (GB) en-GB Full (default fallback)
English (US) en Full
French fr Full
German de Full
Norwegian Bokmål nb Full
Norwegian Nynorsk nn Full
Portuguese pt Full
Portuguese (Brazil) pt-BR Full

How It Works

TaskMate automatically uses your Home Assistant language setting. There is no separate language option within TaskMate itself.

Changing Language

  1. Go to your HA Profile (click your user icon in the sidebar)
  2. Change Language to your preferred language
  3. Refresh the page — all TaskMate cards and configuration screens will update

What Gets Translated

  • Config flow — all setup screens, field labels, descriptions, and menu items
  • Dashboard cards — all card titles, button labels, status messages, empty states, and tooltips
  • Admin panel — all management screens, forms, and labels (v3.6.2+)
  • Service descriptions — shown in Developer Tools when browsing services

What Does Not Get Translated

  • Your data — child names, chore names, reward names, and descriptions are entered by you and displayed as-is
  • Points currency name — this is set by you during setup (e.g. "Stars", "Coins") and is not translated

Contributing Translations

Translation files are located in the repository:

  • Config flow: custom_components/taskmate/translations/{locale}.json
  • Frontend cards: custom_components/taskmate/www/locales/{locale}.json

To add a new language or improve an existing translation, submit a pull request to the TaskMate repository.

Related

Clone this wiki locally