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

# Chirper Desktop

> Chirper on an in-game phone overlay for macOS and Windows.

Chirper Desktop puts Chirper Internet, Marketplace, and the Dark Web on a phone overlay that sits on top of your game, synced with your Discord server. It's free for macOS and Windows.

<Card title="Download Chirper Desktop" icon="download" href="https://chirper.app/desktop" horizontal>
  chirper.app/desktop
</Card>

***

## Downloading

Download Chirper Desktop from [chirper.app/desktop](https://chirper.app/desktop). The page recommends the right version for your device.

| Version | Use it if you have |
| - | - |
| **macOS (Apple silicon)** | An M-series Mac: M1, M2, M3, M4, or M5. |
| **macOS (Intel)** | An older Intel-based Mac. |
| **Windows** | A Windows laptop or PC. |

***

## Installing

Chirper Desktop is safe to install, but your browser and computer may warn you about it the first time. This happens because the app isn't signed by a paid publisher certificate yet. Follow the steps below to get past the warnings.

<Tabs>
  <Tab title="Windows">
    <Steps>
      <Step title="Keep the download">
        Your browser may say the file **isn't commonly downloaded** or **could harm your device**.

        * **Microsoft Edge:** Hover over the download, click **⋯**, then **Keep**. If asked again, click **Show more** → **Keep anyway**.
        * **Google Chrome:** Click **Keep** next to the download, then **Keep anyway**.
      </Step>

      <Step title="Open the installer">
        Open `chirper-windows.exe` from your Downloads folder.
      </Step>

      <Step title="Get past SmartScreen">
        If you see **Windows protected your PC**, click **More info**, then **Run anyway**.
      </Step>

      <Step title="Finish installing">
        Follow the installer. Chirper opens when it's done.
      </Step>
    </Steps>
  </Tab>

  <Tab title="macOS">
    <Steps>
      <Step title="Install the app">
        Open the `.dmg` you downloaded and drag **Chirper** into your **Applications** folder.
      </Step>

      <Step title="Open Chirper">
        Open **Chirper** from Applications. If macOS says it **can't be opened** or **can't verify** the app, click **Done** or **OK**.
      </Step>

      <Step title="Allow it in Privacy & Security">
        Open **System Settings** → **Privacy & Security**. Scroll down to the message about Chirper and click **Open Anyway**. Enter your password if asked.
      </Step>

      <Step title="Open it again">
        Open **Chirper** again and click **Open** to confirm.
      </Step>
    </Steps>
  </Tab>
</Tabs>

<Note>
  You only need to do this once. After that, Chirper opens normally and updates itself.
</Note>

<Warning>
  Only download Chirper Desktop from [chirper.app/desktop](https://chirper.app/desktop). Never run a copy someone sends you directly.
</Warning>

***

## Getting started

<Steps>
  <Step title="Open Chirper">
    Once it's installed, open **Chirper**.
  </Step>

  <Step title="Sign in with Discord">
    Chirper opens your browser so you can sign in with Discord. Once you're signed in, return to the app.
  </Step>

  <Step title="Pick your server">
    Open the **Chirper** app on the phone and choose your server.
  </Step>
</Steps>

<Note>
  Your server's admins can turn off posting from Chirper Desktop in the **Apps** section of the dashboard.
</Note>

***

## The phone

The overlay is a phone with its own apps.

| App | What it does |
| - | - |
| **Chirper** | Your server's feed, posts, notifications, and messages. |
| **Marketplace** | Browse and post listings. |
| **Dark Web** | Dark Web posts and listings. |
| **Camera** | Capture your Roblox window, or any other window, and attach it to a post. |
| **Photos** | Shots you've taken with the Camera. |
| **Notes** | Jot things down. |
| **Clock** | The time. |
| **Settings** | Change the phone's wallpaper and other options. |

***

## Showing and hiding the overlay

* **Minimize:** Tuck the phone into the small Chirper bubble when you need your screen back. Click the bubble to bring it back.
* **Shortcut:** Show or hide the overlay with a keyboard shortcut.

| Platform | Default shortcut |
| - | - |
| **macOS** | `Control` + `Option` + `C` |
| **Windows** | `Alt` + `Shift` + `C` |

You can change the shortcut in **Chirper Settings** → **Keyboard**.

***

## Opens with your game

Chirper can show itself automatically when Roblox opens, and hide again when you quit. Both are on by default.

Turn them on or off in **Chirper Settings** → **Auto-Open**:

* **Auto show:** Show the overlay when a game opens.
* **Auto hide:** Hide it when the game quits.

***

## Chirper Settings

Open **Chirper Settings** from Chirper's icon in your menu bar (macOS) or system tray (Windows). On macOS, you can also press `Command` + `,`.

| Section | What you can change |
| - | - |
| **Account** | See who you're signed in as. |
| **General** | **Open at login**, and **Show in menu bar** on macOS. |
| **Overlay** | Size, opacity, position, **Keep on top** of other windows, **Show over full-screen games**, and **Bubble size**. |
| **Keyboard** | The shortcut to show or hide the overlay. |
| **Auto-Open** | **Auto show** and **Auto hide** with your game. |
| **Rendering** | **Hardware acceleration**. Changing it needs a restart. |

The same menu has **Show Overlay**, **Check for Updates**, and **Quit Chirper**.

***

<Card title="Need help?" icon="headset" href="https://chirper.app/support">
  Still have questions? Join our Discord server and open a support ticket for help from the Chirper team.
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.