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

# Music

> Lucie's music commands: playback, queue, voice channel, favorites, playlists, and DJ mode.

Lucie plays music in your voice channel from text searches or **YouTube** and **SoundCloud** links, including full playlists.

<Note>
  The examples use the default prefix `!` (configurable with `!setprefix`). Lucie also responds to her mention and to slash commands (`/comando`).
</Note>

<Note>
  To control playback (skip, pause, reorder the <Tooltip tip="The list of songs waiting to play: they run in order once the current one ends.">queue</Tooltip>, etc.) you must be **in the same voice channel** as Lucie. Read-only commands like `!queue` or `!nowplaying` don't require it.
</Note>

## Playback

## !play

Plays a song or adds it to the queue. Accepts a song name or a direct link.

**Usage:** `!play <name or link>`

**Aliases:** `p`

* If nothing is playing, the song starts right away.
* If music is already playing, it's added to the queue and Lucie shows you its position and the estimated time until it plays.
* With a playlist link, all of its songs are added at once, along with the total track count and combined duration.

**Examples**

```text theme={"dark"}
!play bad bunny diles
!play https://youtu.be/dQw4w9WgXcQ
```

## !pause

Pauses the current playback.

**Usage:** `!pause`

**Aliases:** `pausa`

**Examples**

```text theme={"dark"}
!pause
```

## !resume

Resumes paused playback.

**Usage:** `!resume`

**Aliases:** `continuar`, `unpause`

**Examples**

```text theme={"dark"}
!resume
```

## !stop

Stops the music and clears the queue. Lucie stays in the voice channel.

**Usage:** `!stop`

**Aliases:** `parar`

**Examples**

```text theme={"dark"}
!stop
```

## !skip

Skips to the next song in the queue. If nothing is left, playback stops.

**Usage:** `!skip`

**Aliases:** `s`, `next`, `saltar`

**Examples**

```text theme={"dark"}
!skip
```

## !seek

Jumps to a specific point in the current song. Accepts seconds or the `m:ss` format. If the point exceeds the song's duration, Lucie lets you know.

**Usage:** `!seek <seconds|m:ss>`

**Aliases:** `ir`

**Examples**

```text theme={"dark"}
!seek 90
!seek 1:30
```

## !nowplaying

Shows the song currently playing: artist, progress bar, elapsed and total time, status (playing or paused), volume, and loop mode.

**Usage:** `!nowplaying`

**Aliases:** `np`, `sonando`

**Examples**

```text theme={"dark"}
!nowplaying
```

## !lyrics

Looks up the lyrics of the song currently playing. You can also request specific lyrics using the `artist - title` format. Very long lyrics get trimmed.

**Usage:** `!lyrics [artist - title]`

**Aliases:** `letra`

**Examples**

```text theme={"dark"}
!lyrics
!lyrics queen - bohemian rhapsody
```

<Tip>
  If Lucie can't find the lyrics for the current song (video titles sometimes carry extra text), try `!lyrics artist - title` typed out by hand.
</Tip>

## Queue

## !queue

Shows the playback queue: the current song and the next 10 (if there are more, it tells you how many remain), along with the queue total, volume, and loop mode.

**Usage:** `!queue`

**Aliases:** `q`, `cola`

**Examples**

```text theme={"dark"}
!queue
```

## !remove

Removes a song from the queue by its number. Check the numbers with `!queue`.

**Usage:** `!remove <number>`

**Aliases:** `rm`, `quitar`

**Examples**

```text theme={"dark"}
!remove 3
```

## !clear

Clears the queue without stopping the song currently playing.

**Usage:** `!clear`

**Aliases:** `cls`, `limpiar`

**Examples**

```text theme={"dark"}
!clear
```

## !move

Moves a song in the queue from one position to another.

**Usage:** `!move <from> <to>`

**Aliases:** `mover`, `mv`

**Examples**

```text theme={"dark"}
!move 5 1
```

## !shuffle

Randomly shuffles the songs in the queue.

**Usage:** `!shuffle`

**Aliases:** `mix`, `mezclar`

