EmberType Documentation

Installation and Setup

1. Download EmberType
   Download the DMG file from the website or your purchase confirmation email.
2. Open the DMG
   Double-click the downloaded EmberType.dmg file to mount it.
3. Drag to Applications
   Drag the EmberType icon to your Applications folder.
4. Launch EmberType
   Open EmberType from your Applications folder. If macOS blocks it, right-click the app and select "Open", then click "Open" again in the dialog.

Required Mac Permissions

EmberType requires two system permissions to function properly:

Accessibility Permission

This allows EmberType to type transcribed text into any application.

1. Go to System Settings > Privacy & Security > Accessibility
2. Click the + button
3. Navigate to Applications and select EmberType
4. Toggle it ON

Microphone Permission

This allows EmberType to record your voice for transcription.

1. Go to System Settings > Privacy & Security > Microphone
2. Find EmberType in the list
3. Toggle it ON

Whisper AI Model Selection

EmberType uses OpenAI's Whisper AI models for speech recognition. All processing happens locally on your Mac.

Downloading a Model

1. Open EmberType and go to AI Models
2. Choose a model and click Download
3. Wait for the download to complete
4. Set it as your default model

Model Comparison

For most users, Large v3 Turbo offers the best balance of speed and accuracy on Apple Silicon Macs. See our recommended models guide for detailed comparisons and recommendations.

Basic Usage and Dictation

Recording and Transcribing

1. Press your configured hotkey to start recording
2. Speak clearly into your microphone
3. Press the hotkey again to stop and transcribe
4. The transcribed text appears at your cursor position

Menu Bar

EmberType lives in your menu bar. Click the icon to:

• Start/stop recording manually
• Access settings
• View transcription history
• Quit the application

Tips for Best Results

• Speak at a natural pace, not too fast
• Minimize background noise
• Use a quality microphone if possible
• Pause briefly between sentences

Keyboard Shortcuts Guide

Configure your global hotkey in Settings. The default is Right Shift.

Recording Modes

EmberType supports two recording modes:

• Toggle Mode — Press the hotkey once to start recording, press again to stop and transcribe.
• Push-to-Talk — Hold down the hotkey while speaking, release to stop and transcribe. Great for quick dictations.

You can switch between modes in Settings.

Default Shortcuts

You can change the hotkey to any key combination that works for your workflow.

EmberType Settings Guide

General

• Launch at Login - Start EmberType when you log in
• Show in Dock - Display EmberType in the Dock

Audio

• Input Device - Select your microphone
• Sound Effects - Play sounds when recording starts/stops

Transcription

• Language - Set your primary language or use auto-detect
• AI Enhancement - Apply formatting and punctuation improvements

Dictionary

Add custom words, names, or technical terms to improve recognition accuracy.

Troubleshooting Common Issues

Nothing gets typed after transcription

The Accessibility permission is missing or broken.

1. Go to System Settings > Privacy & Security > Accessibility
2. Remove EmberType from the list
3. Re-add it from /Applications/EmberType.app
4. Toggle it ON

App won't open

macOS is blocking the app because it's from an unidentified developer.

1. Right-click the app in Finder
2. Select "Open" from the menu
3. Click "Open" in the dialog that appears

No transcription happening

You likely haven't downloaded a Whisper model yet.

1. Open EmberType
2. Go to AI Models
3. Download at least one model
4. Set it as your default

Transcription is inaccurate

• Try a larger model (Large v3 Turbo is most accurate)
• Reduce background noise
• Speak more slowly and clearly
• Add frequently-used terms to your Dictionary

Hotkey not working

• Ensure EmberType is running (check menu bar)
• Verify Accessibility permission is enabled
• Try a different hotkey in Settings
• Check for conflicts with other apps

License Help and Activation

Having trouble with your license? Here's everything you need to know.

About Polar.sh

EmberType uses Polar.sh as our payment processor and license manager. Polar is a third-party service that handles purchases and generates license keys — they're not affiliated with EmberType in any other way. When you buy EmberType, Polar processes your payment and emails you a license key.

Finding Your License Key

Your license key was emailed to you immediately after purchase from noreply@polar.sh. Check your inbox (and spam folder) for an email with subject line containing "EmberType".

Managing Your License

Visit polar.sh/purchases and log in with the email you used to purchase. From there you can:

• View and copy your license key
• See which devices are activated
• Deactivate old devices to free up slots
• Download your invoice/receipt

Device Activations

Your license allows up to 3 Mac activations. If you've used all slots and need to activate a new Mac:

1. Go to polar.sh/purchases
2. Find your EmberType purchase
3. Deactivate an old device you no longer use
4. Enter your license key on your new Mac

License Not Working?

• Key rejected: Make sure you're copying the full key with no extra spaces
• Already activated: You may need to deactivate another device first
• Can't find email: Check spam, or log into Polar directly
• Still stuck: Contact us at contact@embertype.com

EmberType License Details

EmberType is open-source software licensed under GPL v3.

Why We Charge

EmberType is free to build from source, but we offer a ready-to-use app for those who value their time. When you purchase EmberType, you're paying for:

• Convenience — Download, install, and start dictating in 60 seconds. No Xcode, no compiling, no setup hassle.
• Support — Direct email support when you need help getting things working.
• Updates — New features and improvements delivered automatically.

Build It Yourself

Prefer to build from source? The full source code is available on GitHub. You'll need Xcode and some technical know-how, but everything you need is there.

Your Rights Under GPL v3

• Use the software freely
• Study and modify the source code
• Build and distribute your own versions

Attribution

EmberType uses whisper.cpp by ggerganov for speech recognition.

Full license text: GNU GPL v3

Read our Terms of Service and Privacy Policy for more information about how we handle your data.