Skip to content

Playing Music

don edited this page Oct 20, 2026 · 3 revisions

Playing Music

Join a voice channel, then use your configured prefix (, in these examples):

,play Daft Punk One More Time
,play https://www.youtube.com/watch?v=VIDEO_ID
,play source=sc artist song
,yt artist song
,sc artist song
,sp artist song

play accepts searches, YouTube/SoundCloud/Spotify links, or an audio attachment on the same message. Plain searches try Spotify first, then YouTube if Spotify returns no result. source=yt|sc|sp selects a service. yt/youtube, sc/soundcloud, and sp/spotify are source-specific commands.

Spotify track and album links use the configured Spotify API credentials. Playlist links also require a Spotify login; see Configuration. Collections are capped at 50 tracks. Online tracks have a seven-minute limit; overlong collection tracks are skipped. Audio uploads are capped at 25 MB.

Playback controls

  • ,wp / ,whatsplaying — current track and metadata
  • ,queue / ,q — queued tracks
  • ,pause / ,resume — toggle pause
  • ,loop track|queue|off — choose loop mode
  • ,skip — skip the current track
  • ,restart — restart the current track
  • ,remove <position> — remove a queued track
  • ,clearqueue — clear queued tracks
  • ,stop — stop playback, clear the queue, and disconnect
  • ,leave — disconnect (also stops TTS)

Playback messages also provide buttons. Permission and requester checks apply to controls; see the command list.

The bot needs Connect and Speak permissions. Online extraction needs yt-dlp, while metadata requires ffprobe. Playback cannot share a session with TTS: use ,leave before switching. The bot automatically cleans up idle sessions and leaves after everyone has left the voice channel (15-second grace period).

Clone this wiki locally