> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openwhispr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# macOS

> macOS-specific setup, permissions, and features.

## Requirements

* macOS 12 (Monterey) or later for the app and cloud transcription
* macOS 13.3 (Ventura) or later for on-device models (local Whisper, Parakeet)
* Apple Silicon (arm64) or Intel (x64)

## Permissions

macOS requires explicit permission grants. OpenWhispr requests these during onboarding.

| Permission       | Required for              | Where to enable                              |
| ---------------- | ------------------------- | -------------------------------------------- |
| Microphone       | Voice recording           | System Settings > Privacy > Microphone       |
| Accessibility    | Auto-paste text at cursor | System Settings > Privacy > Accessibility    |
| Screen recording | Meeting audio capture     | System Settings > Privacy > Screen Recording |

<Tip>
  If auto-paste stops working, go to System Settings > Privacy > Accessibility, remove OpenWhispr, and re-add it.
</Tip>

## Globe key

On macOS, you can use the Globe/Fn key as your dictation hotkey. Packaged releases include the native listener. If you're building from source, install the Xcode Command Line Tools so the listener can compile:

```bash theme={null}
xcode-select --install
```

No Input Monitoring permission is needed.

## Installation

Download the `.dmg` from the [releases page](https://github.com/OpenWhispr/openwhispr/releases/latest). Drag OpenWhispr to your Applications folder.

On first launch, macOS may show a security warning for unsigned builds. Right-click the app and select **Open** to bypass this.

## Uninstalling

1. Drag OpenWhispr from Applications to Trash
2. Optionally remove cached models: `rm -rf ~/.cache/openwhispr/`
3. Optionally remove app data: `rm -rf ~/Library/Application\ Support/OpenWhispr/`