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

# Permissions

> Fix microphone and accessibility permission issues.

Scout needs system permissions to capture audio and inject text. If something isn't working, permissions are the most common cause.

## macOS

macOS requires two permissions: **Microphone** and **Accessibility**.

### Microphone

<Steps>
  <Step title="Open System Settings">
    Go to **System Settings → Privacy & Security → Microphone**.
  </Step>

  <Step title="Find Scout">
    Look for **Scout** or **Scout Voice** in the list.
  </Step>

  <Step title="Enable the toggle">
    Turn the toggle on. If Scout isn't listed, launch Scout — it will prompt you to grant access.
  </Step>
</Steps>

### Accessibility

Accessibility permission lets Scout simulate keystrokes to paste text into apps and detect hotkey presses (including the Fn key).

<Steps>
  <Step title="Open System Settings">
    Go to **System Settings → Privacy & Security → Accessibility**.
  </Step>

  <Step title="Find Scout">
    Look for **Scout** or **Scout Voice** in the list.
  </Step>

  <Step title="Enable the toggle">
    Turn the toggle on. If Scout isn't listed, click the **+** button, navigate to your Applications folder, and add Scout.
  </Step>
</Steps>

<Warning>
  **After macOS updates or app reinstalls**, Accessibility permission may stop working even though the toggle appears enabled. To fix this, toggle Scout **off** then **on** again in Accessibility settings, then relaunch Scout.
</Warning>

### Reset Accessibility permission (last resort)

If toggling off/on doesn't fix Accessibility, you can reset the permission entirely:

1. Open **Terminal**
2. Run: `tccutil reset Accessibility ai.scoutvoice.app`
3. Relaunch Scout — it will prompt for Accessibility again
4. Grant permission and restart Scout

<Note>
  This resets only Scout's Accessibility permission, not other apps.
</Note>

***

## Windows

Windows requires **Microphone** permission. Scout uses a low-level keyboard hook for hotkey detection and clipboard-based paste for text injection — neither requires additional permissions.

### Microphone

<Steps>
  <Step title="Open Settings">
    Go to **Settings → Privacy & Security → Microphone**.
  </Step>

  <Step title="Enable microphone access">
    Make sure **Microphone access** is turned on at the top of the page.
  </Step>

  <Step title="Allow desktop apps">
    Scroll to the bottom and make sure **Let desktop apps access your microphone** is turned on. Scout should appear in the app list above this toggle.
  </Step>
</Steps>