Skip to main content
Percy’s music player lets you stream tracks and playlists from the biggest music platforms directly into any voice or stage channel. Search by name or paste a URL, manage a live queue, shape your sound with audio filters, and even sync playback with what a friend is listening to on Spotify — all without leaving Discord.

​
Quick start

Join a voice channel, then ask Percy to play something. Percy will join your channel automatically and start playing.
Use /playsearch instead of /play to browse a list of results and choose the exact track you want before it’s added to the queue.

​
Source flags

By default, Percy searches YouTube Music. Use the --source flag to search a different platform. Pass the flag inline or select the platform from the slash-command dropdown:

​
Playback commands

​
Examples

You can also use relative volume adjustments with a + or - prefix:

​
Audio filters

Filters shape the tone and texture of your audio in real time. Apply one or combine several to dial in your sound. Use /filter on its own to see which filters are currently active, and /filter reset to clear all of them at once.
Filters apply to everyone listening in the voice channel — not just you. Coordinate with your server before stacking multiple filters.

​
Listen together

Sync Percy’s playback with whatever a member is currently listening to on Spotify. Percy joins your voice channel, plays the same track, and seeks to the exact position they’re at — then follows along as the song changes.
Percy tracks the member’s Spotify presence in real time. If they pause, skip, or switch tracks, Percy mirrors those changes automatically. Listen together stops if the member leaves Spotify or closes the session.

​
DJ system

Server admins can grant trusted members a DJ role that gives them elevated control over the queue — including the ability to skip, stop, and adjust volume regardless of standard voting rules.
Grant the DJ role to members you trust to manage the music. Remove it the same way if they no longer need elevated control.

​
Lyrics

Pull up lyrics for the current track — or any song — with a single command. Percy fetches synced, time-stamped lyrics when available and falls back to plain text automatically.
Percy needs to be in a voice channel before most playback commands will work. If Percy isn’t connected yet, run /connect to bring it into your channel first.