{ "meta": { "title": "Change Language | ProxMenux Documentation", "description": "Switch ProxMenux UI between English, Spanish, French, German, Italian or Portuguese. Translation install only — uses googletrans + a pre-cached translation table. The menu reloads automatically with the new language.", "ogTitle": "Change Language | ProxMenux Documentation", "ogDescription": "Pick the ProxMenux interface language from the Settings menu. Six languages supported." }, "header": { "title": "Change Language", "description": "Switch the ProxMenux UI between six supported languages. Saves the choice to config.json and re-execs the menu with the new language. Only available on the Translation install type — the Normal (lightweight) install is English-only by design.", "section": "Settings" }, "intro": { "title": "What this is", "body": "A dialog menu that lists the six supported languages. Pick one, ProxMenux saves it to config.json as .language, then re-execs config_menu.sh so the new language takes effect immediately." }, "warn": { "title": "Translation install only", "body": "This option only appears in Settings if both checks pass: /opt/googletrans-env/bin/activate exists (Python venv with googletrans), and config.json has a non-empty .language. On the Normal (English-only) install neither is present and the language picker is not shown." }, "supported": { "heading": "Supported languages", "headerCode": "Code", "headerLang": "Language", "headerNotes": "Notes", "rows": [ { "code": "en", "lang": "English", "notes": "Source language — most accurate" }, { "code": "es", "lang": "Spanish", "notes": "Cached + auto-translated" }, { "code": "fr", "lang": "French", "notes": "Cached + auto-translated" }, { "code": "de", "lang": "German", "notes": "Cached + auto-translated" }, { "code": "it", "lang": "Italian", "notes": "Cached + auto-translated" }, { "code": "pt", "lang": "Portuguese", "notes": "Cached + auto-translated" } ] }, "englishTip": { "title": "English is the most accurate", "body": "Non-English strings are produced by a pre-cached table seeded from googletrans. Edge-case strings (rarely triggered options, recent additions) may fall through to a live googletrans call or to the English original. If a translation feels off, English is always the source of truth." }, "underHood": { "heading": "How it works under the hood", "items": [ "Dialog menu lists the 6 codes; you pick one.", "If config.json exists: jq --arg lang \"$new_language\" '.language = $lang' updates the field in place.", "If config.json doesn't exist: a fresh one is created with the language code in a single-field object.", "Confirmation dialog: \"Language changed to <code>\".", "exec bash config_menu.sh reloads the Settings menu with the new language active." ] }, "manual": { "heading": "Manual equivalent" }, "troubleshoot": { "heading": "Troubleshooting", "noOptionTitle": "Option doesn't appear in Settings", "noOptionBody": "You're on the Normal (English-only) install. To get language support, reinstall ProxMenux choosing the Translation install option (it pulls Python venv + googletrans).", "stillEnglishTitle": "Language changed but UI still shows English", "stillEnglishBody": "The menu re-execs itself after the change. If you opened a fresh shell and started a different ProxMenux entrypoint, run menu again to pick up the new language. Confirm: jq -r '.language' /usr/local/share/proxmenux/config.json." }, "related": { "heading": "Related", "items": [ { "href": "/docs/settings/show-version-information", "label": "Show Version Information", "tail": " — confirms install type and current language." }, { "href": "/docs/settings", "label": "Settings overview", "tail": "." } ] } }