Honyaku User Guide
From the first permissions to how to translate, the settings, and what to check when something goes wrong. The installation steps are on the download page.
App interface: Japanese. Japanese labels are shown in parentheses, for example Settings (設定).
Getting started
Honyaku is a menu bar app that translates text you select in other apps. No window opens when you launch it; a speech-bubble icon appears in the menu bar at the top of the screen.
Look for the speech-bubble icon in the menu bar.

Click the menu bar icon to open this menu.
- Translate selected text (選択した文章を翻訳) (⌥⇧T): translates the text you have selected now.
- Translate a screen area (画面の範囲を翻訳): box an area of the screen and translate the text inside it. You can draw the box without holding a key.
- Open translation window (翻訳ウインドウを開く): opens the last translation window again.
- Settings… (設定…): check the language pair, the drop area, translating by boxing the screen, the permission status and updates (also opens with ⌘,).
- Check for Updates… (アップデートを確認…): checks right away whether a new version exists.
- Quit (終了): quits Honyaku. Closing the translation window keeps it in the menu bar until you quit.
Allow Accessibility
To read the text you select in other apps and replace it with the translation, Honyaku needs the macOS “Accessibility” permission.
- Open Settings… (設定…) from the menu bar icon.
- In the Accessibility (アクセシビリティ) section, press Request access (アクセス許可をリクエスト).
- On the macOS confirmation screen, press “Open System Settings” and turn on “Honyaku” in the Privacy & Security → Accessibility list.
- When you return to Honyaku’s Settings window, the status changes to Allowed (許可済み) (it is checked automatically every second).
If you press ⌥⇧T without the permission, the translation window shows Accessibility permission is required (アクセシビリティの許可が必要です) and a button that opens the settings.
Allow Screen Recording (when you translate by boxing the screen)
The macOS “Screen Recording” permission is needed only when you use translate by boxing the screen. If you don’t use it, you can skip this permission and all other features still work.
- Open Settings… (設定…) from the menu bar icon.
- In the Translate by boxing the screen (画面を囲んで翻訳) section, press Request Screen Recording permission (画面収録の許可をリクエスト).
- Turn on “Honyaku” in the Privacy & Security → Screen & System Audio Recording list. To open the list, press Check Screen Recording in System Settings (システム設定で画面収録を確認).
- If macOS asks you to “Quit & Reopen”, open Honyaku again. When Settings shows Screen Recording: Allowed (画面収録:許可済み), you are ready.
Only the part you boxed is captured, at the moment you confirm the area. The image is neither saved nor sent.
Basics
Translate with ⌥⇧T
- In another app, select the text you want to translate.
- Press Option + Shift + T (⌥⇧T). Translate selected text (選択した文章を翻訳) in the menu bar does the same.
- The translation window opens and shows the translation.
For a language you use for the first time, macOS may show a screen asking you to confirm downloading the language data. Translation starts when the download finishes.
Translate by dragging
- Select the text.
- Press and hold the selected text for a moment, then move it to start dragging.
- A “Drop here to translate” (ここにドロップして翻訳) area appears near the selected text (above it by default).
- Release inside the area, and the translation window opens above it and shows the translation.
- The area doesn’t appear while you are only dragging across text to select it. It disappears when you stop dragging.
- Only text (including formatted text) can be dropped on the area. Files and images can’t be translated.
- In apps where text can’t be dragged, use ⌥⇧T.
- When you translate by dragging, Replace (置き換え) is available only if the dropped text is the same as the original selection.
Translate by boxing the screen
This translates text you can’t select as text, such as text in images, video subtitles, and the labels of buttons and menus. You first need the Screen Recording permission.
- Hold down F1. The screen dims slightly and a hint, Box an area and release (範囲を囲んで離す), appears at the top.
- While holding F1, drag with the mouse to draw a box around the part you want to translate.
- When you release the mouse button, the area is set; the text in it is read and translated into the other language of the language pair. Once the area is set, you can let go of F1.
- The translation window opens near the area you boxed.
- To cancel before the area is set, let go of F1, press Esc or right-click. Areas that are too small are not captured.
- Small text mode: press F2 once while drawing the box and then release the mouse; for that one time, the area is magnified internally up to 3 times before it is read. Check that the hint changes to Small text mode (小さい文字モード) (if the key you hold is set to F2, switch with F1).
- When you start from Translate a screen area (画面の範囲を翻訳) in the menu bar, you can draw the box without holding a key.
- The key you hold can be chosen from F1–F8 in Settings. You can also turn off only starting with the key.
- You can box only within the display where the pointer is when you start. Horizontal text is read line by line. Multi-column layouts, vertical text and very small text may not be read correctly. To check the text that was read, open Source (原文) in the translation window.
- A translation read from the screen has no original location, so Replace (置き換え) can’t be used. Copy (コピー) works.
- While you are selecting an area, the drag area doesn’t appear. It returns to normal when you finish.
› 原文英語(アメリカ) → 日本語 ⇄
翻訳が完了しました
The translation window
- × button: hides the window. The Esc key also hides it.
- Language pair: the two languages to translate between. Changing it translates the same source again and also saves it to Settings.
- Source (原文): click to expand it and show the source text and the Source language (原文の言語). If automatic detection is wrong, choose the language here to translate again. For the next text, automatic detection is used again.
- Reverse button (⇄): next to the translation direction, such as English → Japanese (英語 → 日本語). Press it to translate the same source again in the opposite direction.
- Gear: opens Settings.
- Retranslate (再翻訳): translates the same source again. While translating, Cancel (キャンセル) also appears.
- Copy (コピー): puts the translation on the clipboard. If you select part of the translation with the mouse before pressing it, only the selected part is copied.
- Replace (置き換え): rewrites the range you had selected in the original app with the translation. Not available when you translated by boxing the screen.
The source language is detected as one of the two languages in the language pair. If the source is in neither language of the pair, or the language can’t be detected, Honyaku doesn’t translate and asks you to review the language pair or the source language. If the source is already in the target language, the source is shown as it is.
About Replace (置き換え)
Replace (置き換え) rewrites only the range you had selected before translating. In the following cases, it stops without rewriting so as not to damage your text. In that case, use Copy (コピー) and paste the translation yourself.
- When the original text was edited or the selection moved after the translation
- When the text is somewhere that can’t be rewritten, such as the body of a web page
- When the original app doesn’t support being rewritten by other apps
Whether formatting is kept and whether you can undo it with Undo (⌘Z) depends on the original app.
Settings
Open it with Settings… (設定…) in the menu bar, the gear in the translation window, or ⌘,. Changes are saved immediately.
| Item | What it does | Default |
|---|---|---|
| Open at login (ログイン時に自動で起動) | Whether Honyaku opens automatically when you log in to your Mac (0.3.2 and later). It is registered in macOS Login Items. If macOS asks for permission, turn Honyaku on from the “Open Login Items” option that appears | Off |
| Language pair (言語ペア) | The two languages to translate between. The source is detected automatically and translated into the other language | Japanese ⇄ English |
| Show translation area while dragging (ドラッグ中に翻訳エリアを表示) | Whether the drop area appears while you drag text | On |
| Drop area position (ドロップエリアの位置) | Where the area appears relative to the selected text (above, below, left, right or center). In apps where the position can’t be read, the place where you started dragging is used instead | Above |
| Expand source by default (原文を最初から展開) | Whether Source (原文) in the translation window starts expanded. Takes effect from the next translation | Off |
| Move the pointer to the Copy button when the result is shown (翻訳結果の表示時にマウスをコピーボタンへ移動) | Whether the mouse pointer moves onto the Copy (コピー) button when the translation appears. Handy when you want to copy right away | Off |
| Select an area while holding a key (キーを押しながら範囲選択する) | Whether to use boxing the screen while holding a key. Even when off, Translate a screen area (画面の範囲を翻訳) in the menu bar still works | On |
| Key to hold (押し続けるキー) | The key you hold while boxing the screen (F1–F8) | F1 |
| Screen Recording (画面収録) | Shows the permission status, with a button to request the permission and a button to open System Settings | — |
| Accessibility (アクセシビリティ) | Shows the permission status, with a button to request the permission | — |
| Shortcut (ショートカット) | The keys for translating selected text. Can’t be changed | ⌥⇧T |
| Check for new versions automatically (新しい版を自動で確認する) | Whether to ask the official site for the latest version once a day | On |
| Update automatically when a new version is found (新しい版が見つかったら自動で更新する) | Whether to swap in a new version automatically when one is found | On |
Update (アップデート) (0.2.0 and later)
The Update (アップデート) section at the very bottom of Settings shows the current version and when it last checked.
- If Check for new versions automatically (新しい版を自動で確認する) is on, it asks the official site (k386.sub.jp) for the latest version shortly after launch and then once a day.
- If Update automatically when a new version is found (新しい版が見つかったら自動で更新する) is on, it downloads the new version, checks the file’s SHA-256, the Developer ID signature and Apple notarization, then replaces the app and relaunches. It waits while you are using the translation window or the drop area. After an automatic update, this section shows a message that it updated automatically from one version to the other (◯◯ から ◯◯ に自動で更新しました).
- If automatic updating is off, Update Now (今すぐ更新) and Download page (ダウンロードのページ) buttons appear when a new version is found.
- You can check right away with Check now (今すぐ確認) or with Check for Updates… (アップデートを確認…) in the menu bar.
Troubleshooting
First, check that Settings shows Allowed.

