Localization
TaskMate supports multiple languages for both the configuration UI and the Lovelace dashboard cards.
| Language | Code | Coverage |
|---|---|---|
| English (GB) | en-GB |
Full (default fallback) |
| English (US) | en |
Full |
| Danish | da |
Full (new in v6.0.0, contributed and reviewed by a native speaker) |
| French | fr |
Full |
| German | de |
Full |
| Norwegian Bokmål | nb |
Full |
| Norwegian Nynorsk | nn |
Full |
| Portuguese | pt |
Full |
| Portuguese (Brazil) | pt-BR |
Full |
TaskMate automatically uses your Home Assistant language setting. There is no separate language option within TaskMate itself.
- Go to your HA Profile (click your user icon in the sidebar)
- Change Language to your preferred language
- That's it. Since v6.0.0 the cards and the admin panel switch language (and direction) straight away, with no page reload
Card titles follow your language (v6.0.0). The points, approvals, parent dashboard, reorder and rewards cards used to save an English default title ("Manage Points", "Rewards", …) into your dashboard. A title that matches the old English default is now treated as unset, so it shows in your language. Titles you typed yourself are kept exactly as you wrote them.
- 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
- 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
Every TaskMate card and the admin panel lay out right-to-left when Home Assistant is set to a right-to-left language such as Arabic, Hebrew, Persian or Urdu, and follow Home Assistant's own direction otherwise. There is nothing to configure.
- Text, spacing, borders and progress bars run from the right; directional icons (chevrons, undo, send) are mirrored
- Counts and number runs keep their reading order, so "3 / 5", "3-day streak" and "0 of 6 done" read correctly inside right-to-left text
- Progress rings and the points graph's time axis stay as drawn, so time still runs left to right on the graph
TaskMate doesn't ship Arabic, Hebrew, Persian or Urdu translations yet, so those languages show the layout right-to-left with English wording. The layout is ready for a translation — see below if you'd like to contribute one.
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.
- Installation — initial setup
- Getting Started — first-time configuration