# DizzyBot

DizzyBot is an extensible, self-hosted Discord music bot with YouTube, SoundCloud, Bandcamp, Apple Music metadata mirroring, internet radio, and optional Spotify and TIDAL metadata mirroring. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/2764/dizzybot

## Description

DizzyBot is an extensible, self-hosted Discord music bot with YouTube, SoundCloud, Bandcamp, Apple Music metadata mirroring, internet radio, and optional Spotify and TIDAL metadata mirroring. This single container includes its private Lavalink audio node; no Compose stack, second container, exposed port, or manually managed Lavalink password is required.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

52/100 (Fair), based on 3 of 4 factors.
- Maintained: 83 (last commit 34 days ago)
- Popular: 16 (5 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/dizzybot-1d8sfqs0sijppk?q=DizzyBot

## Common questions

### Do I need to run a separate Lavalink container or publish ports?

No. DizzyBot is distributed as one Docker container that includes its private Lavalink audio node, so no second container, Compose stack, exposed port, or separate Lavalink password is needed.

### Does the bot need Discord's message-content intent?

No. It uses slash commands only, so the message-content intent is not required.

### Do Spotify, Apple Music, and TIDAL links stream audio from those services?

No. They are metadata sources only; DizzyBot mirrors them to playable YouTube or SoundCloud matches using LavaSrc. It does not bypass DRM, download media, or cache audio.

### Where is state stored and what should I preserve?

Per-server settings are stored in SQLite and have automatic migrations. The Unraid template creates an appdata mapping for the container's data.

---
Source: Our Local Host (https://ourlocalhost.com/app/2764/dizzybot), the self-hosted and open-source app directory.
