Trueears stores all settings automatically as you change them — there is no save button. Open the settings window at any time withDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/devv-shayan/Trueears/llms.txt
Use this file to discover all available pages before exploring further.
Ctrl+Shift+S (Windows/Linux) or Cmd+Shift+S (macOS), or right-click the system tray icon and choose Settings.
Application settings (including your API keys) are stored via Tauri’s Store plugin in a
settings.json file in the app data directory. They are never stored in localStorage. Authentication tokens from Google OAuth are stored separately in auth.json in the same directory.Transcription
The Transcription tab controls how your voice is converted to text.| Setting | Description | Default |
|---|---|---|
| Groq API Key | Your API key from console.groq.com | — |
| Whisper Model | The Groq-hosted Whisper model used for speech-to-text | whisper-large-v3-turbo |
whisper-large-v3-turbo provides the best balance of speed and accuracy. A Groq account is free and includes a generous API quota.
Get a Groq API key
Visit console.groq.com/keys and create a new API key.
LLM Post-Processing
Optional GPT-powered formatting that rewrites your transcription to match the tone and style of your active application.| Setting | Description | Default |
|---|---|---|
| Enable LLM formatting | Master toggle for post-processing | Off |
| Model | OpenRouter-hosted model used for formatting | openai/gpt-oss-120b |
Available models
| Model | Notes |
|---|---|
openai/gpt-oss-120b | Recommended — best formatting quality |
openai/gpt-oss-20b | Faster, lower cost |
LLM post-processing sends transcribed text (not audio) to the model. Audio is only ever sent to Groq’s Whisper API.
Preferences
The Preferences tab contains general behavior settings.| Setting | Description | Options |
|---|---|---|
| Recording Mode | Controls how Ctrl+Shift+K starts and stops recording | Auto, Toggle, Push-to-Talk |
App Profiles
App Profiles tell Trueears how to format text for a specific application. Trueears detects your active window and automatically applies the matching profile. Pre-configured profiles:| Application | Formatting style |
|---|---|
| VS Code / Cursor | Technical docs, @file mentions |
| Slack / Discord | Casual chat messages |
| Outlook | Professional email format |
| Notion / OneNote | Structured notes with bullets |
| Word | Formal document content |
- Custom system prompt — Override the default formatting instructions for this app.
- Language override — Use a specific transcription language when recording in this app (e.g., Spanish for WhatsApp, English for VS Code).
Log Mode
Log Mode saves voice notes to timestamped markdown files, organized by application.| Setting | Description | Default |
|---|---|---|
| Enable Log Mode | Master toggle for the feature | Off |
| Default log directory | Base folder where log files are created | Documents/Trueears |
| Trigger phrases | Phrases that activate logging (e.g., “Log”, “Remember”) | Log, Remember, Note to self |
| App mappings | Maps each application to its log file path | Auto-configured on first use |