> For the complete documentation index, see [llms.txt](https://watora.gitbook.io/watora/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://watora.gitbook.io/watora/features/autoplaylists.md). # 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.

| | | | | | {% hint style="info" %} You can use `pl`instead of `pl start` {% endhint %} #### 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](/files/-LRYtFNkqFDmW036g6Hm) ![Mentioning myself to display my personal autoplaylist settings](/files/-LRYt_3SV0QWne-6AGZk) ## 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. | {% hint style="info" %} You can use`pl set`as an alias for `pl settings` {% endhint %} ### 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** | {% hint style="danger" %} In almost every case you should let your autoplaylist Private. {% endhint %} {% hint style="warning" %} Either only whitelist people you trust or clone your autoplaylist somewhere as a backup. {% endhint %} {% hint style="info" %} You can start your personal autoplaylist by using `pl` without any argument. {% endhint %} {% hint style="info" %} 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](/watora/features/custom-commands.md). {% endhint %} ### Autoplaylist settings {% hint style="info" %} Use `pl set (autoplaylist)` to display the current autoplaylist settings. {% endhint %} #### 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). {% hint style="info" %} **Examples:** \ **pl add** [**https://youtu.be/UQpRzyNXDBg?t=120**](https://youtu.be/UQpRzyNXDBg?t=120) \ **pl add** [**https://soundcloud.com/user-345751583/opening-recreator-full-gravity-wall?t=60**](https://soundcloud.com/user-345751583/opening-recreator-full-gravity-wall?t=60) {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://watora.gitbook.io/watora/features/autoplaylists.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.