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

# 📻  Boombox

iKCScripts Boombox is a premium placeable music system for FiveM that brings synchronized positional music anywhere in your server.

<figure><img src="https://404495250-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQVsChykUEp6s5ZpiAtpK%2Fuploads%2F9bPT0KZPdJYZBBEN33Ji%2Fboombox.avif?alt=media&amp;token=85d9bea2-cdd0-4438-89a1-f41d1f75959f" alt="iKCScripts Boombox"><figcaption><p>iKCScripts Boombox</p></figcaption></figure>

Citizens can place a physical boombox in the world, play supported music URLs, build queues and playlists, manage playback history, share playlists with nearby friends, and control who has access all through a polished in-game interface.

The Boombox is designed with server-authoritative placement, exact entity interaction, persistent storage, and flexible inventory and interaction integrations.

***

### ✨ Highlights

* 📻 Placeable and recoverable physical Boombox
* 🔊 Synchronized positional audio with natural distance fading
* ▶️ Play supported YouTube and compatible direct-audio URLs
* 📋 Full queue management and track reordering
* 🎶 Persistent personal playlists
* 🤝 Share playlists with nearby citizens
* 🕘 Persistent personal playback history
* 👥 Trusted Friends access system
* 🌎 Optional **Others Around** controls
* 🔒 Owner-only pickup and ownership protection
* 💾 Persistent placed Boomboxes across server restarts
* 🎚️ Volume controls with Page Up and Page Down keybinds
* 🔁 Loop and shuffle controls
* ⏩ Seek, previous, next, play, pause, and stop controls
* 🖥️ Polished in-game music interface
* ⚙️ Multiple inventory and interaction integrations
* 🛡️ Server-side validation for protected actions

***

### 🚀 Quick Start

Setting up iKCScripts Boombox is straightforward.

#### 1. Review Requirements

Make sure the required dependencies are installed and review the supported inventory and interaction integrations.

→ **✅** [**Requirements**](/docs/boombox/getting-started/requirements.md)

#### 2. Install the Resource

Add the resource to your server, install the Boombox inventory item, and configure your selected integrations.

→ **📥** [**Installation**](/docs/boombox/getting-started/installation.md)

#### 3. Configure the Resource

Adjust audio distance, interaction distance, volume limits, permissions, keybinds, inventory integration, interaction system, and other available options.

→ **⚙️** [**Configuration**](/docs/boombox/configuration.md)

#### 4. Test Before Launch

Before making the resource available to your community, test:

* Boombox placement and pickup
* Opening and closing the interface
* Music playback
* Positional audio
* Queue controls
* Playlists
* History
* Others Around
* Trusted Friends
* Server restart persistence

{% hint style="success" %}
Once installation and configuration are complete, the Boombox is ready to be placed and used in-game.
{% endhint %}

***

### 📻 Using the Boombox

The **Using the Boombox** section explains the main in-game functionality:

* 📍 [Placement & Pickup](/docs/boombox/using-the-boombox/placement-and-pickup.md)
* 🎛️ [Opening & Controls](/docs/boombox/using-the-boombox/opening-and-controls.md)
* 👥 [Others Around](/docs/boombox/using-the-boombox/others-around.md)

Start here if you want to learn how citizens interact with a Boombox in-game.

***

### 🎵 Features

Explore the music and permission systems included with the Boombox:

* 🔊 [Positional Audio](/docs/boombox/features/positional-audio.md)
* 📋 [Queue](/docs/boombox/features/queue.md)
* 🎶 [Playlists](/docs/boombox/features/playlists.md)
* 🕘 [History](/docs/boombox/features/history.md)
* 👥 [Trusted Friends](/docs/boombox/features/trusted-friends.md)

Each section explains how the feature works and how it is used in-game.

***

### 🛠️ Help

Need additional information or troubleshooting?

The **Help** section includes:

* 🔗 [Supported URLs](/docs/boombox/help/supported-urls.md)
* 🧰 [Troubleshooting](/docs/boombox/help/troubleshooting.md)
* 🛡️ [Asset Escrow](/docs/boombox/help/asset-escrow.md)
* 💬 [Support](/docs/boombox/help/support.md)

{% hint style="info" %}
For general iKCScripts assistance, Discord information, and official purchasing links, visit the main **💬 Support** section of the iKCScripts Documentation.
{% endhint %}

***

#### 📻 Music Anywhere.

Place it. Play it. Share it.

**iKCScripts Boombox**