Troubleshooting

Transcription works but text is not inserted

If you see streaming text in the notch indicator but nothing appears in your target app, the issue is almost always a missing or stale Accessibility permission. TypeWhisper needs two separate permissions: Microphone (for recording) and Accessibility (for inserting text). Many users only grant Microphone and miss the second one.

Another sign of this issue is that your history stays empty - history entries are only saved after text insertion succeeds.

How to fix

1. Open System Settings > Privacy & Security > Accessibility
2. If TypeWhisper is listed, remove it (click the minus button)
3. Restart TypeWhisper - it will re-prompt for permission

If that doesn't work, the TCC database entry may be stale. Reset it via Terminal:

Then restart TypeWhisper and grant Accessibility permission when prompted.

Microphone permission not working

If TypeWhisper can't start recording, check System Settings > Privacy & Security > Microphone and make sure TypeWhisper is listed and enabled.

On macOS 26 (Tahoe) and later, the Microphone permission dialog only appears once. If you denied it the first time, you need to enable it manually in System Settings. If toggling doesn't help, reset it:

Permissions broken after reinstall

macOS ties permissions to the app's code signature. After reinstalling or updating TypeWhisper, old permission entries can become stale - the toggle appears enabled but the permission doesn't actually work.

Fix: Remove TypeWhisper from both the Accessibility and Microphone lists in System Settings, restart the app, and re-grant both permissions.

Setup wizard keeps appearing

The setup wizard appears automatically when Microphone permission is not granted. Once you grant both Microphone and Accessibility permissions and complete the wizard, it won't appear again.

No audio input detected

If TypeWhisper shows "No audio input available", make sure your microphone is connected and selected. Go to Settings > Recording and pick the correct input device. If using an external microphone, check that it's recognized in System Settings > Sound > Input.