> For the complete documentation index, see [llms.txt](https://docs.av-scripts.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.av-scripts.com/laptop-pack/music/miniplayer.md).

# Miniplayer

The Mini Player is a compact floating widget that appears on screen when the player connects to the **Headphones** device. It allows full playback control without opening the music app, so the player can keep playing while doing anything else in-game.

<figure><img src="/files/82b9a4OAo5fHi4RLiJNP" alt=""><figcaption></figcaption></figure>

***

### Activation

The Mini Player appears automatically when switching to the Headphones device from within the music app. It disappears when the headphones device is disconnected.

***

### What It Shows

The widget displays the current track's cover art, title, artist, a live progress bar with elapsed and total time, and a row of playback controls.

***

### Controls

| Button             | Action                                                                                                                                               |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| ⏮ Skip Back        | Goes to the previous track (or restarts the current one if past 3 seconds).                                                                          |
| ▶ / ⏸ Play / Pause | Toggles playback.                                                                                                                                    |
| ⏭ Skip Forward     | Advances to the next track in the queue.                                                                                                             |
| ☰ Queue            | Expands or collapses a mini queue panel below the player showing all upcoming tracks. The currently playing track is highlighted with a pulsing dot. |
| ⊘ Cursor Off       | Visible only when cursor mode is active. Deactivates the cursor without pressing the keybind.                                                        |

***

### Mouse / Cursor Mode

By default the Mini Player is visible but not interactive — game controls remain fully active. To interact with the player, the cursor mode must be toggled on.

**Default keybind: `F6`** (configurable in `config/_config.lua` via `Config.MouseKey`, and rebindable by each player from the GTA keybinds menu).

Pressing the key while the Mini Player is visible:

* **Activates** the cursor and locks camera movement, allowing the player to click buttons and drag the widget.

The **⊘ Cursor Off** button inside the widget also deactivates cursor mode — useful because `F6` does not fire while NUI focus is active.

***

### Repositioning

While cursor mode is active, the player can click and drag the header area of the Mini Player to reposition it anywhere on screen. The position is saved automatically when the drag ends and persists across sessions — the widget reappears in the same spot next time.