## Introduction
Sonoran Radio's MacOS and Windows desktop applications offer direct integration with [Stream Deck hardware](https://www.elgato.com/us/en/p/stream-deck). By installing our official Stream Deck plugin, users can change channels, toggle preset channel groups, change channel and system volumes, and more - faster than ever before.
Don't have a physical Stream Deck? Download the [free Stream Deck Mobile app](https://www.elgato.com/us/en/s/stream-deck-mobile)!
## Installation
### 1. Download and Install the Plugin
[Download the official Sonoran Radio Stream Deck plugin from the Elgato Marketplace.](https://marketplace.elgato.com/product/sonoran-radio-6e959b5a-4cd3-40c8-b145-8eb1ea982fd5)
### 2. Configure Actions
Using the Stream Deck desktop application search for **Sonoran Radio** in the **Keys** and **Dials** sections.
Drag-and-drop an action category to the Stream Deck. Select the action to update the sub-type.
Ex: **Channel** key type > **Toggle XMIT Channels** > **Select Channels**
### 3. Optional: FiveM Integration
Each action can be configured to control the desktop app (default) or [FiveM in-game resource](https://docs.sonoransoftware.com/radio/tutorials/usage/in-game-radio).
For clients using the in-game radio in FiveM, simply toggle each action from **Desktop** to **FiveM**.
Sonoran Radio then acts as a local bridge between the Stream Deck, the desktop app, and the FiveM radio. The desktop app must be running, but does not have to have any radio community open or selected.
## Capabilities
### Keys
Channel Category Buttons
Channel actions allow you to do somethin
* **Next Group**
* **Previous Group**
* **Next Channel**
* **Previous Channel**
* **Toggle XMIT Channels**
* Select one or more channels
* Toggling this action will add and remove the selected channel(s) from your transmit list
* **Temporary XMIT Channel**
* Select a channel
* Pressing this action will temporarily transmit in the selected channel and return to your previous channel(s) after release
* **Toggle Scan Channels**
* Select one or more channels
* Toggling this action will add and remove the selected channel(s) from your scan list
Toggle Category Buttons
* **Push to Talk**
* **Toggle AI Mode**
* **Toggle Tone Board**
Audio Category Buttons
* **Volume Up**
* **Volume Down**
* **SFX Volume Up**
* **SFX Volume Down**
* **AI Volume Up**
* **AI Volume Down**
Desktop Category Buttons
* **Connected Users Overlay**
* **Focus Radio Overlay**
* **Toggle Radio Overlay**
### Dials
Stream Deck hardware with dials have the following supported actions:
Dial Options
* **Cycle Groups (Prev/Next)**
* **Cycle Channels (Prev/Next)**
* **Adjust Volume**
* Optional Press to Mute
* **Adjust SFX Volume**
* Optional Press to Mute
* **Adjust AI Volume**
* Optional Press to Mute
* **Adjust Current Channel Volume**
* Optional Press to Mute
### Developer Setup
If you are implementing the FiveM side yourself, use the documented developer contract here:
{% content-ref url="../../developer-documentation/developer-documentation/stream-deck-api" %}
[stream-deck-api](https://docs.sonoransoftware.com/radio/developer-documentation/developer-documentation/stream-deck-api)
{% endcontent-ref %}
---
# Agent Instructions: 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:
```
GET https://docs.sonoransoftware.com/radio/tutorials/integrations/stream-deck-plugin.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.
