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

# Music

> Play, queue, and personalize music sessions in your Discord voice channels.

Hedwig's music system uses Lavalink for playback and recognizes search terms
plus links from YouTube Music, Spotify, SoundCloud, Apple Music, Audiomack, and
Tidal. It provides queue management, playback controls, lyrics, and personal
liked songs. Successful playback and resolution depend on the configured
Lavalink node and resolver/provider availability.

## Start a session

```text theme={null}
/join
/play query: lo-fi beats
/nowplaying
/queue
```

You can use `/search` when you want to choose from matching tracks instead of
immediately playing the first result. `/play` accepts a required `query`
containing a title, search phrase, or supported URL. `/spotify track`,
`/spotify album`, and `/spotify artist` look up Spotify metadata, while
`/spotify preview` returns a short preview where available.

## Playback controls

| Command     | Purpose                           |
| ----------- | --------------------------------- |
| `/pause`    | Pause the current track           |
| `/resume`   | Resume playback                   |
| `/skip`     | Skip the current track            |
| `,skipto`   | Skip to a queue position          |
| `/previous` | Play the previous track           |
| `/stop`     | Stop playback and clear the queue |
| `/volume`   | Set playback volume               |
| `/seek`     | Jump to a position                |
| `/loop`     | Set the loop mode                 |
| `/shuffle`  | Shuffle the queue                 |
| `/move`     | Move a track in the queue         |
| `/remove`   | Remove a track from the queue     |
| `/clear`    | Clear the queue                   |

## Queue and session tools

| Command     | Purpose                              |
| ----------- | ------------------------------------ |
| `/queue`    | View and manage the queue            |
| `/similar`  | Queue similar tracks                 |
| `/grab`     | DM current track information         |
| `/lyrics`   | Show lyrics                          |
| `/autoplay` | Toggle autoplay                      |
| `/247`      | Keep the player in the voice channel |
| `/join`     | Join your voice channel              |
| `,rejoin`   | Reconnect without losing the queue   |
| `/leave`    | Leave the voice channel              |
| `/forcefix` | Force-fix a broken player            |
| `/npstyle`  | Choose the now-playing card style    |

## Liked songs

```text theme={null}
/like
/showliked
/playliked
/dislike
/clearliked
```

These commands are personal: they let each member keep a library without
changing the server's shared queue policy. `/like` and `/dislike` act on the
current track; `/playliked` adds the member's saved tracks to the active queue.

## Music troubleshooting

1. Make sure Hedwig can **Connect** and **Speak** in the voice channel.
2. Make sure you are in a voice channel before using `/play`.
3. Use `/nowplaying` and `/queue` to confirm the player state.
4. Try `,rejoin` before clearing a session.
5. Use `/forcefix` only when the player is genuinely stuck.

<Note>
  Music providers can change availability, metadata, or rate limits. A
  provider error does not necessarily mean the Discord permissions are wrong.
  The bot must also be connected to the same voice channel as the member who
  starts playback.
</Note>