Docs
Paid Modules

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

  1. Purchase the Music add-on on the Zero Development Store.
  2. In the Zero Development Discord, run /claim in 「🤖」commands with your invoice.
  3. Restart Medusa or place the downloaded music folder into modules/music.
  4. Medusa logs Music ✔ Loaded! on startup.

The Music module streams audio via Lavalink nodes:

  1. In the Medusa Web Dashboard, navigate to the Music configuration tab.
  2. Under Lavalink Nodes, click Add Node.
  3. 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).
  4. 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

CommandDescription
/play <query>Play a song, search term, or playlist in your current voice channel.
/pause / /resumePause 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.
/disconnectClear the queue and leave the voice channel.

On this page