From 47dc9c212fd596f2ffe81f0f718639193f90676a Mon Sep 17 00:00:00 2001
From: vibe-bot <bot@local>
Date: Sun, 10 Aug 2025 01:27:53 +0200
Subject: [PATCH] Docs: Rewrote README in English  v1.1.0 features, quick
 start, admin guide, Partymode, Docker

---
 README.md | 84 +++++++++++++++++--------------------------------------
 1 file changed, 25 insertions(+), 59 deletions(-)

diff --git a/README.md b/README.md
index 3301e76..fd0f395 100644
--- a/README.md
+++ b/README.md
@@ -1,93 +1,59 @@
-# 🎵 Jukebox 420 - Discord Soundboard v1.0.0
+# Jukebox 420 – Discord Soundboard (v1.1.0)
 
-Ein modernes, feature-reiches Discord Soundboard mit Web-Frontend, Discord-Bot und Docker-Deployment. Perfekt für Gaming-Communities, Streamer und Discord-Server.
+A modern, self‑hosted Discord soundboard with a slick web UI and a Discord bot that plays sounds into your voice channels. Easy to run via Docker, fun to use with friends.
 
-![Version](https://img.shields.io/badge/version-1.0.0-blue)
+![Version](https://img.shields.io/badge/version-1.1.0-blue)
 ![Docker](https://img.shields.io/badge/docker-ready-green)
 ![Discord](https://img.shields.io/badge/discord-bot-purple)
 
 ## ✨ 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
+- Web UI (Vite + React + TypeScript), 3 themes (Dark, Rainbow, 420)
+- Discord bot (discord.js + @discordjs/voice)
+- MP3 & WAV playback, ffmpeg normalization
+- Favorites, search, folders view (auto counters)
+- Live counters and a clean header/footer
+- Admin area: bulk delete, inline rename, categories (CRUD) + bulk assign, remove custom badges
+- Partymode: server‑side random playback every 30–90 seconds, globally synced via SSE; Panic stops for everyone
+- Persistent state: volumes, plays, totalPlays, categories, badges in `/data/sounds/state.json`
 
-### 🎨 **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
+## 🚀 Quick start
 
-### 🔧 **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`
+### 1. Requirements
+- Docker & Docker Compose
+- Discord bot token with intents: `Guilds`, `GuildVoiceStates`, `DirectMessages`
 
 ### 2. Setup
 ```bash
-# Repository klonen
+# Clone repository
 git clone https://github.com/flex420/jukebox-vibe.git
 cd jukebox-vibe
 
-# .env Datei erstellen
+# Create .env
 cp .env.example .env
 ```
 
-### 3. Konfiguration
+### 3. Configuration
 ```env
-# .env Datei bearbeiten
-DISCORD_TOKEN=dein_discord_bot_token_hier
+# Edit the .env file
+DISCORD_TOKEN=your_discord_bot_token_here
+ADMIN_PWD=choose-a-strong-password
 PORT=8080
 SOUNDS_DIR=/data/sounds
 
-# Optional: Bestimmte Server erlauben
+# Optionally restrict allowed guilds
 ALLOWED_GUILD_IDS=GUILD_ID_1,GUILD_ID_2
-
-# Optional: Audio-Normalisierung
-NORMALIZE_AUDIO=true
-NORMALIZE_TARGET=-14
-NORMALIZE_THRESHOLD=-70
 ```
 
 ### 4. Deployment
 ```bash
-# Container starten
+# Start container
 docker compose up --build -d
 
-# Logs anzeigen
+# Logs
 docker compose logs -f
 
-# Status prüfen
+# Status
 docker compose ps
 ```