First-Time Setup: How to Use TurboWhisper on Mac

Welcome to TurboWhisper. This guide walks you through your first install — from downloading the app to dictating your first sentence in any Mac app. Most people are up and running in under 10 minutes.

What you need before you start

• A Mac running a supported version of macOS (Sequoia and recent releases are supported)
• A working microphone (built-in Mac mic is fine to start)
• About 5–10 minutes for install and permissions

You do not need a cloud account or API keys to get started. TurboWhisper can transcribe locally on your Mac out of the box.

Step 1: Download and install

1. Download TurboWhisper from the website
2. Open the .dmg file from your Downloads folder
3. Drag TurboWhisper into your Applications folder
4. Open TurboWhisper from Applications (or Spotlight)

macOS security prompt? If macOS blocks the app the first time, go to System Settings → Privacy & Security and click Open Anyway for TurboWhisper. The app is notarized for distribution.

Step 2: Complete first-run onboarding

When you launch TurboWhisper for the first time, you'll see a welcome screen and guided setup. Follow the prompts — they walk you through the essentials in order.

Don't skip onboarding. It saves time later by surfacing permissions and hotkey setup upfront.

Step 3: Grant required permissions

TurboWhisper needs a few macOS permissions to work system-wide. Open the Permissions tab in the app (or follow onboarding) and enable each one:

For each permission:

1. Click the enable button in TurboWhisper
2. macOS opens System Settings — toggle TurboWhisper on
3. Return to TurboWhisper and confirm the status shows as granted

If a permission still shows as missing, click Refresh in the Permissions tab or restart the app.

Step 4: Choose your transcription model

Go to the Models tab and pick an active model.

Recommended for first-time users:

• Start with an On-Device model (local Whisper or Parakeet-style engine)
• Local models work offline and keep audio on your Mac
• First download may take a minute depending on model size — let it finish before testing

You can switch models anytime. Cloud providers (Groq, Deepgram, etc.) are optional and only needed if you configure API keys in Settings → API Keys.

Step 5: Set your global hotkey

TurboWhisper's core workflow is a system-wide hotkey — you dictate in whatever app already has focus.

1. Open Settings → Hotkeys
2. Pick a modifier key you can hold comfortably (Fn, Option, Control, or Command combinations)
3. Avoid shortcuts already used by Spotlight or other tools

Popular starting choice: a modifier you rarely use elsewhere, held while speaking.

The mini recorder panel appears when you activate the hotkey — you'll see a waveform, timer, and recording state.

Step 6: Dictate your first sentence

Time for a real test. Open any app with a text field:

• Notes
• Slack
• Gmail in your browser
• Cursor or any code editor (for a commit message, not code symbols)

Then:

1. Click where you want text to appear (place your cursor)
2. Hold your TurboWhisper hotkey
3. Speak naturally: "This is my first dictation test with TurboWhisper."
4. Release the hotkey

Clean text should appear at your cursor. If you enabled clipboard copy in settings, the text is also copied.

Try this exact phrase first — short, clear, and easy to verify:

"TurboWhisper setup complete. Voice input is working."

Step 7: Activate your license (if you purchased)

If you bought a plan:

1. Open Settings → License
2. Enter the license key from your purchase email
3. Confirm activation status shows as active

Each plan includes a set number of Mac activations. Use the customer portal if you need to manage devices.

During trial or before purchase, explore the full feature set to confirm the workflow fits your day.

What to do in your first hour

By the end of hour one, you should know whether TurboWhisper fits your rhythm.

Common first-day issues

Nothing happens when I hold the hotkey

• Confirm Accessibility and Microphone are both granted
• Check for hotkey conflicts in Settings → Hotkeys
• Restart TurboWhisper after granting permissions

Text doesn't appear in the app I'm using

• Make sure your cursor is active in a text field before holding the hotkey
• Some secure fields (password boxes) block insertion — test in Notes first
• Re-check Accessibility permission in System Settings

Transcription is slow or inaccurate

• Wait for the on-device model download to fully complete
• Reduce background noise and speak in shorter phrases
• Try a different model in the Models tab
• Check Settings → Audio Input and confirm the right microphone is selected

macOS asks for permissions again after an update

• Open the Permissions tab and re-grant anything marked missing
• This is normal after some macOS or app updates

The daily pattern (once setup is done)

After setup, TurboWhisper fits into a simple loop:

1. Focus the app you're already in
2. Hold hotkey → speak → release
3. Edit if needed, then send

No app switching. No copy-paste relay. Your voice becomes the fastest path to prose.

Where to go next

• Daily dictation workflow — build a habit that sticks
• Voice dictation for developers — commit messages, PRs, and terminal notes
• Privacy comparison vs Wispr Flow — how local-first transcription works

Stuck on setup? Email support with your macOS version and which step failed — we'll help you get dictating.