Autoplaylists
Everything you need to know about Autoplaylists.
Introduction
Autoplaylists are one of the most important features of Watora, it allows you to autoplay songs forever while the autoplaylist is enabled. You can create as many autoplaylists as you want, and you can use them everywhere, even if you created them on another server.
Manage autoplaylists
To manage autoplaylists you have to use pl
Usage
Help
pl (start) (autoplaylist)
pl new [autoplaylist]
Creates a new autoplaylist with the specified name.
pl add (keywords|URL|current_queue)
Adds a song to the current autoplaylist. If you don't specify an URL nor keywords, this will add the current song to the autoplaylist.
You can write current_queue to add the whole current queue to the autoplaylist.
pl remove (keywords|URL)
Removes a song form the current autoplaylist. If you don't specify an URL nor keywords, this will remove the current song from the autoplaylist.
pl now
Displays the current autoplaylist.
pl off
Disables the current autoplaylist.
pl repair (autoplaylist)
Repairs an autoplaylist. If you don't specify one, this will repair the current autoplaylist.
pl info (autoplaylist)
Gives information about an autoplaylist. If you don't specify one, this will target the current autoplaylist.
pl clear (autoplaylist)
Deletes an autoplaylist and all of its content. Warning : This operation cannot be undone.
pl clone (autoplaylist)
Creates an autoplaylist by copying an existing autoplaylist.
If you don't specify one, this will clone the current autoplaylist.
pl settings (autoplaylist)
(--edit [private|shuffle
|whitelist|description| avatar|name])
Displays information about an autoplaylist or edits its settings.
pl find (query)
Searches for an autoplaylist sorted by upvote. You can specify a query to narrow your search.
pl upvote (autoplaylist)
Upvotes an autoplaylist.
Autoplaylists with more upvotes have more visibility.
You can use plinstead of pl start
Things to know :
You can create as many autoplaylists as you want, but only one personal autoplaylist.
Your autoplaylist can have as many songs as you want.
Types of Autoplaylists
Basically there are two types of Autoplaylists.
Basic Autoplaylist
An autoplaylist has :
A name (chosen when created)
Songs (added or removed with
pl addandpl remove)Settings
Permissions
Personal Autoplaylist
A Personal and Basic autoplaylists share the same attributes except that the Personal autoplaylist doesn't have a name. It's called your autoplaylist.
It also means that when calling a Personal Autoplaylist the argument passed will change. Instead of using(autoplaylist), use (user_mention).
Examples :
Autoplaylist Configuration
Editing Autoplaylists
Usage
Help
pl set (autoplaylist) --edit private (True|False)
Manages the autoplaylist privacy settings.
If no value is specified, this will act as a toggle.
pl set (autoplaylist) --edit shuffle (True|False)
Manages the autoplaylist auto-shuffle setting.
If no value is specified, this will act as a toggle.
pl set (autoplaylist) --edit whitelist (+|-) [user]
Edits the Whitelist and allows you to choose who can edit the autoplaylist.
You can usepl setas an alias for pl settings
Autoplaylist permissions
By default, an autoplaylist is Private and the Whitelist is empty.
Anyone can start any autoplaylist.
You cannot edit a private Autoplaylist if you're not in the Whitelist.
You can edit a public Autoplaylist.
Private Autoplaylist
Permission
Everyone
Whitelisted User
Creator
Start the autoplaylist
Yes
Yes
Yes
Clone the autoplaylist
Yes
Yes
Yes
Add a song to the autoplaylist
No
Yes
Yes
Remove a song from the autoplaylist
No
Yes
Yes
Repair the autoplaylist
No
Yes
Yes
Clear the playlist
No
No
Yes
Public Autoplaylist
Permission
Everyone
Whitelisted User
Creator
Start the autoplaylist
Yes
Yes
Yes
Clone the autoplaylist
Yes
Yes
Yes
Add a song to the autoplaylist
Yes
Yes
Yes
Remove a song from the autoplaylist
Yes
Yes
Yes
Repair the autoplaylist
Yes
Yes
Yes
Clear the playlist
Yes
Yes
Yes
In almost every case you should let your autoplaylist Private.
Either only whitelist people you trust or clone your autoplaylist somewhere as a backup.
You can start your personal autoplaylist by using pl without any argument.
You can create an alias to start an autoplaylist (and avoid mentioning someone each time you want to start their personal autoplaylist). Take a look at Custom Commands.
Autoplaylist settings
Use pl set (autoplaylist) to display the current autoplaylist settings.
Shuffle :
Enabled by default.
Defines if the songs are randomly played, or played in order.
Telling the autoplaylist to start a song at a specified timecode
By adding ?t=SECONDS at the end of your url when adding the song (it also works with the play command).
Last updated
Was this helpful?
