Skip to content

v0.3.0 — Multi-language + DeepL + LibreTranslate + Customizable Hotkeys

Pre-release
Pre-release

Choose a tag to compare

@hoangperry hoangperry released this 10 May 08:32

What's new in v0.3.0

Multi-language support

  • Pick any language pair. Replaced the hardcoded VI ↔ JP setup with TranslationStyle (direction + BCP47 target language + register). 30 curated languages in Settings dropdown (vi/ja/en/ko/zh/fr/de/es/...).
  • Persona refactor: formal register maps to keigo (JP), jondaemal (KR), vouvoiement (FR), polite English, etc. — the LLM picks per-language conventions from one shared Register enum.
  • My language picker in Settings: every inbound translation targets it; outbound uses it as source.

Customizable hotkey bindings

  • Unlimited outbound targets. Each (target language + register) pair gets its own configurable hotkey.
  • Default v0.2 layout preserved: ⌘⏎ = Japanese formal, ⌥⏎ = Japanese casual, ⌥D = inbound to Vietnamese.
  • Add/remove targets in Settings → Languages → Outbound translations. Hotkeys re-register automatically when you save.

2 new free providers

  • DeepL Free — top NMT quality for European + East Asian languages, free tier 500K chars/month. formality=more/less mapped to formal/casual register.
  • LibreTranslate — open-source MT, self-host via Docker for unlimited private use, or use the community instance.

App now ships 9 direct providers total: Gemini · Ollama · DeepL · LibreTranslate · Google Translate · OpenAI-compatible · Gemini CLI · Codex CLI · Mock.

v0.2.1 bug fixes bundled

  • Fixed double-HUD when preview opens (loading HUD now dismisses).
  • Fixed Cmd-V not working in Settings text fields (added Edit menu).
  • Fixed Codex/Gemini CLI not found from /Applications (extended PATH with /opt/homebrew/bin).

Tests

  • 150 Swift tests / 35 suites + 68 pytest = 218 GREEN (+28 from v0.2.0).
  • New coverage for DeepL, LibreTranslate, multi-binding persistence, hotkey display.

Upgrade notes

  • Existing v0.2 users: settings auto-migrate to vi/ja default with the same hotkeys. Open Settings → Languages to add more outbound targets or change your primary language.
  • Apple Silicon only (arm64). Ad-hoc signed; first launch may need right-click → Open.

Install

  1. Download Contextual-Mac-Translator-v0.3.0-macos-arm64.dmg.
  2. Open DMG → drag app to /Applications.
  3. Launch from /Applications, grant Accessibility.
  4. Open Settings, configure languages + provider, test hotkey.