Projects

nytrex-labs / dj-bot

BETA TESTbetaGitHub

DJ Bot

Discord Bot // Music & DJ booth

DJ Bot plays YouTube links, Spotify and Apple Music song links, direct audio URLs, radio streams, and local files straight into your voice channel — controlled by clean slash commands and now-playing cards. It includes a rotating DJ booth so the whole room can take turns: each DJ adds tracks to their own crate and the bot plays one per person before rotating.

README.md

Project objective

The beta is focused on stable playback, sensible queue behaviour, radio, and a DJ booth rotation that feels natural to normal Discord users.

Current scope

One /play for everything

YouTube, Spotify/Apple Music links, direct URLs, radio streams, and local files.

Queue & controls

Skip, pause, resume, volume, now-playing — plus Like/Dislike/Vote-Skip/Stop buttons.

Radio

Search and stream thousands of stations via the Radio Browser directory.

DJ booth

Plug.dj-style rotation: each DJ fills a crate and the bot plays one track per person.

Smart source resolution

Spotify/Apple links resolve to a playable YouTube match — no protected audio is streamed.

Idle-aware

Leaves the voice channel after an idle timeout to keep things tidy.

Repository snapshot

README.md

Overview, command reference, and full configuration options.

src/index.js

The bot: commands, player, queue, radio, DJ booth, and source resolver.

music/

Local audio files you drop in to play with /play.

ecosystem.config.cjs

PM2 process config for 24/7 hosting (process name: dj-dan).

.env.example

Every configuration option, annotated.

Command reference

/play

Queue a YouTube/Spotify/Apple link, direct URL, radio stream, or local file.

/queue

Show what is playing and what is next.

/skip

Skip the current track.

/volume

Set playback volume (0–100).

/radio play

Find and stream a matching radio station.

/dj join

Join the DJ booth rotation.

/dj add

Add a track to your personal DJ crate.

/voteskip

Vote to skip the current track.

Beta protocol

01

Invite the bot

Add DJ Bot with the bot + applications.commands scopes and voice access.

02

Join a voice channel

Hop into voice and start playback with /play.

03

Try the DJ booth

Run /dj join, then /dj add to queue your crate and take turns.

04

Send feedback

Report queue issues, missing controls, or anything that feels clunky.

Known beta limits

Access is invite-only during the beta.

Spotify and Apple Music links play via a matched YouTube source, not protected audio.

Some cloud hosts need fresh YouTube cookies for reliable playback.