Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/CollapseLauncher/Collapse/llms.txt

Use this file to discover all available pages before exploring further.

Collapse Launcher ships with 17 built-in UI languages. Locale files are JSON documents stored in the Lang/ directory alongside the launcher executable. On first startup, the launcher automatically downloads the English fallback file (en_US.json) from the main GitHub repository if it is not already present.

​
Supported languages

Locale IDLanguageLocale file
en-USEnglishen_US.json
de-DEGermande_DE.json
es-419Spanish (Latin America)es_419.json
fr-FRFrenchfr_FR.json
id-IDIndonesianid_ID.json
it-ITItalianit_IT.json
ja-JPJapaneseja_JP.json
ko-KRKoreanko_KR.json
pl-PLPolishpl_PL.json
pt-BRPortuguese (Brazil)pt_BR.json
pt-PTPortuguese (Portugal)pt_PT.json
ru-RURussianru_RU.json
th-THThaith_TH.json
uk-UAUkrainianuk_UA.json
vi-VNVietnamesevi_VN.json
zh-CNChinese (Simplified)zh_CN.json
zh-TWChinese (Traditional)zh_TW.json
If the launcher detects a Windows system locale that does not exactly match a supported locale ID, it falls back to the closest match. For example, zh-HK and zh-MO fall back to Traditional Chinese (zh-TW), and most Portuguese variants fall back to pt-BR.

​
Changing the UI language

1

Open Settings

Click the gear icon in the bottom-left corner of the launcher window.
2

Find the Language selector

In the App Settings section, locate the App Language dropdown.
3

Select your language

Choose your preferred language from the list. The selection is saved immediately to the AppLanguage key in the config file.
4

Restart the launcher

A restart is required for the new language to take effect. The Settings page will display a warning banner until you restart.
The launcher stores your language selection as a locale ID (for example, ja-jp) in %USERPROFILE%\AppData\LocalLow\CollapseLauncher\config.ini under the AppLanguage key.

​
Language fallback behavior

The locale system resolves language IDs with the following priority:
  1. Exact match on the full locale ID (e.g., zh-TW).
  2. Partial match on the language subtag only (e.g., zh → zh-CN).
  3. Special-cased fallbacks for Traditional Chinese variants (zh-HK, zh-MO, zh-TW → zh-TW) and Portuguese Portugal (pt-PT).
  4. If all else fails, English (en-US) is used.
This means that if you configure a locale that does not exactly map to a supported language file, Collapse will still display a sensible language rather than falling back to blank strings.

​
Locale JSON file format

Each locale file is a UTF-8 JSON document. The top-level object contains a header and a set of section objects, each holding translated string keys. 
{
  "LanguageName": "English",
  "LanguageID": "en-US",
  "Author": "neon-nyan, CryoTechnic",

  "_SettingsPage": {
    "AppLangTitle": "App Language",
    "ThemeTitle": "Theme"
  },

  "_Misc": {
    "SizePrefixes1000U": "B|KB|MB|GB|TB|PB|EB|ZB|YB",
    "CDNDescription_Github": "The official (main) repository for the launcher."
  }
}
FieldDescription
LanguageNameHuman-readable name shown in the language selector.
LanguageIDBCP 47 locale tag used to match Windows system locale.
AuthorCredit string shown in the launcher logs when the locale loads.
Section objectsEach section (e.g., _SettingsPage, _MainPage) holds the strings for that part of the UI.

​
Size prefixes

The special _Misc.SizePrefixes1000U field defines the localized size suffixes used throughout the UI (download sizes, file sizes, etc.). It must contain exactly 9 entries separated by |, \, /, #, $, or ! characters. Example: 
"SizePrefixes1000U": "B|KB|MB|GB|TB|PB|EB|ZB|YB"
If this field has fewer than 9 entries, the launcher retains the previous suffixes.

​
Contributing translations

Collapse Launcher translations are managed on Transifex: https://explore.transifex.com/collapse-launcher/collapse-launcher/
If you want to add a new language or fix an existing translation, join the project on Transifex. The maintainers will periodically pull approved translations and update the JSON files in the repository.
If you prefer to contribute directly, you can open a pull request against the Hi3Helper.Core/Lang/ directory in the Collapse GitHub repository. Follow the existing JSON structure exactly, including section names and key names.

​
Adding a custom locale file

You can drop an additional .json file into the Lang/ directory next to the executable and it will appear in the language selector on the next launch. The file must include at minimum the LanguageName, LanguageID, and Author fields to be loaded correctly. Missing string keys fall back to their English equivalents from en_US.json.

Build docs developers (and LLMs) love

Get started for freeTalk to us