Support. Help with Hushpen.

Hushpen is free and open source, made by one person. The fastest way to get help is a GitHub issue. Read the answers below first; most setup questions are here.

iPhone and iPad

How do I add the Hushpen keyboard?
  1. Open the Settings app, then General, then Keyboard, then Keyboards.
  2. Tap Add New Keyboard and choose Hushpen.
  3. Tap Hushpen in the list and turn on Allow Full Access.
  4. In any app, tap a text field, then hold the globe key and choose Hushpen.
Why does the keyboard ask for Full Access?

iOS lets a keyboard receive text from its own app only with Full Access. Hushpen uses it for one thing: to take the text it made and put it in the app you are typing in. The keyboard has no network code, it never records, and it does not store or send what you type. Without Full Access, dictation cannot return text. Read the privacy policy for the details.

How do I dictate?
  1. Tap the microphone key on the Hushpen keyboard.
  2. Hushpen opens and listens. Swipe right to go back to your app, then talk.
  3. Tap the check mark above the keys when you finish.
  4. The text appears at the cursor by itself. Undo removes it.
Why does Hushpen open to dictate?

iOS does not let a keyboard use the microphone. So the keyboard asks the Hushpen app to listen. The recording continues in the background while you go back, and the Dynamic Island or the Lock Screen shows that Hushpen is listening.

Which speech model should I download?

Open Models in Hushpen. Parakeet v3 Q4 (416 MB) is the recommended one for English and 24 other European languages. Whisper Base Q5 (60 MB) and Whisper Small Q5 (190 MB) are smaller and suit older iPhones and other languages. Whisper Large v3 Turbo Q5 (574 MB) needs 6 GB of RAM or more. You need one model before you can dictate. All of them run on the device.

The keyboard does not show up in the globe menu.

Check that Hushpen is in Settings, General, Keyboard, Keyboards. If it is, restart the app you are typing in. iOS does not tell Hushpen whether the keyboard is on, so Home shows Set Up until the keyboard is used once with Full Access.

The keyboard does not appear in a password field.

iOS never shows a custom keyboard in a password or other secure field. This is a system rule, not a Hushpen setting.

How do I use my iPhone as a server for my computer?
  1. Install Hushpen on your Mac, Windows or Linux computer.
  2. In Hushpen on the iPhone, open Devices and turn on Server Mode.
  3. Tap Pair a Desktop, and scan the code that the computer shows under Devices, Add device.
  4. Keep Hushpen open and plugged in. Server Mode stops when you leave the app.

All devices

Is my voice sent to a server?

No. Speech recognition runs on your own device. The only internet use is downloading a speech model, and updates on a computer. Update checks send the app name, platform, and version. We count them per day and keep nothing that identifies you. Read the privacy policy.

Is Hushpen really free?

Yes. There is no subscription, no account and no word limit. Hushpen is open source under AGPL-3.0-or-later.

How do I delete my data?

All data stays on your device. On iPhone and iPad, delete the Hushpen app to remove its models, settings and pairing keys. On a computer, delete entries in History, or the app's data folder. There is no account to close.

What should I put in a bug report?

Say which device and system version you use, the Hushpen version (Settings on iPhone and iPad, About on a computer), the speech model, and the steps that lead to the problem. Do not attach recordings or private text.

© 2026 Suraj Mandal