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

# macOS

> macOS-specific features, permissions, and troubleshooting for FocusMe.

## Setup Requirements

### Accessibility Permission

<Frame caption="Granting FocusMe Accessibility permission in macOS System Settings">
  <img src="https://mintcdn.com/focusme/mkA5R_lWl__pzlm0/images/platform-macos-accessibility.png?fit=max&auto=format&n=mkA5R_lWl__pzlm0&q=85&s=9a6f569569ac525d0f7cbfc9a00c98c8" width="995" height="623" data-path="images/platform-macos-accessibility.png" />
</Frame>

FocusMe **requires Accessibility permission** to detect which application is in the foreground and read window titles.

**To grant permission:**

1. Open **System Settings → Privacy & Security → Accessibility**
2. Click the lock icon to make changes
3. Enable **FocusMe** in the list
4. If FocusMe isn't listed, click **+** and add it from Applications

<Warning>Without Accessibility permission, FocusMe cannot detect or block applications. Website blocking via the browser extension will still work, but app blocking will not.</Warning>

### Supported Macs

FocusMe runs natively on:

* **Apple Silicon** (M1, M2, M3, M4) — native ARM build
* **Intel Macs** — native x86 build

The app ships as a universal binary, so it runs natively on both architectures without Rosetta.

**Minimum version:** macOS 12 (Monterey)

## macOS-Specific Behaviour

### Dock Integration

FocusMe can run as a background application (no Dock icon). Click the **menu bar icon** to access the app.

### Keeping FocusMe Running

FocusMe launches at login automatically. The app must be running for blocking to work — quitting the app disables blocking (unless protected).

### Browser Extension

Install the browser extension for the most reliable website blocking on macOS.

## Troubleshooting

### "FocusMe wants to control this computer"

This is the Accessibility permission prompt. You must grant it for app blocking to work. See setup instructions above.

### App blocking not working

1. Check Accessibility permission is granted
2. If you recently updated macOS, you may need to re-grant the permission
3. Restart FocusMe after granting permission

### FocusMe not starting at login

1. Open **System Settings → General → Login Items**
2. Add FocusMe to the list