🎵 Jukebox 420 - Discord Soundboard v1.0.0

Ein modernes, feature-reiches Discord Soundboard mit Web-Frontend, Discord-Bot und Docker-Deployment. Perfekt für Gaming-Communities, Streamer und Discord-Server.

✨ Features

🎮 Kern-Funktionen

• Web-Frontend mit modernem UI und 3 Themes (Dark, Rainbow, 420)
• Discord-Bot für Voice-Channel Integration
• Sound-Management mit Ordner-Unterstützung
• Live-Uhrzeit (Berlin Timezone)
• Volume Control pro Server
• Favoriten-System mit Cookie-Persistenz

🎨 UI/UX Features

• 3 Themes: Dark, Rainbow, 420 (Cannabis/Trippy)
• Responsive Design für Desktop & Mobile
• Glassmorphism-Effekte mit Backdrop-Blur
• Animierte Hintergründe (Rainbow & 420 Theme)
• Live-Zähler für Sounds und Abspielungen

🔧 Admin-Funktionen

• Admin-Login (Passwort-basiert)
• Bulk-Delete für mehrere Sounds
• Sound-Umbenennen mit Inline-Editor
• Checkbox-Auswahl für Massenoperationen

🎵 Audio-Features

• MP3 & WAV Support für Uploads und Playback
• Audio-Normalisierung (Loudnorm)
• URL-Download für MP3/WAV Links
• Random-Play für zufällige Sounds
• Panic-Button zum sofortigen Stoppen

📁 Organisation

• Ordner-Unterstützung mit Tab-Navigation
• Favoriten-Tab für gespeicherte Sounds
• Neu-Tab für die letzten 10 Uploads
• Most Played für Top 3 Sounds
• Suchfunktion für alle Sounds

🚀 Quick Start

1. Voraussetzungen

• Docker & Docker Compose
• Discord Bot Token mit folgenden Intents:
  • Guilds
  • GuildVoiceStates
  • DirectMessages
  • MessageContent

2. Setup

# Repository klonen
git clone https://github.com/flex420/jukebox-vibe.git
cd jukebox-vibe

# .env Datei erstellen
cp .env.example .env

3. Konfiguration

# .env Datei bearbeiten
DISCORD_TOKEN=dein_discord_bot_token_hier
PORT=8080
SOUNDS_DIR=/data/sounds

# Optional: Bestimmte Server erlauben
ALLOWED_GUILD_IDS=GUILD_ID_1,GUILD_ID_2

# Optional: Audio-Normalisierung
NORMALIZE_AUDIO=true
NORMALIZE_TARGET=-14
NORMALIZE_THRESHOLD=-70

4. Deployment

# Container starten
docker compose up --build -d

# Logs anzeigen
docker compose logs -f

# Status prüfen
docker compose ps

5. Zugriff

• Web-Interface: http://localhost:8199
• Health Check: http://localhost:8199/api/health

🎯 Verwendung

Erste Schritte

1. Discord Bot einladen mit Voice-Permissions
2. Sounds hochladen via DM an den Bot (MP3/WAV)
3. Web-Interface öffnen und Theme wählen
4. Voice-Channel auswählen und Sounds abspielen

Admin-Panel

1. Admin-Login mit Passwort
2. Sounds auswählen via Checkboxen
3. Bulk-Delete oder Umbenennen durchführen
4. Logout zum Beenden

URL-Downloads

• MP3/WAV Links in das URL-Feld eingeben
• Download-Button klicken
• Automatische Integration in Soundboard

🎨 Themes

Dark Theme

