Help translating HABPanel in your language!

Hi all,

Continuing this effort, I am very pleased to let you know HABPanel is now fully localizable and it will use the setting you configure in Paper UI (Configuration > System > Regional Settings) to display dates, numbers and even text in your language!

The only thing left is to actually translate it :wink:
That’s where you, the community, will be able to help!

If you’re a native speaker or even fluent in another language than English or French (you’re in luck, I already took care of that one :smile:) and were looking to contribute something other than code to the project, you can now step up and join the crowdin project at:

Click on your language, and choose which part of the project you’d like to help translate by clicking on one of the 3 files:

  1. main.pot contains common terms across the application, as well as the new device tutorial and text displayed on end-user, non-administration screens: dashboards, main menu.
    It currently contains only 40 strings and is the bare minimum to start a new language. You’re invited to begin with this one!

  2. admin.pot contains all the text in the administration screens minus the widgets settings: dashboard designer, general settings, widget gallery, custom widget list and designer, etc.
    It contains 183 strings to translate.

  3. widgets.pot contains all the text in the widgets’ settings dialog boxes. Some are common to several widgets (widget.common…) and others are for a specific widget (widget.button…).
    It contains 228 strings to translate.

It’s not mandatory to have a language completely translated for it to be included, main.pot is enough (but the more, the better :slightly_smiling_face:). Parts not translated will simply remain in English. All translations can then be upvoted and downvoted by other members and will be eventually approved. Approved translations will then end up in HABPanel.

A few things to keep in mind when translating:

  • The “context” will be displayed in the crowdin interface, most will include a small description about where the string would be found in the interface. Some will even have screenshots as we make and upload them. Indeed, some text like error strings are not easily or rarely shown.

  • HABPanel is designed to be usable even on phones, where screen estate is limited, so when translating, if you can, please use the Chrome developer tools (right-click text and click Inspect), click on this small icon: image then verify how it looks when you select for instance “iPhone 7” or “Nexus 6P” in the toolbar above the page! This is absolutely not mandatory but I’d appreciate it.
    You can also double-click on the text in the code (or right-click and choose Edit text) and replace it with your translation.

Looking forward to your help! :heart_eyes:
Also be sure to help translating other openHAB projects on crowdin!


I also want to point out, especially for the most popular languages: if a file is already translated, or even partly “approved” (blue and green bars), this doesn’t mean you can’t participate: you can help a lot too by using the menu on the right to open the file in “voting mode”:


This will open a different interface more focused on voting for or against a translation. Just click on the + or - alongside each one to vote, or edit it directly, and you can discuss on the right too. I’m the only approver now, but I have no clue in most languages in the list, so apart from trusting the first suggestion, I’m hoping to be able to count on confirmation votes too :slight_smile:

Regular contributors and voters for a language will also be given proofreading rights, so they will be able to approve translations directly.

Lastly, if you spot an error after something has been approved, even if it’s already in the application, it doesn’t mean it’s too late!

1 Like

Finnish translation for HABPanel waits for approval and maybe some modifications. Also viewed and translated other projects. Think iOS app is the only one left. (Shouting out to get this done :wink: )

1 Like

…And the first language in which HABPanel was completely translated by the community is: Turkish :tr: :clap:

Kudos to user @harundemirel from Crowdin who translated the whole thing in one sitting, and @hakan for proofreading and the final approval!

Team Germany :de: had a great start on the first day but stalled for a while, there is still some debate over minor issues but a great coalition was formed and it’s now back to full speed (not even apologizing for this questionable joke :)), closing in at 98% :checkered_flag: There have been a few useful votes too, so proofreading should be straightforward. Expect it to be merged in no time!

Polish :poland: (86%) and Finnish :finland: (80%), led by @kubawolanin and @gitMiguel respectively, are battling for third place :wink:
Since I have absolutely no knowledge of either language, I’ll give proofreading rights to you and the other translators so you can validate your (or better, other’s) work!

Next is Indonesian :indonesia: (67%) with an out-of-the-blue contribution from user @rizkythamrin at Crowdin.

Dutch :netherlands:, Italian :it: and Norwegian :norway: are at 15% each, the former two having main.pot translated and awaiting votes and approval.

Finally, Spanish :es: and Russian :ru: are now in the race with 38 and 25 words translated, respectively.

Huge thanks to all for your time, there was amazing progress in only 48 hours! Looking forward to the next days! (I have updated the picture in the first post with the current status).


Looks like Poland surpassed Germany and Finland this time :smile:


Awesome progress yesterday!

HABPanel is now available in 6 languages (including English) with 3 new ones merged just now:

  • Finnish :finland: :star2:
  • French :fr:
  • German :de: :star2:
  • Polish :poland: :star2:
  • Turkish :tr:

Looking at the activity of the last day, Spanish :es:, Portuguese :portugal: and Italian :it: might be next, with Dutch :netherlands: and Russian :ru: on the way as well :slight_smile: Keep up the good work!

