Installation
How to install Beyond Translate on your Mac.
The official website currently offers the native macOS beta through Apple TestFlight. Mac App Store and standalone DMG channels are listed as coming soon on the download page.
- Install Apple’s TestFlight app from the Mac App Store.
- Open the public Beyond Translate invitation from the download page, and accept it in TestFlight.
- Install and update Beyond Translate through TestFlight, following the system requirements shown there.
Launch the app after installation. The native macOS app shows a setup guide on first launch and opens the main window after setup. Open the mini translator separately from the menu bar, tray menu, or its configured global shortcut.
Configuration
Connect a provider and choose translation and OCR services.
Providers store connection details such as an API key and server address. Services choose what to run through a provider, such as a translation or OCR model. Entering credentials alone does not choose your default translation service.
- Open Settings → Services and add a translation service. Choose a provider, enter the required connection details, test the connection, and select a model when prompted.
- Save the service, enable it in the available-services list, and set the service you want to use by default. Saved provider connections can be managed in Settings → Providers.
- Configure translation targets and common languages in Settings → Services. Select a default OCR service there if you want to recognize text from screenshots or images.
- System translation on macOS — No third-party API key is needed. The current integration requires macOS 26 or later and installed language files for the language pair you use.
- AI translation (BYOK) — The native macOS app offers OpenAI, Anthropic (Claude), Google Gemini, DeepSeek, Qwen, Kimi (Moonshot AI), Zhipu AI, Doubao, SiliconFlow, and custom OpenAI-compatible endpoints (including self-hosted vLLM, SGLang, or Ollama servers). Cloud providers require their own account and API key.
- On-device local models on macOS — Choose a supported Hy-MT2 or Gemma 3 model under Local models → Manage downloads. Hy-MT2 1.8B Q4 (~1.13 GB, requires at least 4 GiB RAM) and 7B Q4 (~4.62 GB, requires at least 8 GiB RAM) support resumable, pinned SHA256-verified downloads and run locally on your Mac with no API key.
- Screenshot & image OCR — Use macOS built-in OCR or download offline PaddleOCR (PP-OCRv6 Small) from provider settings for local multilingual text recognition before translation.
The service list depends on the app version. Traditional translation providers such as Baidu, DeepL, and Google Cloud, along with standalone dictionary and read-aloud interfaces, are currently unavailable in the native macOS interface. Check the service list in your installed version.
Cloud translation sends the submitted text to the selected provider and may incur provider charges. Local models and offline PaddleOCR require an initial file download; they run inference locally without a cloud API key.
Usage
Capture text and translate using different methods.
Depending on your platform and app version, you can get text into the translator in the following ways:
- Selected text — Select copyable text in another app, then use the screen-selection shortcut. Apps that prevent copying may not support this method.
- Screenshot OCR — Use the screen-capture shortcut, then select a region. The default OCR service recognizes the text before translation.
- Clipboard — Copy text, then use the clipboard-extraction shortcut. In versions that support clipboard images, an image is passed to the default OCR service.
- Input — Type or paste text into the main window or mini translator, then submit it using the configured submit key or translation button.
In automatic mode, the app detects the source language and matches your enabled translation targets. You can also select languages manually. The default translation service supplies the preferred result; use comparison to request results from other enabled services. Response time depends on the service, network, and model.
Use the copy button beside a translation result to copy it. Double-click copying depends on the version and its settings. Captured text normally opens in the mini translator; the native macOS app lets you change the destination in Settings → Services, under the OCR capture behavior options.
Keyboard Shortcuts
Configure global hotkeys for faster workflows.
Configure global shortcuts in Settings → Shortcuts while the app is running. The native macOS defaults use Option (⌥); other platforms may display this modifier as Alt. Your saved bindings are shown in settings.
Available hotkey actions include:
- Show or hide mini translator — Option+1 on macOS
- Extract selected text — Option+Q on macOS
- Capture screen text with OCR — Option+W on macOS
- Extract from clipboard — Option+E on macOS
Submitting typed text is an in-app action, separate from global shortcuts. In the native macOS app, Settings → Shortcuts lets you choose Enter or Command+Enter to submit. If a global shortcut is already used by the system or another app, choose a different combination.
Troubleshooting
Common issues and how to resolve them.
If translation fails, check that a translation service is enabled and selected as the default, that its model and language pair are supported, and that any required credentials are valid. Cloud services also need network access and sufficient provider quota. For local models, make sure the model download has finished.
On macOS, selected-text extraction requires Accessibility permission, and screenshot extraction requires Screen Recording permission. Enable Beyond Translate under System Settings → Privacy & Security in the corresponding permission panes. Newer macOS versions may label the latter Screen & System Audio Recording. Quit and reopen the app after changing screen-recording access, then check permissions again.
If system translation reports missing language files on macOS, install the source and target languages in System Settings → General → Language & Region → Translation Languages before retrying. If the language pair or system version is unsupported, choose another translation service.
If a problem persists, report it through the support page with your app version, operating system, steps to reproduce, and the displayed error. Remove API keys and private text from screenshots or logs before sharing them.
Need more help?
Find frequently asked questions and contact options on the support page.