# Using the In-Game Radio {% embed url="" %} ## Initial Setup ### Displaying the In-Game Radio By default, the radio display remains visible on-screen at all times. Users can toggle focus on the radio, enabling interaction when needed and un-focusing when done. 1. Use the [customizable keybind](#setting-your-push-to-talk-ptt-keybind) (Default is `~` right above tab) 2. Use the `/radio` command Access to the radio can be restricted with [ACE permissions](https://docs.sonoransoftware.com/radio/tutorials/usage/in-game-radio/configuring-ace-permissions). ### Hiding the In-Game Radio #### A. Via Button Use the purple button or icon on the radio frames:

#### B. Via Command Use the `/radio hide` command in-game to hide the radio. #### C. ESC Options You can also [customize the display behavior when pressing `ESC`](#escape-mode). ### Logging In

When you first use the in-game resource, you'll need to log in.\ A 4-digit code will appear for you to sign in from your browser.

Open [sradio.link](https://sradio.link) in a web browser, log in if needed, enter your code, and click "Activate" to log in to the game.

When you first use the in-game resource, you'll need to log in.\ If your community has ACE permissions configured, no account creation or link is necessary.

Select **Login as guest** to bypass the account link and start using your radio. This guest option will only display if `acePermsForGuests` is set to `true`. ### Permission Configuration Learn how to [configure ACE permissions for the radio](https://docs.sonoransoftware.com/radio/tutorials/usage/configuring-ace-permissions#ace-permission-sync). ### Display Name Custom display names are saved locally in your cache and automatically restored on future guest logins. Guest usernames are set in the following priority order (whichever is found first): * Last used guest display name * [Custom framework function](https://docs.sonoransoftware.com/radio/developer-documentation/developer-documentation/resource-events#guest-display-names) * First and last name from QBCore, QBox, or ESX. * In-game display name [Users with permission can change this name](https://docs.sonoransoftware.com/radio/tutorials/dispatch-panel/using-the-dispatch-panel#display-names).

### Logging Out You can logout/un-link your in-game radio via the settings menu (gear icon).

*** ## Using the In-Game Radio ### Setting your Push-To-Talk (PTT) Keybind [You can customize your PTT button in your GTA Settings.](https://docs.sonoransoftware.com/radio/tutorials/usage/in-game-radio/using-the-in-game-radio/fivem-keybinds-and-commands) ### Connecting and Switching Channels

Channel Selection via Knob

The radio will connect when you turn it on with the power button ([unless you need to login first](#logging-in)). **Previous/Next Channel (In Group)** * Left click the top knob to rotate to the next channel inside the channel group. **Previous/Next Group** * Right-click the top knob to change its mode from channel changing to group changing. * Left click the top knob to rotate to the next channel group. Sonoran Radio: Power Button

Channel Selection via Menu

Select the channel menu icon to open the channel selection options. Click on the channel you wish to transmit on. `CTRL` + `Click` allows you to select multiple channels to transmit on at once.

Channel Selection via Hotkeys, Commands, and Stream Deck

Channels can also be changed via: * [Channel Change Keybind](https://docs.sonoransoftware.com/radio/tutorials/usage/in-game-radio/fivem-keybinds-and-commands#prev-next-channel-in-group) * [In-Game Commands (Optional Stream Deck Integration)](https://docs.sonoransoftware.com/radio/tutorials/usage/in-game-radio/fivem-keybinds-and-commands#fivem-client-commands)

### Channel Scanning/Listening

Scanning Radio Channels

Scanning a radio channel allows users to hear all transmissions, even if they are not actively transmitting on that channel. However, transmissions on the primary channel (the one you are actively talking on) will take priority, muting transmissions from scanned channels whenever someone speaks on the primary channel. #### Selecting Scanned Channels ([Modern or Text Display](https://docs.sonoransoftware.com/radio/tutorials/usage/customizing-radio-frames#screen-styles)) 1. Select the Channel Scan Icon 2. Select the channel group to view the contained channels 3. Click on a channel to toggle on/off scanning [Learn how to toggle a channel scan via command or Stream Deck!](https://docs.sonoransoftware.com/radio/tutorials/usage/in-game-radio/fivem-keybinds-and-commands#toggle-channel-scan) ![](https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2F7YXZa3ZdLagv5sy3R3Yv%2Fimage.png?alt=media\&token=64416424-d03c-47d2-b990-16fdfa45a2a1)![](https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2Fp8wQx13UA1ZmCJFg4Nku%2Fimage.png?alt=media\&token=250f5513-1d40-4155-ab8b-05b997325ab3) Users can also [create a scan list](#scan-lists) to swap between multiple scanned channels at once.

### Custom Scan Lists

Scan Lists

Users can scan one or more channels to listen without transmitting. For monitoring multiple channels, "Scan Lists" let users group channels and easily switch between them. #### Creating a Scan List ([Modern or Text Display](https://docs.sonoransoftware.com/radio/tutorials/usage/customizing-radio-frames#screen-styles)) 1. Toggle scanning on one or more channels. 2. Select the `+` icon next to `Scan Lists` to create a new scan list with the current selection. 3. Scan lists can be reordered via drag-and-drop. 4. Select the adjust button to rename or remove the scan list. 5. Click on the scan list to scan all of the channels inside of it. 6. Scan lists can be reordered via drag-and-drop [Learn how to toggle a scan list via command or Stream Deck](https://docs.sonoransoftware.com/radio/tutorials/usage/in-game-radio/fivem-keybinds-and-commands#toggle-scan-list)! ![](https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FjvoVIdqrC6eTg5D6PdgQ%2Fimage.png?alt=media\&token=bf54feac-b279-4c78-9f6d-672cbb2e4543)![](https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FX6nAX9Yx2K2oZBPcyrKe%2Fimage.png?alt=media\&token=2e9bf929-1cbb-4b99-8a93-5c2d1340a037)

### Adjust Volume {% hint style="info" %} Your radio volume also controls how loudly [nearby users hear the radio chatter](https://docs.sonoransoftware.com/radio/tutorials/usage/in-game-radio/hear-nearby-radio-chatter). {% endhint %}

Radio Volume

#### System-Wide Volume In the settings menu (gear icon) you can adjust the radio's total volume output. In-Game Radio - Settings

![](https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FdwaKgun7UGHXSI7KQmbf%2Fimage.png?alt=media\&token=1e9de9fa-3bae-454c-9f5a-1efa95077999) #### Per-User Volume You can also right-click on any user to adjust their volume specifically. In-Game Radio - Per-User Volume

#### Per-Channel Volume Select the volume icon to change the current channel's transmission volume.

#### Volume Hotkey [You can also use the in-game keybind to quickly adjust volume.](https://docs.sonoransoftware.com/radio/tutorials/usage/in-game-radio/fivem-keybinds-and-commands#volume-up-down) The adjustment amount is customizable in the settings menu. ![](https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2Fg5ke2tQskfelg9nTZPpl%2Fimage.png?alt=media\&token=55f322fc-bae7-44f2-a836-91d06422f21e)

### Adjust Volume With Sirens

Automatic Volume Increase w/Sirens

When in-game, turning on your sirens will increase your overall radio volume by the configured amount. Turning your sirens back off will lower the volume back down. This feature is automatically integrated with [Luxart Vehicle Control](https://github.com/TrevorBarns/luxart-vehicle-control).\ If the resource is not named `LVC`, the [`config.luxartResourceName` value must be updated](https://docs.sonoransoftware.com/radio/getting-started/installing-the-in-game-resource#updates). For communities not using LVC, the functionality will fall back to a FiveM native that will trigger the functionality if either lights or sirens are activated. ![](https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FcQPS6uPDRrZCzgiG8fvf%2Fimage.png?alt=media\&token=2ad6b30f-3135-4e83-84c3-76d41a6bf1b8)

### Move and Resize the Radio {% hint style="info" %} **If you move your radio too far off of your screen:** Use `/radio reset` to reset the size and position. {% endhint %}

Radio Move and Resize

On the radio screen, open the `Settings` modal by pressing the gear icon. Select `Move/Resize` * Click and drag the radio to change it's position on your screen. * Hold `ctrl` and drag to resize the radio. * Press `esc` to save the new size and position. In-Game Radio - Settings

### Escape Mode

ESC Radio Display Behavior

The Escape Mode selector changes the in-game radio display behavior after pressing `ESC`.\ The server default for this setting can be configured in the [config's `defaultEscapeMode` property](https://docs.sonoransoftware.com/radio/getting-started/installing-the-in-game-resource#updates). `Keep Radio Visible` * The radio stays visible on `ESC` `Hide Radio` * The radio closes on `ESC` `XMITT (PTT)` * The radio closes on `ESC`, but is visible while transmitting ![](https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FDolStOnTRi5HrAwsnCQe%2Fimage.png?alt=media\&token=00f0570f-fa02-4c11-835d-7815a3740172)

### Panic

In-Game Panic

Pressing the orange panic button on the in-game radio toggles your panic status. This can also toggle your panic status in [Sonoran CAD](https://docs.sonoransoftware.com/radio/integrations/sonoran-cad-integration#cad-panic). [Dispatchers will also be able to see and clear your panic status.](https://docs.sonoransoftware.com/radio/tutorials/dispatch-panel/using-the-dispatch-panel#unit-panic) Sonoran Radio has a [configurable option](https://docs.sonoransoftware.com/radio/getting-started/installing-the-in-game-resource#updates) to automatically press a users PTT button for a configurable amount of time when the user presses their radio panic button: ```lua Config.autoPttOnPanic = { enabled = true, -- Enable automatic PTT when panic button is pressed duration = 15 -- Duration in seconds to hold PTT when panic button is pressed } ``` ![](https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FcAvYNxqRtnpUWpiMfZ6I%2Fimage.png?alt=media\&token=16d4eeb2-45b7-47b5-85e2-d8bd949d52c6)

### Display Names

Update User Display Name

[View several different methods to update a user's display name in the radio.](https://docs.sonoransoftware.com/radio/tutorials/dispatch-panel/using-the-dispatch-panel#display-names)

### Radio Types Sonoran Radio offers three radio platforms: handheld, top-down HUD, and vehicle.\ All three radio platforms can have [customizable frame styles](#change-radio-frames).

When opening the radio via `/radio` the handheld radio will display on-screen.\ The vehicle UI will display when opening the radio inside of a vehicle.\ The top-down HUD style can be viewed with the `/radiohud` command. ### Change Radio Frames The settings menu also allows you to customize your radio frame:

Learn more about customizable radio frames: {% content-ref url="customizing-radio-frames" %} [customizing-radio-frames](https://docs.sonoransoftware.com/radio/tutorials/usage/in-game-radio/customizing-radio-frames) {% endcontent-ref %} ## Civilian Usage ### Placing an Emergency (911) Call Civilians can place an emergency call to speak directly with dispatchers: {% content-ref url="../dispatch-panel/emergency-calls" %} [emergency-calls](https://docs.sonoransoftware.com/radio/tutorials/usage/dispatch-panel/emergency-calls) {% endcontent-ref %} ## Custom Animations Unlock multiple more custom radio animations, FREE with Sonoran Radio pro!

{% content-ref url="../../integrations/big-daddy-radio-animations" %} [big-daddy-radio-animations](https://docs.sonoransoftware.com/radio/tutorials/integrations/big-daddy-radio-animations) {% endcontent-ref %}