Bread

A self-hosted Discord music bot that plays together with the whole room.

Lavalink playback, autoplay that learns what your server likes, a Discord Activity, a live dashboard, synced lyrics and an arcade, all from one stack you run yourself.

Website · Try it in the browser · Self-host · Commands · Configuration

---

Why Bread

Most music bots give you a /play command and a queue. Bread treats the voice channel as a shared listening room: everyone sees the same player, queue and lyrics in Discord, in an Activity and on the web, and when the queue runs out the bot keeps going with music that fits the people in the room.

🎧 The Activity: a player inside the voice channel

Open Bread from the voice channel's Activity shelf and everyone gets the same live player: artwork, seek bar, a shared queue you can drag into order, search, uploads, a radio tuner, the sound panel and karaoke lyrics.

Permissions follow your server settings. Members without control still get the read-only view and can start a vote skip.

📊 /stats: your server's listening history as a picture

One command renders a card for the server or for one member: plays and hours listened, top tracks and artists, where songs came from, the busiest hours and the arcade leaderboard. A menu under the image switches between the views.

🎰 The Arcade: something to do between songs

Slots, roulette, blackjack, rock-paper-scissors duels, dice and coin flips, rendered as animated cards and paid in BREAD, the server's own currency with hourly rewards and a leaderboard.

And everything around it

✨ Autoplay that learns	Likes, dislikes and skips shape what comes next. The next pick is ready before the queue ends, you can see it and reroll it, and recently played tracks stay out.
📻 Live radio	/radio finds stations by name, genre or country, or plays a stream or Radio Garden link. Starred stations come first everywhere.
🎚️ Sound panel	Presets like Bassboost and Nightcore, a 6-band EQ, speed and pitch. Save up to 15 of your own sounds.
💜 Your library	Liked tracks and personal playlists: save the queue, import from Spotify, YouTube or SoundCloud, share them with a code.
🎤 Synced lyrics	LRCLIB lyrics that follow the track, with autoscroll and a karaoke view in the Activity and dashboard.
🖥️ Web dashboard	Live player and queue, history, uploads, server settings, DJ roles and the economy, updated over SSE.
🛡️ Shared control	Dashboard access levels, a DJ role, vote skip that stays in sync across Discord, the Activity and the web.
💾 Survives restarts	Queues, history, settings and taste profiles live in SQLite and come back after a redeploy.

---

How it fits together

flowchart LR
    D([Discord]) <-->|commands · events| B[Bread bot<br/>Node.js · API :3001]
    B <-->|playback| L[Lavalink :2333<br/>YouTube · LavaSrc]
    B <-->|OAuth · SSE| W[Next.js :3000<br/>landing · dashboard · Activity]
    B --- S[(SQLite<br/>data/bread.sqlite)]
    B -.->|optional| X[Gemini · Last.fm<br/>Spotify · LRCLIB]

Component	What it does
Bot	Slash commands, buttons and menus, playback orchestration, autoplay
API	OAuth, dashboard and Activity data, player actions, live SSE updates
Lavalink	Audio loading and streaming, filters, YouTube and Spotify source plugins
Web	Public landing with a silent demo, the dashboard and the Discord Activity
SQLite + sessions	Guild config, queues, history, library, economy and encrypted OAuth sessions

---

Quick start

You need Node.js 22, Java 25 (for Lavalink), a Discord application with a bot token and, optionally, Spotify developer credentials.

With Docker (recommended)

git clone https://github.com/al3ksh/BreadMusic.git
cd BreadMusic
cp env.docker .env                                         # fill in, see Configuration
cp lavalink/application.example.yml lavalink/application.yml
docker compose up -d --build
docker compose exec bot npm run register

Service	Port	Container
Lavalink	2333	breadmusic-lavalink
Bot API	3001	breadmusic-bot
Web	3000	breadmusic-web

Source code is baked into the images, so after pulling changes rebuild the services that changed. Compose mounts ./data, ./lavalink/application.yml and ./lavalink/plugins, and applies bounded CPU and memory limits that can be overridden with the LAVALINK_*_LIMIT, BOT_*_LIMIT and WEB_*_LIMIT variables.

npm install
npm install --prefix web
Copy-Item .env.example .env
npm run register

Then start the stack in three terminals:

npm run dev:lavalink   # Lavalink  http://localhost:2333
npm run dev:api        # Bot + API http://localhost:3001
npm run dev:web        # Web       http://localhost:3000

Slash commands are registered globally and Discord can take up to an hour to propagate changes. DISCORD_GUILD_ID, COMMAND_GUILD_IDS and COMMAND_CLEANUP_GUILD_IDS are only used to remove legacy guild-scoped commands.

---

Configuration

The minimum .env:

여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