• Klassisches dunkles Design
• Blaue Akzente (#0a84ff)
• Glassmorphism-Effekte

Rainbow Theme

• Animierter Regenbogen-Hintergrund
• Bunte Borders und Effekte
• 15s Animation-Loop

420 Theme

• Cannabis-grüne Farbpalette
• Trippy animierte Gradienten
• 20s Animation-Loop
• Grüne Glow-Effekte

📊 API Endpunkte

Public Endpoints

GET  /api/health          # Health Check + Statistiken
GET  /api/sounds          # Sound-Liste mit Ordner-Struktur
GET  /api/channels        # Voice-Channel Liste
POST /api/play            # Sound abspielen
POST /api/play-url        # URL downloaden & abspielen
POST /api/stop            # Aktuellen Sound stoppen
GET  /api/volume          # Volume abrufen
POST /api/volume          # Volume setzen

Admin Endpoints

POST /api/admin/login     # Admin-Login
POST /api/admin/logout    # Admin-Logout
GET  /api/admin/status    # Login-Status
POST /api/admin/sounds/delete  # Sounds löschen
POST /api/admin/sounds/rename  # Sound umbenennen

🔧 Discord Bot Commands

DM Commands

• ?help - Hilfe anzeigen
• ?list - Alle Sounds auflisten
• ?restart - Bot neu starten (mit Bestätigung)

Upload via DM

• MP3/WAV Dateien direkt an Bot senden
• Automatische Speicherung in /data/sounds
• Sofortige Verfügbarkeit im Frontend

🐳 Docker Deployment

Docker Compose (Empfohlen)

# docker-compose.yml
services:
  app:
    build: .
    container_name: discord-soundboard
    ports:
      - "8199:8080"
    env_file:
      - .env
    volumes:
      - ./data/sounds:/data/sounds
    restart: unless-stopped

Docker Run

docker run -d \
  --name jukebox-420 \
  -p 8199:8080 \
  --env-file .env \
  -v $(pwd)/data/sounds:/data/sounds \
  flex420/jukebox-vibe:latest

Docker Hub

# Image pullen
docker pull flex420/jukebox-vibe:latest

# Container starten
docker run -d --name jukebox-420 -p 8199:8080 --env-file .env -v $(pwd)/data/sounds:/data/sounds flex420/jukebox-vibe:latest

📁 Projekt-Struktur

jukebox-vibe/
├── server/                 # Backend (Node.js/Express)
│   ├── src/
│   │   ├── index.ts       # Main Server + Discord Bot
│   │   └── types/         # TypeScript Definitions
│   ├── package.json
│   └── tsconfig.json
├── web/                   # Frontend (React/Vite)
│   ├── src/
│   │   ├── App.tsx        # Main React Component
│   │   ├── api.ts         # API Client
│   │   ├── styles.css     # Theme Styles
│   │   └── types.ts       # TypeScript Types
│   ├── package.json
│   └── index.html
├── docker-compose.yml     # Docker Compose Config
├── Dockerfile            # Multi-Stage Build
├── .env.example          # Environment Template
└── README.md             # Diese Datei

🔧 Entwicklung

Lokale Entwicklung

# Backend
cd server
npm install
npm run dev

# Frontend (neues Terminal)
cd web
npm install
npm run dev

Build

# Production Build
docker build -t jukebox-vibe .

# Development Build
docker build --target development -t jukebox-vibe:dev .

📈 Statistiken

Persistente Daten

• Sounds: /data/sounds/ (Volume Mount)
• State: /data/sounds/state.json (Volume, Channel, Plays)
• Favoriten: Browser Cookies
• Theme: Browser LocalStorage

Monitoring

• Health Check: /api/health
• Docker Logs: docker compose logs -f
• Container Status: docker compose ps

🛠️ Troubleshooting

Häufige Probleme

Bot joint nicht Voice-Channel:

• Prüfe Bot-Permissions (Voice)
• Prüfe Intents in Discord Developer Portal
• Prüfe Network/Firewall

Sounds werden nicht angezeigt:

• Prüfe Volume Mount /data/sounds
• Prüfe Datei-Permissions
• Prüfe Bot-Uploads via DM

Admin-Login funktioniert nicht:

• Prüfe Browser-Cookies
• Prüfe Admin-Passwort
• Prüfe Server-Logs

Logs anzeigen

# Docker Compose Logs
docker compose logs -f

# Container-spezifische Logs
docker compose logs -f app

# Letzte 100 Zeilen
docker compose logs --tail=100 app

🤝 Contributing

1. Fork das Repository
2. Feature Branch erstellen (git checkout -b feature/AmazingFeature)
3. Commit Änderungen (git commit -m 'Add AmazingFeature')
4. Push zum Branch (git push origin feature/AmazingFeature)
5. Pull Request erstellen

📄 Lizenz

Dieses Projekt ist unter der MIT Lizenz lizenziert - siehe LICENSE Datei für Details.

🙏 Credits

• Discord.js für Bot-Funktionalität
• React für das Frontend
• Vite für Build-Tooling
• Docker für Containerisierung
• Tailwind CSS für Styling

---

🎵 Jukebox 420 - Dein ultimatives Discord Soundboard! 🚀