Lona Docs DOCS Dashboard Support Add Lona
Guide / Music

Music

Music control panel with interactive buttons inside a dedicated channel.

4 commands2 recipes
How to configure it from the dashboard

Music has two entry points: from Discord via a button panel inside a dedicated channel, and from the dashboard via the “Lona Studio” page. Commands and the panel are sufficient for most servers, but the Studio page lets you do two things you can't do from chat: play in a voice channel without joining it, and customize command names while restricting them to a single channel.

Set up the channel and panel

From Discord: `!لوحة_موسيقى`

This command sets up the channel and posts the panel. Afterwards, specify the requests channel.

!لوحة_موسيقى setup · !musicch requests channel · !تحديث_لوحة_موسيقى refresh layout
Lona requires Connect and Speak permissions in the voice channel

Enable slowmode for large servers

From Discord: `!musicslow`

Prevents rapid-fire requests from messing up the queue. Essential for busy servers.

Play a track from the dashboard without joining the channel

Dashboard ← Lona Studio ← Play from Dashboard

This feature has no command equivalent: pick a voice channel and start playback without having to join it yourself. Useful when preparing background music for an event before people arrive.

The 🎵 Track name or YouTube URL field accepts search queries or direct links, and 📍 Voice channel lists your server's voice channels. Click Play.

Supported sources: YouTube, YouTube Music, SoundCloud, and playlists. The queue limit is 50 songs — if you add a longer playlist, the rest is trimmed without a clear error message.

Four counters at the top give you the status at a glance: Total nodes, Connected to server, Now playing, and Queued songs. If “Now playing” stays at zero after clicking Play, the bot could not join the channel — check its permissions.
Lona Studio — Play from Dashboard
🎵 Track name or YouTube URLSearch by name or direct URLماذا لو - عبدالمجيد عبدالله
📍 Voice channelSelect channel...🎧│music-session
Play
Supports: YouTube · YouTube Music · SoundCloud · Playlists — max 50 tracks in queue
The counters at the top of the page confirm playback has started

Customize command names and restrict them to a single channel

Lona Studio ← Custom Music Commands

The Custom Music Commands panel lets you rename any command to any word you want — play can become شغل, and skip can become تخطي. There are eleven customizable commands: play · skip · stop · pause · resume · leave · queue · loop · shuffle · history · volume. Best of all, the Discord Commands Guide at the bottom of the page updates automatically with the new names, so you can copy and share it with your members without writing anything manually.

Below it is Dedicated Music Channel (optional). If left on "— All channels (no restriction) —", commands work anywhere. If you set a channel, music commands will work only there — keeping command spam out of general chat.

Each panel has its own Save button. Saving commands does not save channel settings, and vice versa.
Custom Music Commands
Rename any command to whatever you want — instructions update automatically
playSearch and play from YouTubeشغل
skipSkip current trackتخطي
volumeChange volume levelصوت
Dedicated music channel (optional)— All channels (no restriction) —#🎵│song-requests
Save
The "Discord Commands Guide" at the bottom of the page updates automatically with the new names — copy it for your members
If you select a channel, music commands will only work there

Pin the bot to a channel or send the "Spy"

Lona Studio ← Bot Card

Each bot card has three tools that can be confusing if not understood:

Pin to channel — The bot joins the channel and stays there permanently, even if empty. Useful for 24/7 radio channels. Unpin it using Unpin; a Pinned badge appears on the card while linked.

🕵️ Spy — Choose a channel and click Send Spy; the bot joins muted without playing anything. Useful for a silent presence in a channel you want to monitor.

Leave — The bot leaves the current voice channel.

Spy does not work while the bot is pinned — Lona will reply "📌 Bot is pinned to a channel — unpin it before sending spy". Likewise, if another one of your bots is already in that channel, it will reject the request and ask for a different channel.
Bot Card — Tools
Pin to channel...The bot stays in channel and does not leave📻│radio-24
🕵️ SpyJoins muted without playing🎧│music-session
Send SpyLeave
A Pinned badge appears on the card while linked to a channel
Pin and Spy cannot be used together — unpin first

Customize bot identity in your server (Premium)

Lona Studio ← Bot Customization

The Customize <Bot Name> panel changes its appearance in your server only — other servers see it with its default identity.

Name — up to 32 characters, leave blank to revert to default.
Avatar — PNG, JPG, or GIF, square recommended.
Banner — 1024×400 horizontal recommended.

Then click Save & Apply; Reset reverts everything back to default.

The Bot Linking card requires a subscription — if you see a 👑 Premium Only badge on the card, the additional unit is locked for you and the main bot works normally.
Bot Customization — Identity in your server only 🌸
NameMax 32 characters — leave blank for defaultLona FM
AvatarPNG / JPG / GIF — square recommendedChoose image
Banner1024×400 recommended — horizontalNo banner
Save & ApplyReset
Changes are local to your server — they don't affect other servers

How the system works

Music in Lona runs with a button-based controller panel in a dedicated channel — instead of members typing long commands.

!لوحة_موسيقى sets up the channel and posts the panel, and !musicch sets the request channel. !musicslow enables slowmode to prevent rapid spam requests.

Practical recipes

Set up an organized music channel

A button panel instead of members typing commands:
1!لوحة_موسيقى — Set up the channel and post the panel
2!musicch — Set the requests channel
3!musicslow — Slowmode for large servers
4!تحديث_لوحة_موسيقى — Refresh the panel design

Set up the music channel

Three commands:
1!لوحة_موسيقى — Set up the channel and panel
2!musicch — Set the requests channel
3!تحديث_لوحة_موسيقى — If you want to refresh the design
Tips and warnings
!musicslow saves you in large servers from the chaos of rapid requests.
Keep the music channel separate from the general chat channel — each has its own vibe.
The button panel is much easier for new members than memorizing playback commands.
!musicslow saves you in large servers from request spam.
Lona needs connect and speak permissions in the voice channel; otherwise, the panel works but no audio plays.
"Lock to channel" and "Spy" cannot be used together. While the bot is locked to a channel, sending the spy will be rejected with "📌 The bot is locked to a channel — unlock it before using the spy".
If you set a dedicated music channel, playback commands will stop working in other channels — and your members won't get an alert explaining why. Mention the channel name in the music channel topic or pin a message before enabling it.
The queue limit is 50 songs. If you play a longer playlist, the excess is trimmed silently — there is no message telling you that part of the playlist was dropped.
Commands · 4
Copied ✓
/music_panelSlashAdmin
Set up a music control channel — an interactive button panel
الكاتاجوري Where the panel channel is created (optional)روم_موجود Use an existing text channel instead of creating a new one (optional)لون HEX color code to unify icon colors — empty = custom colors (optional)
Copied ✓
!musicchPrefixAdmin
Set a dedicated channel for music commands — leave empty to clear
Copied ✓
!musicslowPrefixAdmin
Set music playback command slowmode — example: سلو_موسيقى 5
Copied ✓
/refresh_music_panelSlashAdmin
Regenerates music panel icons and banner and posts it again
لون HEX color code to unify icons — empty = custom colors
No commands match the filter