Repository navigation
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.
-
,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).