Switch Cavalry 2.7.2 on macOS and Windows between English, Simplified Chinese, Traditional Chinese, and Japanese.
- One-step language switching: Quit Cavalry, choose a language, and select Switch. Cavalry opens automatically when the change is complete.
- Four UI languages: English, Simplified Chinese, Traditional Chinese, and Japanese.
- Two platforms: Cavalry 2.7.2 on macOS and Windows x64.
- Complete UI coverage: Translates JSON assets and text compiled into Cavalry's Qt interface.
- Automatic discovery and recovery: Finds common installations, keeps the current language visible, and prepares the files needed to restore English.
- Built-in updates: Notifies you when a later Switcher version is available and verifies it before installation.
Choose a target language, then select Switch or Restore English. When the current language has an update badge, select it and choose Update to reapply the complete language patch—no language change or English restore is needed first. The current language is disabled only when its patch is up to date. Progress and recovery guidance appear below the actions.
Add Layer search in released p8: You can search in English or the selected language. In the right-hand Add Layer panel, localized title matches may not receive the same title priority as English names. If the expected layer appears lower in the results, try its full English name, such as Text Shape. This is a known ranking limitation; it does not mean your input or the layer's creation identity has changed.
Development branch (not yet released): Exact selected-language title matches and eligible title-prefix matches in the right-hand panel receive a title-priority supplement on verified runtimes. Matches elsewhere in a title can still appear in search results with native ranking. Native filtering and layer creation remain unchanged; unverified runtimes retain native ranking. Windows live acceptance is still required before release.
Cavalry Language Switcher is an independent community tool. It is not made by, endorsed by, or affiliated with Scene Group, Cavalry, or Canva.
The Switcher modifies the local Cavalry installation. If the version is unsupported, the installation cannot be verified, or a write is denied, the new language is not applied.
On macOS, it tries the change directly and opens System Settings → Privacy & Security → App Management only after macOS actually denies the write. Grant access only if you trust the build; macOS may ask you to reopen the Switcher before trying again. The changed Cavalry.app is locally re-signed so it can launch.
On Windows, writable custom locations are handled directly. UAC elevation is limited to Cavalry installations under the system Program Files directories. Unknown DLLs are never deleted or replaced.
Restore English returns Cavalry to English; it does not promise that every older modified installation becomes byte-for-byte identical to a fresh vendor install. To recover a completely untouched official installation, reinstall Cavalry 2.7.2 from the official installer.
Download the matching installer from GitHub Releases: Apple M DMG, Intel DMG, or Windows x64 NSIS.
The macOS build is ad-hoc signed and not Apple-notarized. If macOS blocks the first launch after you drag the app into Applications, run:
xattr -dr com.apple.quarantine "/Applications/Cavalry Language Switcher.app"
codesign --force --deep --sign - "/Applications/Cavalry Language Switcher.app"
open "/Applications/Cavalry Language Switcher.app"An app update installs a new app bundle, so macOS may require the same steps again. The Windows installer is not Authenticode-signed and may show an unknown-publisher warning; confirm that it came from this project's GitHub Release.
Source builds follow LOCAL_BUILD_SOP.md.
npm install
npm run tauri:dev # Run from source
npm run build:tauri # Build macOS DMG
npm run build:tauri:windows # Build Windows NSIS on WindowsUse the repository's pinned Node, Rust, Qt, Python, and Windows CMake toolchain. Platform prerequisites and packaged checks are defined in LOCAL_BUILD_SOP.md.
- Detect a Cavalry 2.7.2 installation, or let the user choose one on Windows.
- Validate the installation and save or reuse the files required to restore English.
- Apply the selected JSON assets and platform runtime translator.
- Commit the language marker last; macOS then re-signs the changed app bundle.
- Open Cavalry in the selected language.
The original Cavalry launch path remains unchanged. Restore English runs the same managed transaction in reverse and removes only files that the Switcher can prove it owns.
| Language | Code |
|---|---|
| English | en |
| 简体中文 | zh-Hans |
| 繁體中文 | zh-Hant |
| 日本語 | ja_JP |
npm run test:contracts # Renderer, bridge, release, and packaging contracts
npm run test:tauri # Rust tests
npm run check:app # JavaScript syntax
npm run build:injector # macOS Qt injector
npm run build:injector:windows # Windows translator and QPA delegateQt 6.6.3 must match Cavalry 2.7.2. Do not build release packages from floating dependencies; use LOCAL_BUILD_SOP.md.
Before changing code, read AGENTS.md, CLAUDE.md, and the nearest module-level CLAUDE.md. These files define the architecture map, ownership boundaries, commands, and documentation protocol.
The project translates two surfaces:
- JSON assets in
languages/, kept structurally aligned with the English baseline. - Compiled Qt/UI text from
tools/*.tsandtools/model_display_translations.json, embedded into the platform runtime translator.
Generated translations live in injector/generated_translations.inc and must not be edited by hand. Translation rules and live verification are documented in docs/translation-guidelines.md and docs/runtime-ui-live-capture-workflow.md.
Cavalry-i18n/
├── renderer/ # Tauri WebView UI
├── src-tauri/ # Rust commands and platform transactions
├── injector/ # macOS and Windows Qt runtime translators
├── languages/ # English baseline and three translated JSON packs
├── tools/ # Build, validation, and release tooling
├── docs/ # Public rules, repeatable SOPs, and images
└── .github/workflows/ # CI, platform packaging, and Release publication
| Job | Purpose |
|---|---|
build |
Syntax, contracts, and translation validation |
windows_check |
Windows translator, Rust, NSIS lifecycle, and updater package |
package_macos |
Apple Silicon and Intel Tauri packages with packaged checks |
release |
Signed updater manifest plus seven exact-readback public assets for cavalry-*-p* tags |
- If Cavalry-i18n helped you, share it with friends or give it a star.
- Got ideas or bugs? Open an issue or PR, feel free to contribute your best AI model.
MIT License. Feel free to use Cavalry-i18n and contribute.