**Examples**

```text theme={"dark"}
!shuffle
```

## !loop

Changes the loop mode:

* `off` — no looping.
* `track` — repeats the current song (also accepts `song`, `cancion`, `one`).
* `queue` — repeats the whole queue (also accepts `cola`, `all`).

Without an argument, it cycles to the next mode in the sequence `off → track → queue → off`.

**Usage:** `!loop [off|track|queue]`

**Aliases:** `repeat`, `l`

**Examples**

```text theme={"dark"}
!loop track
!loop queue
!loop off
```

## !autoplay

Toggles <Tooltip tip="When the queue runs out, Lucie keeps going on her own with similar songs.">autoplay</Tooltip>: when the queue ends, Lucie keeps playing similar tracks on her own. Requires an active player (put something on with `!play` first).

**Usage:** `!autoplay`

**Aliases:** `radio`

**Examples**

```text theme={"dark"}
!autoplay
```

## Voice channel

## !join

Makes Lucie join your voice channel.

**Usage:** `!join`

**Aliases:** `summon`, `venir`

**Examples**

```text theme={"dark"}
!join
```

## !leave

Disconnects Lucie from the voice channel.

**Usage:** `!leave`

**Aliases:** `dc`, `disconnect`, `salir`

**Examples**

```text theme={"dark"}
!leave
```

## !volume

Adjusts the volume between 0 and 150 (out-of-range values are clamped to the limit). Without an argument, it shows the current volume.

**Usage:** `!volume [0-150]`

**Aliases:** `vol`, `v`

**Examples**

```text theme={"dark"}
!volume 50
!volume 100
```

## Personal

## !favorite

Adds the song currently playing to your favorites. Favorites are personal and stored per server.

**Usage:** `!favorite [play|list]`

**Aliases:** `fav`, `like`, `favorito`

* `!favorite` — saves the current song to your favorites (if it was already there, she tells you).
* `!favorite play` (or `load`) — adds all your favorites to the queue and starts playing them if nothing was on.
* `!favorite list` — shows your favorites (up to 20).

**Examples**

```text theme={"dark"}
!favorite
!fav play
!fav list
```

## !playlist

Manages the server's saved playlists: save the current queue under a name and bring it back whenever you want.

**Usage:** `!playlist <list|save|load|delete> [name]`

**Aliases:** `pl`

* `!playlist list` (or `lista`) — shows the server's playlists with their track counts. This is the default action if you don't specify anything.
* `!playlist save <name>` (or `guardar`) — saves the current song and the whole queue under that name (80 characters max).
* `!playlist load <name>` (or `cargar`) — adds all the playlist's tracks to the queue and starts playing if nothing was on.
* `!playlist delete <name>` (or `borrar`, `del`) — deletes the playlist.

**Examples**

```text theme={"dark"}
!playlist list
!playlist save favoritas
!playlist load favoritas
!playlist delete favoritas
```

<Tip>
  Put together a great session? `!playlist save <name>` saves the entire queue exactly as it is, including the song currently playing.
</Tip>

## DJ

## !dj

Toggles the **AI DJ**: Lucie introduces each song with her voice before playing it. Applies to songs you queue after enabling it. Requires music to already be playing.

**Usage:** `!dj`

**Aliases:** `djmode`, `djia`

**Examples**

```text theme={"dark"}
!dj
```

## !crossfade

Toggles <Tooltip tip="A fade between songs: the end of one blends into the start of the next.">crossfade</Tooltip>: a smooth fade between songs. Without an argument, it switches the current state. The change applies to music you queue from that point on.

**Usage:** `!crossfade [on|off]`

**Aliases:** `xfade`, `fundido`

**Examples**

```text theme={"dark"}
!crossfade on
!crossfade off
```

<Warning>
  If you notice cutouts or anything odd with crossfade enabled, turn it off with `!crossfade off` and playback will return to normal.
</Warning>

***

Questions or issues with the music? Stop by the [support server](https://discord.gg/VqyAZJ2mFc) or manage Lucie from the [web dashboard](https://lucie.elxy.dev).