# TB Speaker
TB Speaker is a simple FiveM speaker system that lets players place props, attach them to vehicles or world objects, and play music from YouTube.
This is made for players who want:
- a custom speaker prop to place in the world
- a small radio UI for playing songs
- saved songs they can reuse later
- up to 4 speakers per player
---
## What it does
- Lets players open a menu and choose a speaker prop
- Places the speaker in the world with controls
- Supports attaching speakers to vehicles and props
- Plays streamed audio from YouTube
- Saves each player's song URLs/titles separately in `songs.json`
- Lets players pause, resume, stop, remove, and adjust volume
---
## Quick Start
1. Put this resource in your FiveM `resources` folder.
2. Make sure `ox_lib` is installed and started before this resource.
3. Add this to your `server.cfg`:
```cfg
ensure ox_lib
ensure tb_speaker
```
4. Restart the server or restart the resource.
---
## Main commands
| Command | Purpose |
| --- | --- |
| `/speakerprops` | Open the speaker prop menu and place a new speaker |
| `/speaker` | Open the radio control menu for your placed speaker |
---
## How to place a speaker
1. Type `/speakerprops`
2. Pick a speaker prop in the menu
3. Aim at the ground, vehicle, truck bed, or prop
4. Use the placement controls to move/rotate it
5. Press `E` to confirm
### Placement controls
| Key | Action |
| --- | --- |
| `E` | Confirm placement |
| `Backspace` | Cancel placement |
| Left / Right arrows | Rotate |
| Up / Down arrows | Move up/down |
| `PageUp` | Move left |
| `PageDown` | Move right |
Each player can place up to 4 speakers.
---
## How to use the radio
Once you have a speaker placed:
1. Type `/speaker`
2. Paste a YouTube link
3. Add a song name if you want
4. Click `Play song`
You can also:
- save songs
- choose from saved songs
- pause/resume
- stop playback
- remove the speaker
- change the volume