Music


Music module allows you to play music in your voice channels and control the music queue.
The primary resource used for searching tracks is SoundCloud.
Other most popular music sources (including YouTube and Spotify) are only used for searching track data. It is then used to find relevant tracks on SoundCloud which are then played.
Keep in mind that this process isn't perfect and sometimes might cause incorrect track to be played or for nothing to be played at all.


In order for Shaun to join a voice (or stage) channel and play music, some conditions must be met beforehand. These checks are performed when using join or play.
Here is a list of them:

  • User must be connected to a voice (or stage) channel
  • Shaun must have Connect, Speak and ViewChannel permissions in the channel
  • If the channel is full, Shaun must additionally have MoveMembers permission
  • Shaun cannot be timed out
  • Shaun cannot be already connected to another channel in the server
  • If connecting to a stage channel, Shaun must also be a stage moderator or a request to speak must be approved

Other music commands also require users to be connected to the same channel as Shaun.


Here is a list of all music functionality:

Autoplay

autoplay allows you to continue playing related tracks whenever your queue ends.

Jump

jump allows you to skip a selected number of tracks. You can also provide a negative number to go backwards.

Loop

loop allows you to loop the whole queue or the track that is currently playing.

Pause

pause pauses the queue.

Previous

previous plays the previous track from the queue.

Queue

queue shows you all the tracks in your queue alongside some queue information. It also allows you to manage the queue, including skipping and removing tracks from it.
There is a limit of 250 tracks in a queue.

Resume

resume resumes the queue.

Seek

seek allow you to skip to a given timestamp in a track.
Valid timestamps include: 1h5m20s, 15s, 1:5:20, 3:10, 20.

Shuffle

shuffle shuffles the whole queue.

Skip

skip plays the next track in the queue. You can also skip a current track by using play with skip argument set to True.

Stop

stop stops the queue.

Volume

volume controls the current volume of the queue. Supports values between 0 and 100.