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

# Mango Radio

A complete replacement for GTA V's vehicle radio — a cinematic station carousel, a full infotainment browser, real transmitter range, and your own server-hosted station synced to every player.

<figure><img src="https://3694989814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6edDnCRamvDxPx0AsLch%2Fuploads%2FikqVzP8zvvDUEZA0eQnG%2Fimage-1786179927626.png?alt=media&amp;token=69d9d4b4-a0f4-4845-99ef-761e01deecad" alt=""><figcaption></figcaption></figure>

> **Not a radio menu — a radio system.** Every station your players already know, presented the way GTA should have done it, plus one station that is entirely yours.

Mango Radio replaces the stock radio wheel with two surfaces that work together. A **quick carousel** rides at the top of the screen for instant station changes without ever taking your hands off the wheel, and a **full station browser** slides in as an angled infotainment panel when you want to browse, favourite and read what's playing.

Underneath it is the real GTA radio the whole time — the same stations, the same audio, no streaming, no duplicate playback. On top of that sit the things GTA never gave you: **real transmitter coverage** so a local station fades into static as you leave its county, **artist and song titles** for over a thousand tracks, **per-player favourites** that survive reconnects, and a **server-hosted station** playing your own music, in perfect sync for everyone listening.

* **Two surfaces, one radio** — carousel and browser stay in lockstep with each other and with any other script
* **Zero idle cost** — no threads, loops or NUI work unless you are in a vehicle
* **Nothing hardcoded** — keys, colours, positions, stations, coverage and artwork are all config
* **Standalone** — no framework, no dependencies, no database

## At a glance

|                  |                                                    |
| ---------------- | -------------------------------------------------- |
| **Framework**    | Standalone — ESX, QBCore, Qbox or none at all      |
| **Dependencies** | None. No database, no SQL                          |
| **Default keys** | `Q` carousel · `G` station browser · `F` favourite |
| **Stations**     | Every base-game and DLC station, plus your own     |
| **Song titles**  | 1056 tracks, bundled                               |
| **Idle cost**    | Nothing runs until you are in a vehicle            |

## Start here

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Installation</strong></td><td>Drop it in, ensure it, done.</td><td><a href="/mango5m-docs/resources/mango-radio/getting-started/installation.md">Installation</a></td></tr><tr><td><strong>Quick Start</strong></td><td>Your first drive, in two minutes.</td><td><a href="/mango5m-docs/resources/mango-radio/getting-started/quick-start.md">Quick Start</a></td></tr><tr><td><strong>Configuration</strong></td><td>Every option, explained.</td><td><a href="/mango5m-docs/resources/mango-radio/configuration.md">Configuration</a></td></tr></tbody></table>

## What's inside

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>The Carousel</strong></td><td>Tap to skip, hold to browse.</td><td><a href="/mango5m-docs/resources/mango-radio/features/the-carousel.md">The Carousel</a></td></tr><tr><td><strong>The Station Browser</strong></td><td>The 3D infotainment panel.</td><td><a href="/mango5m-docs/resources/mango-radio/features/the-station-browser.md">The Station Browser</a></td></tr><tr><td><strong>Media Player</strong></td><td>Your own station, synced.</td><td><a href="/mango5m-docs/resources/mango-radio/media-player.md">Media Player</a></td></tr><tr><td><strong>Broadcast Range</strong></td><td>Drive out of range, get static.</td><td><a href="/mango5m-docs/resources/mango-radio/features/broadcast-range.md">Broadcast Range</a></td></tr></tbody></table>

## The two surfaces

**The carousel** is the fast one. Tap the radio key and you skip a station instantly, with a brief flash of artwork and the song title. Hold it and the carousel opens properly: the station you are on sits enlarged in the centre, its neighbours shrink and fade away to either side, and moving the mouse skims through them. Let go and whatever is centred becomes your station. You keep steering the whole time.

**The station browser** is the considered one. It slides in from the right as an angled panel — status strip, station artwork, now playing, transport controls, and the full list of stations with hearts and genres. By default it is driven entirely by the keyboard so nothing ever takes the mouse away from driving.

## Built on the real radio

Everything you hear is GTA's own radio. Mango Radio never streams a station, never duplicates audio and never fights the game for control. It disables the stock radio wheel while you are in a vehicle, tracks what is actually playing through the game's own natives, and follows along if another script changes the station behind its back.

The one exception is the [Media Player](/mango5m-docs/resources/mango-radio/media-player.md) — the station your server hosts itself. That one plays your audio files, scheduled by the server so that every listener hears the same song at the same moment.

{% hint style="info" %}
Mango Radio is standalone. It does not need ESX, QBCore, Qbox or a database — favourites persist through FiveM's own per-player storage.
{% endhint %}

## If something looks wrong

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Troubleshooting</strong></td><td>Symptoms, causes and fixes.</td><td><a href="/mango5m-docs/resources/mango-radio/reference/troubleshooting.md">Troubleshooting</a></td></tr><tr><td><strong>Commands</strong></td><td>Diagnostics that answer most questions faster than reading.</td><td><a href="/mango5m-docs/resources/mango-radio/reference/commands.md">Commands</a></td></tr><tr><td><strong>Performance</strong></td><td>What runs, and when.</td><td><a href="/mango5m-docs/resources/mango-radio/reference/performance.md">Performance</a></td></tr></tbody></table>