Skip to content

Settings

Configure Yap transcription, microphone, recording and cancel keys, auto-paste, and sound feedback on your desktop.

Open Settings from Yap’s navigation.

Yap Settings showing transcription files, provider, microphone, shortcut, and behavior controls

Yap 0.5.0 Settings, captured from the release React UI with sample data.

Transcription provider

Choose local Whisper or OpenAI. Local mode runs on your device after downloading a model. OpenAI mode sends recordings to OpenAI and requires an API key and internet access. Changing provider does not re-transcribe existing history.

In 0.5.0, download and select local models in the separate Models Library. Older 0.4.2 builds managed models in Settings.

OpenAI API key

Enter your key and use the save control. Yap stores it in config.json as plain JSON, not in an encrypted keychain. Do not publish that file or include it in a bug report. OpenAI API billing is separate from Yap and from a ChatGPT subscription.

Audio input device

Choose your microphone, or use the system default. If a newly connected device is missing, reopen Settings or restart Yap. Make a short test recording after changing input.

Recording and cancel keys

Click a key control and press the desired single key. The defaults are Right Option on macOS, Right Alt on Windows/Linux, and Escape to cancel. See keyboard shortcuts for platform limitations.

Auto-paste and sound

  • Auto-paste on: copy the transcript and simulate the platform’s paste shortcut in the target app.
  • Auto-paste off: copy the transcript without simulating a paste. Review it in History if needed.
  • Sound enabled: play recording feedback. Disable it for quiet environments or calls.

If copying or pasting fails, retrieve the text from History. Linux auto-paste needs xdotool; macOS needs Accessibility permission.

Files and diagnostics

Under Transcription files, choose a writable Transcription output folder, then enable Save transcriptions as .txt. This is off by default and applies to future successful transcriptions from either provider; it does not export existing history. Each file preserves the transcript’s UTF-8 text, whitespace, and line breaks. Names follow transcription-YYYY-MM-DD-HHMMSS-<unique suffix>.txt, without overwriting existing files. The folder and toggle persist across restarts. Cancelling the folder picker leaves your settings unchanged.

Saving works independently of copying and auto-paste. If the folder becomes unavailable, Yap shows an output error while keeping the transcript in History. Choose a writable folder or disable saving to clear the error; a later successful save also clears it. Failed saves are not automatically retried, so copy the affected transcript from History if you need to save it manually.

Deleting or clearing history does not remove these text files. Disabling saving leaves existing files and the chosen folder intact. Treat the files as plain text containing your dictated content; a cloud-synced output folder may sync them through that service.

See configuration for the real JSON fields and data directories on all three platforms. Quit Yap before editing configuration manually, and keep a backup rather than deleting the whole data folder.