Modern
Touchscreen Jukebox

A web-based music system designed specifically for large touch displays. Combines local MP3 collections with Spotify streaming. Built for dedicated hardware jukeboxes, events, and kiosk-style music stations.

Notice: This project was developed for my personal use as a touch display hardware jukebox. It's optimized for large touchscreens, not mobile devices. Code quality is admittedly poor and was written for functionality over best practices.

🎵 View Demo View Source
nJukebox Interface

Powerful Features

Everything you need for a complete digital music experience

🎵

Local Music Library

Scan and organize your MP3 collection with automatic metadata detection, album art extraction, and smart categorization by artist, album, genre, and decade.

🟢

Spotify Integration

Seamlessly integrate with Spotify Premium for access to millions of tracks. Mix local and streaming music in the same interface.

🎛️

Admin Controls

PIN-protected admin panel with playlist management, auto-DJ settings, and comprehensive system controls for events and parties.

🎨

Visual Experience

Dynamic visualizations with space themes, fire effects, particles, and circles. Customizable themes and real-time audio visualization.

🌍

Multi-Language

Built-in internationalization support with German and English languages. Easy to extend for additional languages.

📱

Large Touch Display

Optimized specifically for large touch screens and kiosk setups. Big buttons, clear typography, and intuitive touch interactions designed for hardware jukeboxes.

🤖

Auto-DJ Mode

Intelligent playlist generation that keeps the music flowing when the queue is empty. Smart track selection based on listening history.

📊

Analytics & Reports

Detailed play statistics, GEMA reporting for German events, and comprehensive usage analytics for event organizers.

See It In Action

Designed for parties and celebrations

nJukebox Main Interface Now Playing Search Interface Admin Panel
Main Main Interface
Now Playing Now Playing
Search Search
Admin Admin Panel
🎯

Intuitive Interface

Browse your music library by artist, album, genre, or decade with our clean, modern interface.

🎵

Real-time Visualization

Enjoy stunning audio visualizations that react to your music in real-time.

📱

Touch Screen Hardware

Designed specifically for large touch displays and dedicated jukebox hardware setups.

Quick Setup

Get nJukebox running in minutes

1

Clone Repository

Download the latest version from GitHub

git clone https://github.com/Nigcra/nJukebox.git
2

Install Dependencies

Install Node.js dependencies for the backend server

cd jukebox && npm install
3

Add Your Music

Place your MP3 files in the music/ directory

cp /path/to/your/music/* ./music/
4

Start the System

Launch both the data server and web interface

npm run start
💡
Notice: For Spotify integration, you'll need a Spotify Premium account and API credentials. Check our documentation for detailed setup instructions.

Support the Project

Help keep nJukebox alive and growing

nJukebox is a free, open-source project developed with passion in my spare time. If you find it useful and want to support its continued development, consider buying me a coffee or becoming a sponsor!

Your support helps me:

  • 💻 Dedicate more time to development and new features
  • 🐛 Fix bugs and improve stability
  • 📚 Create better documentation and tutorials
  • 🌟 Keep the project maintained and up-to-date

Ko-fi

One-time donation

Einmalige Spende

Recommended

💚 Every contribution, no matter how small, is deeply appreciated and motivates me to keep improving nJukebox!

Documentation

Everything you need to know about nJukebox

🚀

Getting Started

Installation, basic setup, and your first music session

Read Guide →
🟢

Spotify Setup

Configure Spotify integration for streaming music

Setup Guide →
🎛️

Admin Guide

Admin panel features, settings, and event management

Learn More →
🔧

Configuration

Advanced configuration options and customization

Configure →
🐛

Troubleshooting

Common issues and their solutions

Get Help →