Settings

Access Settings by clicking the Settings tab in Yap.

Transcription Provider

Choose between local and cloud transcription:

• Local — Uses whisper.cpp on your device
• Cloud (OpenAI) — Uses OpenAI’s Whisper API

See Transcription for details on each provider.

Model Selection (Local Only)

When using local transcription:

1. Browse available models
2. Click to download models you need
3. Click a downloaded model to select it as active

The active model shows a green checkmark.

OpenAI API Key (Cloud Only)

When using cloud transcription:

1. Get an API key from OpenAI
2. Paste your key in the API Key field
3. The key is stored securely in your local config

Security: Your API key is stored locally and only sent to OpenAI’s servers when transcribing.

Audio Input Device

Select which microphone to use:

1. Click the dropdown
2. Choose from available audio input devices
3. The selected device is used immediately

If you connect a new microphone while Yap is running, you may need to restart the app to see it.

Recording Hotkey

Choose your preferred hotkey for starting/stopping recordings:

Double-tap Mode

Double-tap requires pressing the key twice quickly (within 300ms). This prevents accidental recordings when pressing Option for other shortcuts.

Auto-Paste

When enabled, transcribed text is automatically pasted into the active application.

• Enabled (default) — Text pastes automatically
• Disabled — Text is copied to clipboard only

Disable auto-paste if you:

• Want to review transcriptions before pasting
• Use applications that don’t accept paste commands
• Prefer manual control

Sound Feedback

Toggle audio feedback for recording start/stop:

• Enabled — Hear a sound when recording starts and stops
• Disabled — Silent operation

Disable sounds for:

• Quiet environments
• Video calls where sounds might be picked up
• Personal preference

Configuration File

Settings are stored in:

~/Library/Application Support/yap/config.json

Example configuration:

{
  "provider": "local",
  "model": "base.en",
  "openaiApiKey": "",
  "audioInputDevice": "",
  "autoPaste": true,
  "showNotification": true,
  "recordingHotkey": "rightOption",
  "soundEnabled": true
}

Note: Editing the config file directly is supported but changes require restarting Yap.