Nothing happens when I press ⌥⇧T
Check that the Honyaku icon is in the menu bar. If it isn’t, open Honyaku from the Applications folder.
If another app uses the same ⌥⇧T, Honyaku shows Could not register ⌥⇧T (⌥⇧T を登録できませんでした) and the shortcut doesn’t reach Honyaku. Change that app’s shortcut, or use Translate selected text (選択した文章を翻訳) in the menu bar.
It says Accessibility permission is required to read the selected text (選択した文章を読み取るには、アクセシビリティの許可が必要です)
Turn Honyaku on by following Allow Accessibility.
Accessibility is on, but it still says permission is required (Allow Accessibility again)
After you replace the app, for example, macOS may keep an outdated permission entry. Register it again in this order.
- Quit Honyaku.
- In System Settings → Privacy & Security → Accessibility, select “Honyaku” and remove it with “−”.
- Open Honyaku in the Applications folder again and allow it once more.
It says the selected text can’t be retrieved (選択した文章を取得できません)
Check that you selected the text before pressing ⌥⇧T. Some browsers, PDF viewers and custom editors don’t let the selected text be read. In that case, dragging the text onto the drop area may still translate it.
The area doesn’t appear when I drag
Check that Show translation area while dragging (ドラッグ中に翻訳エリアを表示) is on in Settings. The area doesn’t appear while you are only dragging across text to select it. Press and hold the selected text again and move it. Some apps don’t allow dragging text at all.
It says the source language isn’t in the translation pair (原文の言語が翻訳ペアに含まれていません)
The source language is neither language of the language pair. Change the language pair, or open Source (原文) and choose the source language. Detection can be wrong for short text, so selecting a little more text makes detection easier.
It says it can’t replace directly in this app (このアプリでは直接置き換えできません) or the original text or selection has changed (元の文章または選択範囲が変わりました)
Rewriting was stopped so as not to damage your text. Use Copy (コピー) to put the translation on the clipboard and paste it yourself. Selecting the text again and translating it again may let you replace it.
It doesn’t update automatically, or it says it couldn’t update (更新できませんでした)
Check that automatic checking and automatic updating are on in the Update (アップデート) section of Settings. If you opened the app from somewhere other than the Applications folder (such as inside the disk image), it can’t update itself. Copy it to the Applications folder and open it again.
When you are offline, or when the file couldn’t be verified, it changes nothing and tries again at the next check (the next day). To install it right away, replace it with the new DMG from the download page. Version 0.1.0 has no update feature, so you need to replace it by hand.
Pressing F1 doesn’t start area selection, or it changes the brightness
On many keyboards, keys such as F1 work as brightness and volume controls. In System Settings → Keyboard → Keyboard Shortcuts… → Function Keys, turn on “Use F1, F2, etc. keys as standard function keys”, or press F1 while holding the fn key. Honyaku never changes this setting.
Also check that Select an area while holding a key (キーを押しながら範囲選択する) is on in Settings. If another app uses the same key, Honyaku shows Could not register F1 (F1 を登録できませんでした). Choose another key, or use Translate a screen area (画面の範囲を翻訳) in the menu bar.
It says Screen Recording permission is required (画面収録の許可が必要です), or it can’t read the screen even though I allowed it
Turn Honyaku on by following Allow Screen Recording. If it still can’t read the screen after you allow it, quit Honyaku and open it again. If this is after replacing the app, remove “Honyaku” from the list with “−” and then allow it again.
It says no text was found in this area (この範囲には文字が見つかりませんでした), or the text is misread
For small text, try small text mode by pressing F2 while drawing the box, or zoom in on the screen before boxing. For multi-column text, boxing one column at a time makes it easier to read correctly. Vertical text may not be read correctly.
Translation fails, or a language can’t be chosen
The translation data for that language may not have been downloaded. Translate again while connected to the internet, and download the data on the macOS confirmation screen. You can also download it in System Settings → General → Language & Region → Translation Languages.
Glossary
- Accessibility (permission)
- A macOS mechanism originally meant for assistive features, such as screen readers, to read and operate the contents of other apps. Honyaku uses it to read the selected text and to replace it.
- Screen Recording (permission)
- A macOS permission that lets an app capture what is shown on the screen. Honyaku uses it only to read the text in the area you box with “translate by boxing the screen”.
- Text recognition
- A mechanism that reads the characters in an image and turns them into text. Honyaku uses the text recognition built into macOS (Vision) and reads the text on your Mac.
- Language pair
- The combination of two languages to translate between. Honyaku detects which of the two languages the source is in and translates it into the other.
- Apple’s translation
- The translation mechanism built into macOS. Once the language data is downloaded, it translates on your Mac.
- Menu bar
- The long strip at the very top of the screen. Icons of apps that keep running appear on its right side.