Music Setup
Setup guide for the Music and Lavalink audio hosting add-on: voice playback, queues, and audio filters.
The Music paid module brings high-performance voice channel audio streaming to Medusa. Powered by Lavalink v4, Medusa delivers stutter-free audio, rich queue management, volume balancing, interactive voice controls, and dynamic sound filters without stressing your main bot process.
Need a dedicated Lavalink node? Our hosting partner Haven Development offers high-speed, low-latency Lavalink nodes preconfigured and ready for Medusa.
Installation & Claiming
- Purchase the Music add-on on the Zero Development Store.
- In the Zero Development Discord, run
/claimin「🤖」commandswith your invoice. - Restart Medusa or place the downloaded
musicfolder intomodules/music. - Medusa logs
Music ✔ Loaded!on startup.
Connecting to Lavalink
The Music module streams audio via Lavalink nodes:
- In the Medusa Web Dashboard, navigate to the Music configuration tab.
- Under Lavalink Nodes, click Add Node.
- Fill in your node connection parameters:
- Node Name: e.g.
"Primary Node". - Host: Your Lavalink server IP or hostname (e.g.
lavalink.havendevelopment.net). - Port: Default
2333(or your assigned Lavalink port). - Password: Your Lavalink authentication password (e.g.
youshallnotpass). - Secure (SSL): Check this option if your Lavalink endpoint uses HTTPS/WSS (
port 443).
- Node Name: e.g.
- Click Save & Connect. Medusa establishes a persistent WebSocket connection to the audio node.
Music Controls & Features
Audio Filters
Medusa includes real-time digital signal processing (DSP) filters:
- Bass Boost: Low-frequency amplifier with adjustable gain levels.
- Nightcore: Increases playback tempo and pitch.
- Vaporwave: Slows playback tempo for relaxed listening.
- 8D Audio: Simulates rotational spatial panning around the listener.
- Karaoke: Vocal reduction filter.
24/7 Voice Channel Mode
Enable 24/7 mode to keep Medusa connected to a designated voice channel even when queues end, making it ideal for continuous community radio or chill voice rooms.
Commands Reference
| Command | Description |
|---|---|
/play <query> | Play a song, search term, or playlist in your current voice channel. |
/pause / /resume | Pause or resume audio playback. |
/skip [to] | Skip the current track or jump to a specific queue index. |
/queue [page] | View upcoming tracks in the music queue. |
/volume <1-100> | Adjust audio playback volume. |
/filter <name> | Apply an audio filter (bassboost, nightcore, 8d, clear). |
/loop <mode> | Set repeat mode: off, track, or queue. |
/disconnect | Clear the queue and leave the voice channel. |

