KoeSub

Support

Help, troubleshooting, and frequently asked questions

Contact Support

For questions, bug reports, or feature requests, contact:

support@toybird.com

Support is available in English and Japanese.

For bug reports, include your macOS version, KoeSub version, selected audio source, and the steps that did not work as expected.

Basic Usage

  1. Open KoeSub from the Applications folder or the menu bar.
  2. English-to-Japanese is the supported language pair; no language selection is required.
  3. Choose the audio source you want to translate, such as Mac audio, microphone input, or both when available.
  4. Press Option + S or use the menu bar to start translation. You can change the shortcut in Settings.
  5. Turn translation off when you are finished.

Getting Started Video

Watch the Japanese tutorial, then use the permission checklist below if subtitles do not appear.

Permissions

KoeSub may request macOS permissions for Screen Recording, Microphone, and Speech Recognition depending on the selected audio source and system configuration.

  • Screen Recording: allows macOS system audio capture used for translating Mac audio.
  • Microphone: allows microphone input when that source is selected.
  • Speech Recognition: allows Apple speech recognition frameworks to convert spoken audio into text before translation.

If translation does not start, open macOS System Settings and confirm that KoeSub has the required permissions.

Frequently Asked Questions

Does KoeSub start listening automatically when my Mac starts?

No. KoeSub may launch at login if enabled, but it stays idle. Audio capture and translation start only when you turn translation on.

What changed in version 2.2?

Version 2.2 improves translation accuracy. It remains an aid to understanding live conversations, not a guarantee of verbatim or professional interpretation.

Does KoeSub guarantee perfect translation?

No. KoeSub uses Apple system speech recognition and translation frameworks. Results can vary depending on audio quality, accent, speaker speed, background noise, and supported language availability.

Why do subtitles sometimes look incomplete or delayed?

Real-time speech recognition updates partial text while someone is still speaking. KoeSub translates finalized segments, so translated subtitles may appear slightly after the spoken words and may be revised as recognition stabilizes.

Can KoeSub translate both Mac audio and microphone input?

Yes, when the selected macOS version, device configuration, and permissions support the required audio capture path. Audio quality can vary depending on speaker volume, microphone placement, headphones, and background noise.

Does KoeSub upload my audio to Toybird Labs?

No. KoeSub does not upload your audio, transcripts, or translations to Toybird Labs servers.

How does the free trial work?

KoeSub provides five minutes of active subtitle time per launch. Time is counted only while subtitles are running. Quitting and relaunching resets the five-minute allowance.

Does KoeSub support Singapore English?

Custom acoustic ML can recognize evidence of Singapore English and, when supported, adapt speech recognition to en-SG. General English is the default.

Does KoeSub provide post-meeting summaries?

No. KoeSub focuses on supporting understanding during live conversations.

Which languages are supported?

KoeSub v2.2.0 supports English-to-Japanese subtitles. Availability depends on Apple system speech recognition and translation resources.

Troubleshooting

  • If no subtitles appear, confirm that translation is turned on and that the correct audio source is selected.
  • If Mac audio is not recognized, check Screen Recording permission in macOS System Settings.
  • If microphone input is not recognized, check Microphone permission and the selected input device.
  • If translation is unavailable, check Apple English speech recognition and Japanese translation resources on your Mac.
  • If results are unstable, try using headphones, reducing background noise, or selecting only the audio source you need.

App Information

App name: KoeSub

Current release: v2.2.0 · macOS 15+

Bundle ID: com.toybird.KoeSub

The installed app version can be checked in Finder or macOS app information.