selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
JUGNU MUSIC logo

Self-host JUGNU MUSIC

1.0.0

High-performance Discord music bot for YouTube and Spotify

ReleaseOpen SourceMIT
Updated2 months ago
LanguageJavaScript
Setup difficultyModerate
Stars
277
Port
3000 (Express keep-alive web server)
Requires
Ffmpeg
Install with Node.js

What is JUGNU MUSIC?

JUGNU MUSIC is an open-source Discord music bot for high-fidelity audio from YouTube, Spotify, and SoundCloud. It uses in-memory LRU caching for fast search and instant cache hits, a custom yt-dlp extractor that mimics Android clients to avoid YouTube blocks, and request deduplication for concurrent usage. The bot provides over 45 slash commands and 49 message commands for playback control, queue management, custom playlists, real-time synced lyrics, audio filters like BassBoost and Nightcore, and a dedicated request channel. It supports 24/7 voice channel mode with automatic queue restoration on restart. Self-hosting requires Node.js 18.17+, Python 3.8+, and FFmpeg, with optional MongoDB for persistent storage (JSON storage used by default). An Express keep-alive server runs on port 3000. The project is MIT licensed and actively maintained.

Should you self-host JUGNU MUSIC?

JUGNU MUSIC scores 50/100 on selfhost.directory (how scoring works) and ranks #21 of 59 in Music Streaming. It has 277 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. It is MIT-licensed and written mostly in JavaScript.

Its closest alternative on selfhost.directory is koel (75/100, 17 320 stars). It scores higher overall, so compare the two before you pick. See JUGNU MUSIC vs koel side by side.

Features

  • 24/7 voice channel with auto-resume
  • Audio filters and effects
  • Custom Playlists
  • Custom yt-dlp extractor
  • Dedicated request channel
  • Discord music playback
  • In-memory LRU caching
  • Interactive button controls
  • Real-time lyrics
  • Slash Commands

JUGNU MUSIC README

How to install JUGNU MUSIC

Install JUGNU MUSIC with Node.js

Environment variables
TOKEN, PREFIX, MONGO_URL, GUILD_ID, SLASH_GLOBAL, PORT
  1. Clone the repository:

    git clone https://github.com/kabirjaipal/JUGNU-MUSIC.git
    cd JUGNU-MUSIC
    
  2. Install dependencies:

    npm install
    
  3. Configure Environment Variables: Copy .env.example to .env:

    cp .env.example .env
    

    Open .env and fill in your details:

    # Discord Bot Token & Prefix
    TOKEN=YOUR_DISCORD_BOT_TOKEN
    PREFIX=!!
    
    # Database (Optional - Uses fast JSON storage by default if omitted)
    MONGO_URL=
    
    # Slash Command Deployment
    # Provide your server ID for instant command loading, or set SLASH_GLOBAL=true
    GUILD_ID=YOUR_DISCORD_SERVER_ID
    SLASH_GLOBAL=false
    
    # Express Keep-Alive Port
    PORT=3000
    
  4. Start the bot:

    npm start
    

    (For development with auto-reload: npm run dev)

Requires Node.js >= 18.17.0, Python >= 3.8, and FFmpeg installed and in PATH

How to configure JUGNU MUSIC

  • GUILD_IDComma-separated Discord server IDs for instant slash command registration

    Comma-separated Discord server IDs for instant slash command registration

  • MONGO_URLMongoDB connection string (optional, uses JSON storage if omitted)

    MongoDB connection string (optional, uses JSON storage if omitted)

  • PORT3000Express keep-alive web server port

    Express keep-alive web server port

  • PREFIX!!Command prefix for message commands

    Command prefix for message commands

  • SLASH_GLOBALfalseSet to true to register slash commands globally (takes up to 1 hour to propagate)

    Set to true to register slash commands globally (takes up to 1 hour to propagate)

    values: true, false

  • TOKENDiscord bot token

    Discord bot token

More in Music Streaming

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…