> For the complete documentation index, see [llms.txt](https://docs.sonoransoftware.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sonoransoftware.com/radio/tutorials/usage/desktop-overlay.md).

# Desktop App & Overlay

Use the Sonoran Radio desktop overlay while playing any game.

The desktop app provides an overlay for **FiveM, Arma 3, Roblox, and other games**. Keep radio controls visible while you play.

## Open the Overlay

1. [Download and open the desktop app](/radio/download-the-app.md).
2. Join your Radio community and connect to a channel.
3. Select the **Overlay** tab at the top, beside **Dispatch**.
4. Position the radio over your game window.

<figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2Fgit-blob-4ec3601f339f52d9461b0cf36af630fbc88944c5%2Foverlay-top-navigation.png?alt=media" alt="Sonoran Radio top navigation with the Overlay tab immediately to the right of Dispatch"><figcaption><p>The Overlay tab is beside Dispatch in the top navigation. Use the desktop app to open it; the website displays it disabled.</p></figcaption></figure>

On the website, the tab is disabled; its tooltip explains that the desktop app is required. The mobile app hides the tab.

To return to the main panel, use the radio's power button or **Return to Portal**.

## Game Signal

The overlay displays signal supplied by supported game integrations. For location-based signal, complete the [ER:LC setup](/radio/game-integrations/roblox/erlc-setup.md) or [Arma 3 installation](/radio/game-integrations/arma-3/install-and-connect.md), then configure that game's towers.

<figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2Fgit-blob-3ea1c1deabdb7973007b7f24ff1459db991d070f%2Fradio-signal.png?alt=media" alt="Sonoran Radio desktop overlay with a selected channel, connected users, and signal bars"><figcaption><p>Signal bars show the coverage supplied by your game integration.</p></figcaption></figure>

## Overlay Controls

<details>

<summary>Hotkeys</summary>

1. Open **Settings** > **Hotkeys** on the overlay.
2. Select the button beside **Toggle Desktop Radio** and press your preferred key to hide or show the overlay.
3. Set **Focus Desktop Radio** the same way to interact with the radio while playing in fullscreen.

Set **PTT Hotkey** to your preferred push-to-talk key.

<figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2Fgit-blob-3a68164d63650cf0a18b73d76bd5479dc519a072%2Foverlay-hotkeys.png?alt=media" alt="Hotkeys settings showing PTT Hotkey, Focus Desktop Radio, and Toggle Desktop Radio"><figcaption><p>Example hotkeys; choose keys that do not conflict with your game.</p></figcaption></figure>

</details>

<details>

<summary>Move or resize the radio</summary>

Drag the radio body to move it. To resize the whole overlay, drag a corner, or hold **Ctrl** while dragging the body: up enlarges and down shrinks.

A brief resize hint appears when the overlay opens and when you hover or focus a resize corner. There is no permanent resize button, and hovering over the radio screen does not repeatedly show the hint.

</details>

<details>

<summary>Change the radio frame</summary>

1. Open **Settings** > **Audio** on the overlay.
2. Open **Radio Frame**.
3. Select a frame provided by your community.

<figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2Fgit-blob-87f218e940655791b7d197e0ba40c7a1f3b06761%2Fradio-frame-selector.png?alt=media" alt="Audio settings with the Radio Frame dropdown open"><figcaption><p>Select a community frame from the Radio Frame dropdown.</p></figcaption></figure>

Arma 3 can select a frame based on your inventory radio. See [Radio Items and Team Frames](/radio/game-integrations/arma-3/radio-items-and-team-frames.md).

</details>

<details>

<summary>Upload custom desktop frames</summary>

Uploading custom frame artwork requires **Pro**.

1. In your community's admin panel, open **Customization** > **Desktop Frames**.
2. Upload the frame image.
3. Position its buttons. Drag the screen to move it or drag its corners to resize its bounds, then save. This changes the community frame layout, not just the overlay's on-screen size.

<figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FaljX7z68P4u61eqVBGb9%2Fimage.png?alt=media&amp;token=939202bc-181b-4e0c-bdf6-64444a037a56" alt="Desktop Frames editor"><figcaption></figcaption></figure>

</details>

## Arma display and focus

Use **Fullscreen Window** in Arma's video settings so the desktop overlay can remain visible. If Arma freezes or pauses when you focus the overlay, enable **No Pause** in the Arma launcher or add `-noPause` to its launch parameters. Return focus to the game to resume game input; these options do not make the game and overlay simultaneously receive the same keyboard input.

See [Arma installation](/radio/game-integrations/arma-3/install-and-connect.md) for community-wide bridge, signal, and AI-hearing settings. These controls are not in Dispatch's per-user settings.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.sonoransoftware.com/radio/tutorials/usage/desktop-overlay.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