The new languages will be available in the next snapshot build, or you can clone the Git repository (or download a ZIP and extract) into your conf/html folder and use http://openhab:8080/static/org.openhab.ui.habpanel/web/ to check it out now.
Set your language in Paper UI.

If you encounter a translation that needs to be improved while using HABPanel, you can always suggest a new one at Crowdin - even over a already validated one. If it’s approved it will replace the existing translation on the next merge.

Thanks everyone!


I cloned the repo to test Finnish translation and noticed that there are parts that are not translated. Can’t remember any similar words while translating. These are in advanced settings tab under dashboard configuration.

Right, I didn’t do this part, the reason being that these options are supposed to be experimental and likely to change (they really aren’t…) and I was lazy (I really was) :slight_smile:

I added something in French along the lines of “These options are deliberately not translated” in the warning text above.

When some other new strings to translate are added I’ll include those as well.

I have completed a preliminary swedish translation, but would be glad if other swedes in the community could double-check it!

1 Like

Awesome :sunglasses:
Looks like you will have to validate your own work @pacive :wink: (others can still vote)

Update after a little more than one week :slight_smile:

New languages

Portuguese :portugal: has been merged!

Languages pending validation

Proofreaders are still needed for:

  • Chinese :cn: - 100% translated, 0% validated
  • Danish :denmark: - 93% translated, 0% validated
  • Spanish :es: - 63% translated (main.pot and admin.pot), 0% validated
  • Swedish :sweden: - 100% translated, 41% validated

If you’re willing to join the effort, just tell me and I’ll give you proofreading rights.

Languages with significant progress

These languages are in very good shape already but need at least main.pot and admin.pot completely translated before the proofreading phase can begin:

Progress reports

Huge thanks to all!

1 Like

Someone for Romanian? to validate and suggestions

1 Like

Time for the weekly update :slight_smile:

New languages

Italian :it: has been merged! Thanks and congratulations!

Languages pending validation

Proofreaders are still needed for:

  • Chinese :cn: - 100% translated, 0% validated; no change since last week, maybe I’ll auto-approve it…
  • Danish :denmark: - 100% translated, 9% validated
  • Spanish :es: - 85% translated (almost done!), 0% validated
  • Swedish :sweden: - 100% translated, 71% validated; it’s getting there!

Languages with significant progress

  • Dutch :netherlands: is now 42% translated
  • Indonesian :indonesia: still stuck at 67% but none of the files are complete
  • Romanian :romania: is now at 36% thanks to @4digital and another contributor @simypo - keep it up!
  • Russian :ru: had a small increase to 28%

Finally, work on Bulgarian :bulgaria:, Korean :kr:; Norwegian :norway: and Ukrainian :ukraine: has begun but still in need of translators :wink:

After only 2 weeks, 44 users have made contributions in 19 languages, and HABPanel is already completely translated in 11 languages (including English and languages not completely validated). Awesome!

Feel free to ask should you require anything: proofreading rights, new language not in the list… Looking forward to next week :grinning:

i finished spanish translator, some can validate it?.


1 Like

OK, Czech translation is finished, anybody for check&approval?

Pojďme hoši :wink:


1 Like

It’s been 1 month since the initial announcement, so time for an update!

HABPanel is available in 8 languages including English, but there could be 5 more:

If you’re willing to help approving Chinese :cn:, Czech :czech_republic:, Danish :denmark:, Spanish :es: or Swedish :sweden: and don’t have proofreading rights please chime in! It’s a shame the translation work is finished for these and they aren’t merged yet. (@FrankCZ and @DarioBonello feel free to proofread your own work ;))

There has been significant progress in Dutch :netherlands:, Romanian :romania:, Russian :ru: and Ukrainian :ukraine: which are well on their way to completion, between 65% and 80% is already translated:

Notable as well is the addition of Tagalog :philippines: following a request of a contributor.

As always all contributions in any language are welcome and appreciated, and feel free to ask if there’s anything we can make easier.
Thank you very much!

@ysc Ok, can you give me proofreading rights? Thanks! And I saw many more parts of OPENHAB project (Android / IOS mobile app etc.) available for translation… shall / may be these translated too? I think it is good idea to do them all together due to consistency…

1 Like

I jumped on to this, finished greek translations.

1 Like

@FrankCZ and @ngalfas, you’re now proofreaders for Czech and Greek respectively - a big thank you in advance :wink:

And I saw many more parts of OPENHAB project (Android / IOS mobile app etc.) available for translation…shall / may be these translated too? I think it is good idea to do them all together due to consistency…

Yes, you’re welcome to join the effort for all openHAB apps, each has its own workflow and frequency for integrating the translations into the software, it depends on what the app’s maintainer has decided. I’m not myself a manager of these other Crowdin projects though, @ThomDietrich is.