Playlists

A playlist belongs either to you or to a server.

A personal playlist follows you: create it on one server and you can play it on any other server where FlaviBot is present. A server playlist belongs to the server itself — everyone there sees it, and the roles you choose can add or remove tracks.

Everything lives under a single command, /playlist, with subcommands. Every playlist_name option autocompletes, marking whose playlist each one is: nothing for your own, 🔗 for one shared with you, and 🏠 for one this server owns.

How do I create a playlist?

/playlist create playlist_name: road trip

Names go up to 80 characters and have to be unique among your own playlists.

Free accounts can hold 3 playlists. Premium removes the limit. The automatic Liked Songs playlist counts towards that 3, so a free account has room for two of its own.

The reply carries a link to the playlist page on the website, which is where richer editing lives.

Adding songs

/playlist add-song playlist_name: road trip query: africa toto

query takes a song name, a track link, or an entire external playlist link, in which case every track from it is added at once.

To save what you are listening to right now:

/playlist add-queue playlist_name: road trip

The heart button on the now playing message adds the current track to your Liked Songs playlist, which FlaviBot creates for you the first time you use it. Pressing it again on the same track removes it.

Playing one

/playlist play playlist_name: road trip

Same rules as /play: you must be in a voice channel. If the playlist is longer than what the queue can hold, the extra tracks are dropped and the bot tells you.

Looking at them

/playlist list also prints how many of your allowance you have used. Next to each server playlist it shows what you may do with it, worked out from your roles.

Reordering and removing

/playlist shuffle playlist_name: road trip permanently randomises the stored order.

/playlist remove-song gives you the link to the playlist page: removing individual tracks is done there, where you can see the whole list.

How do I delete a playlist?

/playlist delete playlist_name: road trip

Liked Songs cannot be deleted, since FlaviBot uses it as your like target.

How do I share a playlist?

/playlist visibility playlist_name: road trip visibility: public

Public means anyone with the link can play the playlist. It does not put the playlist in other people's autocomplete, and it does not let them edit it.

Letting someone actually add, remove or reorder tracks is a separate, per-person permission you grant on the playlist's page on the website. Playlists shared with you that way show up in your /playlist list with the rights you were given.

For a playlist a whole server should be able to edit, use a server playlist instead — sharing it with everyone one person at a time is not the same thing.

Server playlists

A server playlist belongs to the server, not to whoever created it. Everyone on that server sees it in /playlist and can play it, and it only ever appears there — not in another server, not even for the person who made it.

Creating one needs the Manage Server permission:

/playlist create playlist_name: friday night owner: This server

The optional members_can option sets what @everyone may do from the start: view and play only, add songs (the default), add and remove, or also reorder. Adding is the default because it is undoable — someone can always ask for a track to be taken back out — while removing is destructive and anonymous.

Who can change it

Permissions are per role and they add up, exactly like Discord's own role permissions: a member gets everything their roles give them, put together. There is no "deny" — a role either grants something or says nothing about it.

/playlist perms playlist_name: friday night

opens a panel where you pick a role and tick what it can do:

@everyone is always listed and cannot be removed — locking a playlist down means unticking everything for it, which leaves the playlist visible and playable but read-only. Manage is the one permission @everyone cannot be given, for the same reason: it would let any member delete the playlist. Granting it to a specific role is a real delegation — that role can delete it.

Roles are the only thing that grants anything on a server playlist. The per-person sharing that personal playlists use does not apply here, so there is never a second, invisible list of people with rights.

Anyone with Manage Server can always do everything, whatever the roles say. The person who created the playlist gets no special rights: the server owns it, so a moderator who leaves or is demoted takes nothing with them.

The same permissions are editable on the dashboard, under Music → Server Playlists.

Moving a playlist in or out

/playlist transfer playlist_name: road trip to: This server

hands one of your playlists to the server, and to: Me takes one back. Both directions need Manage Server, and both check that the receiving side has room and no playlist with that name already.

Moving a playlist clears every permission on it, in both directions, and a playlist that was public becomes private again on the way in — the server never asked to publish it. Taking one back makes you its owner, and if it was the server's 24/7 default that setting is cleared too.

How many server playlists a server can hold depends on its premium tier, and it is counted on the server, not on the person creating them.

Playlists FlaviBot builds for you

/playlist autoplay accepts an optional name and a count between 5 and 50 (20 by default). The result is saved as a normal playlist of yours, so it counts towards your allowance.

/playlist vibe needs at least 2 humans in your voice channel, blends up to 10 of them, and saves a 25 track playlist. With nobody else in the channel it points you at /playlist autoplay instead.

server-discover and top50 play their playlist directly rather than saving a copy for you. They are regenerated on a schedule, so they change over time.

Spotify playlists

/playlist spotify lists your public Spotify playlists with a Play button each. It needs your Spotify account linked first, see Spotify.

The web player

The Playlists tab of the web player does all of this with a mouse, including adding a track to a playlist straight from the queue.