> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beatpass.ca/llms.txt
> Use this file to discover all available pages before exploring further.

# Player Controls

> Playback buttons and secondary player actions on BeatPass across desktop and mobile.

The BeatPass player provides core playback controls everywhere, then shows additional actions depending on screen size, instance settings, and the cued track.

## Core Playback Controls

| Control          | What it does                                  |
| ---------------- | --------------------------------------------- |
| **Play / Pause** | Starts or pauses the current item.            |
| **Previous**     | Moves to the previous item in the queue.      |
| **Next**         | Skips forward in the queue.                   |
| **Shuffle**      | Randomizes queue order.                       |
| **Repeat**       | Cycles repeat behavior for the current queue. |
| **Seekbar**      | Jumps to a position in the current track.     |

## Desktop Player Layout

The persistent bottom bar is split into three areas:

| Area       | Contents                                                                                                           |
| ---------- | ------------------------------------------------------------------------------------------------------------------ |
| **Left**   | Track image (circular, linked), track name, artist links, and a **Like** button (hidden below medium breakpoints). |
| **Center** | Playback controls plus the main seekbar (max width \~722 px).                                                      |
| **Right**  | **Download**, **Queue** toggle. On larger screens: **Lyrics**, **Volume**, and **Expand**.                         |

### Responsive visibility

| Control              | Minimum screen width                                         |
| -------------------- | ------------------------------------------------------------ |
| **Like** (left area) | Medium (`md`)                                                |
| **Download**         | Always visible when a track is cued                          |
| **Queue**            | Always visible                                               |
| **Lyrics**           | Large (`lg`)                                                 |
| **Volume**           | Large (`lg`)                                                 |
| **Expand**           | Extra-large (`xl`), hidden if the overlay button is disabled |

## Mobile Player Layout

Mobile uses two layers:

* **Mini player bar**: square track image, track name, artist names, **Previous**, **Play / Pause**, **Next**, and a thin progress bar at the bottom.
* **Bottom navigation bar**: the mobile site navigation appears below the mini player.
* **Fullscreen overlay**: tap the mini player to open the expanded view with larger cover art, full playback controls, **Download**, **Queue** toggle, and **Lyrics**. Drag down to close.

## Download Button

The **Download** button is always present in the desktop right area and the mobile fullscreen overlay. Its behavior depends on your account:

| Condition                            | What happens                                                                           |
| ------------------------------------ | -------------------------------------------------------------------------------------- |
| You have download permission         | Opens the standard download flow (pre-download modal → file download → license modal). |
| You do not have download permission  | Opens an upgrade prompt so you can subscribe.                                          |
| Your subscription payment is overdue | Opens a payment dialog.                                                                |
| The track is exclusive-only          | Shows the exclusive licensing info modal.                                              |

The button is hidden entirely only when downloads are globally disabled, no track is cued, or the track is not locally uploaded.

## Keyboard Shortcuts

| Shortcut                                           | Action                                           |
| -------------------------------------------------- | ------------------------------------------------ |
| <kbd>Space</kbd> or <kbd>K</kbd>                   | Toggle play / pause (blocked inside text inputs) |
| <kbd>Ctrl</kbd> or <kbd>Shift</kbd> + <kbd>→</kbd> | Next track                                       |
| <kbd>Ctrl</kbd> or <kbd>Shift</kbd> + <kbd>←</kbd> | Previous track                                   |

<Note>
  Plain arrow keys do not seek within a track or adjust volume. Use the seekbar or volume slider directly.
</Note>

## What Changes by Context

<AccordionGroup>
  <Accordion title="No track selected" icon="circle-stop">
    The player hides entirely until something is cued.
  </Accordion>

  <Accordion title="Mobile" icon="mobile-screen">
    Desktop-only controls (volume slider, expand) move out of the bottom bar. The compact mini player stays visible and advanced controls appear in the fullscreen overlay.
  </Accordion>

  <Accordion title="Instance settings" icon="gear">
    Administrators can hide certain features such as lyrics or the expand button, so your player may show fewer actions than described here.
  </Accordion>
</AccordionGroup>

## Need Help?

If you have questions or need assistance, contact the support team at [**contact@beatpass.ca**](mailto:contact@beatpass.ca) or visit the [Contact Support](/help/contact-support) page.