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