Skip to main content

​
System Requirements

Before installing VoiceTypr, verify your system meets the minimum requirements:
Minimum Requirements
  • macOS 13.0 (Ventura) or later
  • 3-4 GB free disk space (for AI models)
  • Intel or Apple Silicon (M1/M2/M3) processor
  • Built-in or external microphone
Recommended
  • macOS 14.0 (Sonoma) or later
  • Apple Silicon for best performance
  • 8GB+ RAM for large models

​
Installation Steps

1

Download VoiceTypr

  1. Visit the latest release page
  2. Download VoiceTypr.dmg for macOS
  3. Wait for the download to complete (~50MB)
Look for the .dmg file in the release assets section.
2

Install the Application

  1. Open the downloaded VoiceTypr.dmg file
  2. Drag the VoiceTypr app icon to your Applications folder
  3. Wait for the copy to complete
  4. Eject the VoiceTypr disk image
VoiceTypr is fully signed and notarized by Apple, so you won’t see any security warnings.
3

Launch VoiceTypr

  1. Open Applications folder
  2. Find and double-click Voicetypr
  3. The app will launch and appear in your menu bar
If you see a menu bar icon, installation was successful!
4

Grant Microphone Permission

On first launch, macOS will request microphone access:
  1. Click OK when prompted for microphone access
  2. If you missed the prompt:
    • Open System Settings > Privacy & Security > Microphone
    • Enable the toggle for Voicetypr
Microphone access is required for recording. VoiceTypr cannot function without this permission.
5

Grant Accessibility Permission

For automatic text insertion at your cursor:
  1. Open System Settings > Privacy & Security > Accessibility
  2. Click the + button (you may need to unlock with your password)
  3. Navigate to Applications and select Voicetypr
  4. Enable the toggle for Voicetypr
Why this permission? VoiceTypr needs accessibility access to automatically paste transcribed text at your cursor position in any app. Without it, text will be copied to your clipboard instead.
6

Download AI Model

On first launch, VoiceTypr will guide you through model selection:
  1. Click on the VoiceTypr menu bar icon
  2. Navigate to the Models tab
  3. Choose a model size (recommended: base)
  4. Click Download and wait for completion
Model sizes and download times:
  • tiny (39MB) - ~30 seconds - Fast, basic accuracy
  • base (74MB) - ~1 minute - Recommended for most users
  • small (244MB) - ~3 minutes - Better accuracy
  • medium (769MB) - ~8 minutes - High accuracy
  • large (1.5GB) - ~15 minutes - Best accuracy, slower
Start with the base model. You can always download additional models later or switch between them.

​
Verify Installation

After completing all steps:
  1. Look for the VoiceTypr icon in your menu bar (top-right of screen)
  2. Click the icon—you should see the main window
  3. Check the Overview tab for a green “Ready” status
  4. The default hotkey is Cmd + Shift + Space

Next: Complete Your First Transcription

Follow the quickstart guide to test your installation

​
Post-Installation Setup

​
Configure Hotkey (Optional)

The default hotkey works for most users, but you can customize it:
  1. Open VoiceTypr from your menu bar (macOS) or system tray (Windows)
  2. Navigate to Settings tab
  3. Click on the Hotkey field
  4. Press your desired key combination
  5. Click Save
Avoid system-reserved hotkeys like Cmd+Q (Quit), Cmd+Tab (App Switcher), or common app shortcuts to prevent conflicts.

​
Enable Auto-start (Optional)

To launch VoiceTypr automatically when you log in:
  1. Open VoiceTypr settings
  2. Find Launch at startup option
  3. Toggle it on

​
Model Management

You can download multiple models and switch between them:
  • Smaller models (tiny/base) - Faster transcription, good for quick notes
  • Larger models (medium/large) - More accurate, better for important content
Switch models anytime in the Models tab without re-downloading.

​
Troubleshooting Installation

  1. Ensure you’re running macOS 13.0 or later
  2. Try moving the app to Applications folder if not already there
  3. Open Terminal and run: xattr -cr /Applications/Voicetypr.app
  4. Try launching again
If issues persist, report a bug.
This is normal for new applications:
  1. Click More info in the SmartScreen dialog
  2. Click Run anyway
  3. Installation will proceed normally
VoiceTypr is safe and open source—you can verify the code.
macOS:
  1. Open System Settings > Privacy & Security > Microphone
  2. If VoiceTypr is already in the list but disabled, enable it
  3. If not in the list, try launching VoiceTypr again
  4. Restart VoiceTypr after granting permission
Windows:
  1. Open Settings > Privacy > Microphone
  2. Enable “Allow apps to access your microphone”
  3. Scroll down and enable Voicetypr specifically
  4. Restart VoiceTypr
  1. Check your internet connection
  2. Ensure you have enough disk space (models range from 39MB to 1.5GB)
  3. Try canceling and restarting the download
  4. If the issue persists, try a smaller model first
  5. Check GitHub Issues for known download problems
  1. Verify you have a compatible GPU (NVIDIA, AMD, or Intel)
  2. Update your graphics drivers to the latest version
  3. Restart your computer after driver installation
  4. VoiceTypr will automatically detect and use GPU if available
  5. Check task manager during transcription to verify GPU usage
Note: VoiceTypr works perfectly on CPU—GPU is just faster.

​
Uninstallation

If you need to uninstall VoiceTypr:
  1. Quit VoiceTypr (click menu bar icon > Quit)
  2. Open Applications folder
  3. Drag Voicetypr to Trash
  4. Empty Trash
To remove downloaded models and settings:
rm -rf ~/Library/Application\ Support/com.ideaplexa.voicetypr
rm -rf ~/Library/Caches/com.ideaplexa.voicetypr

​
Next Steps

Quickstart Guide

Complete your first transcription

Voice Transcription

Learn about recording and transcription

Model Management

Understand models and optimize performance

Configuration

Customize VoiceTypr to your workflow