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)	Starts an autoplaylist. If you don't specify an autoplaylist it loads your personal 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. See Autoplaylist permissions for more information.
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 add and pl 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 :

Using only pl instead of pl start and mentioning someone loads their personal autoplaylist

Mentioning myself to display my personal autoplaylist settings

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).

Examples: pl add https://youtu.be/UQpRzyNXDBg?t=120 pl add https://soundcloud.com/user-345751583/opening-recreator-full-gravity-wall?t=60