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

# Installation

> Install ShareCursor on macOS and Windows, and get past the one-time unsigned-app warning.

ShareCursor is **free and open source**. The builds are **not signed with a paid
Apple/Microsoft certificate**, so your OS shows a one-time warning the first time
you launch it. The app is completely safe — it's the same code you can read in
[the repo](https://github.com/phun333/ShareCursor) — and getting past the warning
takes a few seconds.

## Package managers (fastest)

<CodeGroup>
  ```bash macOS (Homebrew) theme={null}
  brew install --cask phun333/tap/sharecursor
  # if macOS still blocks it:
  xattr -cr "/Applications/ShareCursor.app"
  ```

  ```powershell Windows (Scoop) theme={null}
  scoop install https://github.com/phun333/ShareCursor/releases/latest/download/sharecursor.json
  ```
</CodeGroup>

Prefer manual installers? Grab them from the [**Download page**](/download).

## macOS

<Steps>
  <Step title="Install">
    Download `ShareCursor-*.dmg` from the [Download page](/download), open it, and
    drag **ShareCursor** onto the **Applications** folder.
  </Step>

  <Step title="Get past Gatekeeper">
    <Tabs>
      <Tab title="Right-click Open">
        1. Open **Applications** (Finder → Go → Applications).
        2. **Right-click** (or Control-click) **ShareCursor** → **Open**.
        3. Click **Open** again in the dialog.
      </Tab>

      <Tab title="&#x22;App is damaged&#x22; fix">
        On macOS Sequoia and newer, the right-click option may be missing or you
        may see *"the app is damaged"*. Remove the quarantine flag from Terminal:

        ```bash theme={null}
        xattr -cr /Applications/ShareCursor.app
        ```

        Then open the app normally. You won't see the warning again.
      </Tab>

      <Tab title="System Settings">
        1. Double-click ShareCursor — it gets blocked.
        2. Open **System Settings → Privacy & Security**.
        3. In the **Security** section, click **Open Anyway** next to
           *"ShareCursor was blocked…"* and confirm with Touch ID / password.
      </Tab>
    </Tabs>
  </Step>

  <Step title="Grant input permissions (required)">
    ShareCursor moves your mouse & keyboard, so macOS requires two permissions.
    In **System Settings → Privacy & Security**:

    * **Accessibility** → enable **ShareCursor**
    * **Input Monitoring** → enable **ShareCursor**

    <Warning>
      Quit and relaunch ShareCursor after granting the permissions, or input
      capture/injection won't work.
    </Warning>
  </Step>
</Steps>

## Windows

<Steps>
  <Step title="Install">
    Download `ShareCursor-Setup-*.exe` from the [Download page](/download) and run
    it. **No administrator rights needed** — it installs just for you.
  </Step>

  <Step title="Get past SmartScreen">
    If Windows shows **"Windows protected your PC"**: click **More info** →
    **Run anyway**. This only appears once.
  </Step>

  <Step title="Allow through the firewall">
    On first `serve` / `connect`, **Windows Defender Firewall** asks to allow
    ShareCursor. Tick **Private networks** and click **Allow access** (port
    24800\).
  </Step>
</Steps>

## Why the warnings? Is it safe?

<AccordionGroup>
  <Accordion title="Why does my OS warn me?" icon="circle-question">
    Apple and Microsoft charge for the certificates that make these warnings go
    away (Apple: $99/yr + notarization; Windows: ~$200+/yr EV certificate).
    ShareCursor doesn't pay for them yet, so the OS can't verify a paid developer
    identity — hence the one-time warning that every small open-source app gets.
  </Accordion>

  <Accordion title="Is it actually safe?" icon="shield-check">
    Yes. Every line is in the public repo, and every release is built by public
    CI (`.github/workflows/release.yml`), so you can verify exactly what you're
    running. The steps above are the standard, safe way to run trusted unsigned
    open-source software.
  </Accordion>

  <Accordion title="Can I build it myself instead?" icon="hammer">
    Absolutely — compile from source for zero warnings and full control. See the
    [Development guide](/develop/development).
  </Accordion>
</AccordionGroup>

## Uninstall

<CodeGroup>
  ```text macOS theme={null}
  Drag ShareCursor.app from Applications to the Trash.
  Config lives at ~/Library/Application Support/sharecursor/
  ```

  ```text Windows theme={null}
  Settings → Apps → ShareCursor → Uninstall.
  Config lives at %APPDATA%\sharecursor\
  ```
</CodeGroup>

## Next

<Card title="Quickstart" icon="rocket" href="/quickstart" horizontal>
  Now share your mouse & keyboard in 60 seconds.
</Card>