> For the complete documentation index, see [llms.txt](https://f4-studio.gitbook.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://f4-studio.gitbook.io/documentation/resources/f4-radio.md).

# f4-radio

A handheld touch-screen radio for FiveM: three channels at once, private frequencies with owners and passwords, an on-screen display and an admin panel.

f4-radio puts a real handheld radio in your players' hands. They connect to a frequency on its touch screen, hold one key and talk on every channel they are on at the same time, while hearing all of them together. A police officer sits on the department channel, the joint channel with EMS and a private one with their partner; a crew runs its own locked frequency that nobody finds by accident.

![F4 Radio](https://1863957031-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZWRXRhAaL8WMQT8WqFJi%2Fuploads%2FQE8w1TkmYkXvLKQkdKs0%2Ff4-radio-thumbnail-steel.jpg?alt=media)

Who is talking is always visible: an on-screen display lists every member of every channel, and a name lights up the moment that person keys the mic.

It runs on pma-voice, mumble-voip or SaltyChat, on Qbox, QBCore, ESX and standalone.

## What is in it

| Area                       | What it covers                                                                                                                                                              |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Three channels at once** | Every channel takes a slot (S1, S2, S3). All of them are heard together.                                                                                                    |
| **One key to talk**        | Caps Lock talks on every connected channel with transmit on. Each slot can have its own key to talk on that channel only.                                                   |
| **The device**             | A touch screen with Channels, Connect, Saved and Settings tabs, plus power, home and back keys, a channel knob, a volume knob, a side talk key and an orange emergency key. |
| **Job channels**           | Fixed frequencies tied to jobs or gangs, with minimum grades and an optional on-duty rule. One tap connects.                                                                |
| **Player channels**        | The first player on a frequency owns it. Owners set a name and password, kick members and hand over ownership.                                                              |
| **Your own mix**           | Talk and listen per channel, a volume per channel, and mute any person just for yourself.                                                                                   |
| **Emergency key**          | Pressed twice, it sends a banner, a sound and a map blip with your location to the whole channel.                                                                           |
| **On-screen display**      | Every member of every channel. Drag each channel anywhere, collapse it, or show only who is talking.                                                                        |
| **Callsigns**              | A callsign like 1-ADAM-12 next to the name in member lists.                                                                                                                 |
| **The look**               | 6 screen colours, 4 body colours including a yellow ATEX version, device size and position, per player.                                                                     |
| **Animations**             | A hand on the shoulder mic or the radio raised to the mouth, with a radio prop.                                                                                             |
| **Admin panel**            | Every live channel and who is on air, with kick, close, rename, remove password, change owner and a full activity log.                                                      |
| **Saving**                 | Channels live in the server's memory and disappear with their last member. Each player's settings are kept on their own client. No database needed.                         |
| **Languages**              | English and Turkish.                                                                                                                                                        |

{% hint style="info" %}
Voice never passes through the game server. The server decides who is on which channel and checks every change; the audio itself travels through your voice resource.
{% endhint %}

## Where to start

* [Requirements](/documentation/resources/f4-radio/getting-started/requirements.md) — what the server needs.
* [Installation](/documentation/resources/f4-radio/getting-started/installation.md) — the folder, the start order and the admin permission.
* [Voice Resources](/documentation/resources/f4-radio/getting-started/voice-resources.md) — the one setting your voice resource needs.
* [Channels](/documentation/resources/f4-radio/configuration/channels.md) — your job channels and who may join them.
* [Hooks and Events](/documentation/resources/f4-radio/developers/hooks-and-events.md) — react to the radio from your own resources.