Wavelength Docs

Everything Wavelength can do, what's free, what's Premium, and how billing works.

Getting started

Add Wavelength to a server (you need Manage Server there).
Join any voice channel.
In a text channel, type:

/play query: never gonna give you up

Wavelength joins the voice channel and starts playing. Run /play again to add more songs to the queue. Use the ⏯️ ⏭️ ⏹️ 🔁 🔀 buttons on the Now Playing card for quick control.

Tip: commands only work while you're in the same voice channel as Wavelength. That keeps randoms in other channels from skipping songs.

Permissions

Wavelength asks for exactly 5 permissions, never admin:

View Channels: to see the channels it's used in
Send Messages + Embed Links: for the Now Playing card and replies
Connect + Speak: to join voice and play music

If it says it can't join, check the voice channel's permissions for the Wavelength role.

Free commands Every server

Command	What it does
`/play` query · next	Play a song or playlist by name or link. Add `next:True` to cut the line and play it next.
`/pause`	Pause the music.
`/resume`	Pick up where it left off.
`/skip`	Skip the current song.
`/stop`	Stop the music and clear the queue.
`/queue` page	See what's lined up, 10 songs per page, with the total run time.
`/nowplaying`	Show the current song with a progress bar and controls.
`/volume` level	Set the volume, 0–100%. Premium goes up to 200%.
`/loop` mode	Loop Off, the Current song, or the Whole queue.
`/shuffle`	Shuffle the queue.
`/remove` position	Pull a song out of the queue by its spot in `/queue`.
`/seek` time	Jump to a time in the song, like `1:30` or `90`.
`/leave`	Kick Wavelength out of voice.
`/help`	Quick cheat sheet of every command.
`/premium status`	Check whether the server is Free or Premium, and when it renews.
`/premium subscribe`	Get a PayPal checkout link to upgrade this server ($10/mo).
`/premium manage`	Link to PayPal's automatic payments page to update the card.
`/premium cancel`	Cancel Premium. It stays on until the paid month runs out.

Playlists Every server

Save songs into named playlists the whole server can play any time. Anyone can add songs. Only whoever made a playlist, or someone with Manage Server, can delete it or remove other people's songs. Playlist names fill in as you type.

Command	What it does
`/playlist create` name	Start a new playlist (up to 40 characters).
`/playlist add` playlist · song	Add a song by name or link. Leave `song` blank to add whatever's playing right now. A whole playlist link adds every song that fits.
`/playlist play` playlist · shuffle	Queue up the whole playlist, optionally shuffled.
`/playlist view` playlist · page	See every song with its spot number and the total run time.
`/playlist list`	Every playlist in the server, plus how many slots are left.
`/playlist remove` playlist · position	Take a song out by its spot number.
`/playlist delete` playlist	Delete a playlist for good.

How many playlists each tier gets

	Free	Premium	Premium+
Saved playlists per server	3	25	100
Songs per playlist	25	200	500

Dropping to a lower tier never deletes anything. Every playlist stays playable. You just can't add more until you're back under that tier's limit.

Premium commands Premium

Command	What it does
`/filter` effect	Put an audio effect on the music: Bass Boost, Nightcore, Vaporwave, 8D, Treble Boost, Soft, or Off. More on filters ↓
`/premium channels`	See how many voice channels can play at once, and add a helper bot to unlock more.
`/247` enabled	Keep Wavelength in voice around the clock. Needs Manage Server. More on 24/7 ↓
`/volume` level	Volume goes all the way up to 200%.

Premium also upgrades things automatically, no command needed: 256kbps HQ audio, 1,000-song queues, 500-song playlist imports, and no ads. HQ audio kicks in on the next song after upgrading.

Free vs Premium limits

	Free	Premium
Audio quality	64kbps	256kbps HQ
Queue size	50 songs	1,000 songs
Playlist import	25 songs	500 songs
Saved playlists	3 (25 songs each)	25 (200 songs each)
Voice channels at once	1	2 (Premium+: 3)
Volume	0–100%	0–200%
Audio filters	—	✓ All 6
24/7 mode	— leaves after 2 min of silence	✓
Premium tips / ads	Occasional	None

Discord can cap what listeners hear at the voice channel's bitrate setting. For the full HQ effect, raise the channel bitrate in its settings (boosted servers can go higher).

Audio filters Premium

Run /filter effect: and pick one. It switches mid-song, right where you are.

Bass Boost: heavier low end
Nightcore: faster + higher pitch
Vaporwave: slowed + lower pitch
8D: sound swirls around your head (wear headphones)
Treble Boost: crisper highs
Soft: mellow, takes the edge off
Off: back to normal

24/7 mode Premium

On the Free tier, Wavelength leaves voice after about 2 minutes with nothing playing or nobody listening. With Premium, someone with Manage Server can run /247 enabled:True and Wavelength stays put around the clock. Turn it off with /247 enabled:False.

Music in multiple channels Premium

Got two groups in two different voice channels? Premium plays music in both at once, each with its own queue. Just run /play from the second channel. Commands always control the music in whichever channel you're in.

	Free	Premium	Premium+
Voice channels at once	1	2	3

Discord only lets one bot sit in one voice channel per server, so extra channels are played by Wavelength's helpers (Wavelength 2, Wavelength 3). Run /premium channels to see what's ready and add a helper in one click. Helpers only join voice to play music. They don't run commands or send messages.

Getting Premium

Premium is $10/month per server. One person subscribes and everyone in that server gets it. Two ways to buy:

Inside Discord (easiest): run /premium subscribe in the server you want to upgrade and follow the PayPal button.
On this website: head to the Premium page, enter the server ID, and check out with PayPal.

Premium switches on within about a minute. Check with /premium status.

Billing & cancelling

Billed monthly through PayPal, automatically, until cancelled.
Cancel any time with /premium cancel, or in PayPal under Settings → Payments → Automatic payments.
After cancelling, Premium stays on until the paid month runs out, then the server goes back to Free.
/premium manage and /premium cancel work for whoever subscribed. For website purchases with no Discord ID attached, anyone with Manage Server can use them.
Bought Premium twice for the same server by accident? The extra subscription gets cancelled automatically and refunded.

What if a payment fails?

PayPal retries the card, and Wavelength DMs whoever subscribed so they can fix it.
Premium keeps working during a 3-day grace period.
Still unpaid after 3 days? The server drops to the Free tier. Nothing gets deleted: the queue, settings and everything else stay put.
As soon as the payment goes through (PayPal retry or an updated card), Premium switches back on automatically.
If PayPal gives up after repeated failures, the subscription ends. Run /premium subscribe any time to start fresh.

Troubleshooting

The commands don't show up

Press Ctrl+R to refresh Discord. For brand new servers it can take a few minutes. Also make sure Wavelength was added with the invite link (it needs the applications.commands scope).

"Hop in a voice channel first"

Join a voice channel before running music commands, and make sure it's the same one Wavelength is in.

It joins but there's no sound

Check that Wavelength has Speak in that channel and isn't server-muted. Then run /nowplaying. If the song shows but nothing plays, try /skip.

A song won't play

Every so often a song is locked or unavailable. Wavelength hunts for a backup copy, and if there isn't one it skips to the next song on its own. Try a different link or search.

Paid but no Premium yet

Give it a minute, then run /premium status. If you bought on the website, double-check the server ID you entered. Still stuck? Reach out in the support server.