Getting Started
Playing Your First Song

Playing Your First Song

Once the bot is running and Lavalink is connected, you can play your first track.

Step 1 - Join a Voice Channel

Join any voice channel in your Discord server. The bot needs to see you in a voice channel to know where to play.

Step 2 - Use the Play Command

Type the following slash command in any text channel:

/play query:your song name or URL

Examples:

/play query:never gonna give you up
/play query:https://open.spotify.com/track/4cOdK2wGLETKBW3PvgPWqT
/play query:https://www.youtube.com/watch?v=dQw4w9WgXcQ
/play query:https://soundcloud.com/artist/track

What Happens

  1. The bot joins your voice channel.
  2. It searches for the track using the configured search engine (default: YouTube Search).
  3. If a direct URL is provided, it resolves the track directly.
  4. The track starts playing immediately if the queue is empty.
  5. If music is already playing, the track is added to the queue.
  6. A now-playing embed appears in the text channel.

Supported Sources

SourceURL FormatSearch
YouTubeyoutube.com/watch?v=...ytsearch:query
YouTube Musicmusic.youtube.com/watch?v=...ytmsearch:query
Spotifyopen.spotify.com/track/...spsearch:query
SoundCloudsoundcloud.com/...scsearch:query
Deezerdeezer.com/track/...Via LavaSrc
Apple Musicmusic.apple.com/...Via LavaSrc
Tidaltidal.com/browse/track/...Via LavaSrc
HTTP StreamAny direct audio URL-

Basic Playback Controls

After playing a song, use these commands to control playback:

CommandDescription
/pausePause the current track
/resumeResume playback
/skipSkip to the next track
/stopStop playback and clear the queue
/queueView the current queue
/volumeAdjust volume (1–100)
/nowplayingShow the current track with progress bar

Player Buttons

The now-playing embed includes interactive buttons for quick controls:

  • ⏮️ Previous
  • ⏸️ Pause / ▶️ Resume
  • ⏭️ Skip
  • ⏹️ Stop
  • 🔁 Loop

These buttons can be customized via the /playercontrol command.