Configuration

Complete configuration reference

Configuration File

Yap stores settings in a JSON configuration file:

Location:

macOS: ~/Library/Application Support/yap/config.json
Windows: %APPDATA%\yap\config.json
Linux: ~/.config/yap/config.json

Configuration Options

provider

Transcription provider to use.

Value	Description
`"local"`	Use whisper.cpp (default)
`"openai"`	Use OpenAI Whisper API

{
  "provider": "local"
}

model

Active Whisper model for local transcription.

Value	Size	Notes
`"tiny"`	~75 MB	Fastest, multilingual
`"tiny.en"`	~75 MB	Fastest, English-only
`"base"`	~150 MB	Good balance, multilingual
`"base.en"`	~150 MB	Good balance, English-only (default)
`"small"`	~500 MB	Better accuracy, multilingual
`"small.en"`	~500 MB	Better accuracy, English-only
`"medium"`	~1.5 GB	High accuracy, multilingual
`"medium.en"`	~1.5 GB	High accuracy, English-only
`"large-v3"`	~3 GB	Highest accuracy, multilingual

{
  "model": "base.en"
}

openaiApiKey

API key for OpenAI Whisper (required for cloud provider).

{
  "openaiApiKey": "sk-..."
}

Get your API key from OpenAI Platform.

audioInputDevice

Name of the audio input device to use. Empty string uses system default.

{
  "audioInputDevice": "MacBook Pro Microphone"
}

autoPaste

Automatically paste transcribed text after recording.

Value	Behavior
`true`	Paste text automatically (default)
`false`	Copy to clipboard only

{
  "autoPaste": true
}

showNotification

Show system notification after transcription (future feature).

{
  "showNotification": true
}

recordingHotkey

Global hotkey for starting/stopping recording.

Value	Key
`"rightOption"`	Right Option key (default)
`"leftOption"`	Left Option key
`"fn"`	Function key
`"doubleTapRightOption"`	Double-tap Right Option

{
  "recordingHotkey": "rightOption"
}

soundEnabled

Play audio feedback when recording starts/stops.

{
  "soundEnabled": true
}

Example Configuration

Complete example with all options:

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

Data Directories

Models

Downloaded Whisper models are stored in:

~/Library/Application Support/yap/models/

Model files follow the naming convention:

ggml-tiny.bin
ggml-tiny.en.bin
ggml-base.bin
etc.

Recordings

Audio recordings are stored in:

~/Library/Application Support/yap/recordings/

Format: WAV, 16kHz, mono

History

Transcription history is stored in:

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

Statistics

Usage statistics are stored in:

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

Environment Variables

Yap respects the following environment variables:

WHISPER_CPP_PATH

Path to the whisper-cpp executable (if not in PATH).

export WHISPER_CPP_PATH=/usr/local/bin/whisper-cli

Resetting Configuration

To reset to defaults:

Quit Yap

Delete the config file:

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

Restart Yap

Or delete the entire data directory:

rm -rf ~/Library/Application\ Support/yap/

Warning: This deletes all models, history, and recordings.