Contributing Translations - Collapse Launcher

Collapse Launcher supports 17 languages. Translations are stored as JSON files in Hi3Helper.Core/Lang/ and are loaded at runtime — no recompile needed to test locale changes in a debug build.

Supported languages

Locale ID	Language	File
`en_US`	English	`en_US.json`
`de_DE`	German	`de_DE.json`
`es_419`	Spanish (Latin America)	`es_419.json`
`fr_FR`	French	`fr_FR.json`
`id_ID`	Indonesian	`id_ID.json`
`it_IT`	Italian	`it_IT.json`
`ja_JP`	Japanese	`ja_JP.json`
`ko_KR`	Korean	`ko_KR.json`
`pl_PL`	Polish	`pl_PL.json`
`pt_BR`	Portuguese (Brazil)	`pt_BR.json`
`pt_PT`	Portuguese (Portugal)	`pt_PT.json`
`ru_RU`	Russian	`ru_RU.json`
`th_TH`	Thai	`th_TH.json`
`uk_UA`	Ukrainian	`uk_UA.json`
`vi_VN`	Vietnamese	`vi_VN.json`
`zh_CN`	Simplified Chinese	`zh_CN.json`
`zh_TW`	Traditional Chinese	`zh_TW.json`

How to contribute

Via Transifex (recommended)
Via Pull Request

Join the project

Go to Collapse on Transifex and request to join as a translator for your language.

Translate strings

Use the Transifex web editor to translate or proofread strings. The source language is English (en_US).

Submit for review

Translations are reviewed by maintainers before being merged. You’ll be notified of feedback through Transifex.

To add a language that isn’t yet listed in the Transifex project, open a GitHub issue or create a discussion on Transifex. Maintainers will add the new language resource.

Copy an existing locale file

Copy en_US.json from Hi3Helper.Core/Lang/ as your starting point and rename it to your locale ID (e.g., nl_NL.json).

Translate all strings

Replace all English values with your translations. Keep JSON keys unchanged.

Add your locale to the locale registry in the source (check Locale.cs in Hi3Helper.Core for the registration pattern).

Open a pull request

Submit your PR to the main branch on GitHub with a clear description of the language being added.

Locale file format

Each locale file is a UTF-8 JSON document. The top-level object has three metadata fields followed by section objects for each part of the UI:

en_US.json (excerpt)

{
  "LanguageName": "English",
  "LanguageID": "en-US",
  "Author": "neon-nyan, CryoTechnic",

  "_StartupPage": {
    "SelectLang": "Select your language"
  },
  "_Misc": {
    "SizePrefixes1000U": "B|KB|MB|GB|TB|PB|EB|ZB|YB"
  }
}

Field	Description
`LanguageName`	Human-readable name shown in the language selector.
`LanguageID`	BCP 47 locale tag (hyphen-separated, e.g. `en-US`, `zh-TW`).
`Author`	Credit string logged when the locale loads.

Size prefix strings (_Misc.SizePrefixes1000U) must contain exactly 9 entries separated by |. Do not change the separator or order.

Testing your translation

In a debug build of Collapse, locale files are hot-reloaded. Change the language in Settings → App Language, and the UI will update without restarting the launcher. This makes it easy to check your translations in context.

Contributing

Documentation Index

​Supported languages

​How to contribute

​Locale file format

​Testing your translation

Build docs developers (and LLMs) love

Supported languages

How to contribute

Locale file format

Testing your translation