Spotify pack

What you get

• Now playing: a member types /nowplaying and Guard posts the song they're listening to on Spotify, with the album art, a progress bar and a Play on Spotify button.
• Shared playlist: members add their favourite songs, albums and playlists with /playlist add. Guard can keep a pinned board in a channel showing the latest ones.
• Listener role Optional: members get a role like Listening on Spotify while they're listening, and lose it when they stop.

It's off until you turn it on, and nobody is included unless they opt in themselves.

You'll need

• Glitchworks Guard in your Discord, and the Manage Server permission.
• Nobody needs Spotify Premium, and nobody signs in to anything. Guard uses what Discord already shows in a member's status.

Step 1: Open the setup screen

1. Type /spotify setup (or /settings and pick Spotify pack).
2. You'll see one screen with four menus and some buttons.

Step 2: Pick the parts you want

In the first menu, tick what you'd like:

Step 3 (optional): Choose who can use it

In the second menu, pick up to 5 roles (for example Members or Whitelisted). Leave it empty to let everyone use it. Your staff can always use it.

Step 4 (optional): A playlist board

In the third menu, pick a channel for the board, or press Create #playlist and Guard makes a read-only channel for you.

Guard posts one message there, pins it, and keeps it up to date with the latest 20 songs on the playlist.

Step 5 (optional): The listener role

If you ticked the listener role, either:

• press Create a listener role (Guard makes Listening on Spotify with no permissions), or
• pick a role you already have in the fourth menu. It must be a plain role: Guard won't hand out roles that have moderator or admin permissions.

Make sure Guard's own role is above the listener role (Server Settings > Roles: drag Glitchworks Guard up), or Guard can't give it out. The setup screen warns you if it isn't.

Tip: in the role's settings, switch on Display role members separately so listeners show up as their own group in the member list.

Step 6: Set the limit and turn it on

• The Limit button changes how many things fit on the playlist: 25, 50, 100 (the default) or 200.
• Press Turn on. Done.

What your members do

Opting in (once)

Members type /spotify optin and press Yes, opt me in. Guard explains exactly what it looks at first. They can stop any time with /spotify optout.

Opting in is only needed for /nowplaying and the listener role. Anyone allowed can use the playlist without it.

Showing what they're listening to

Type /nowplaying. Guard posts a card with the song, artist, album art, how far through it they are, and a Play on Spotify button.

• /nowplaying user:@someone shows someone else's song, only if they've opted in.

If nothing shows, they need these switched on in Discord:

1. User Settings > Connections: add Spotify and switch on Display Spotify as your status.
2. User Settings > Activity Privacy: switch on sharing your activity status.
3. Spotify must be playing (not paused), and they mustn't be set to Invisible.

The playlist

The same song can't be added twice. When the playlist is full, something needs removing first (or an admin can raise the limit).

The listener role

Once opted in, members get the role about 15 seconds after they start listening, and lose it about 15 seconds after they stop or pause.

Privacy

• Opt-in only. Guard never looks at anyone's status unless they've opted in in your server.
• Guard doesn't save what anyone listens to. It only looks when someone uses /nowplaying, or to give or take the listener role.
• It saves only who opted in (and when), and what each person added to the playlist.
• Members can get a copy with /mydata get, and ask for it to be deleted with /mydata delete.
• Leaving your server removes their opt-in.

Troubleshooting