# 🎵 VIZ — Audio Visualizer Studio für DaVinci Resolve

Ein modernes, hochgradig anpassbares Audio-Visualizer Tool zur Erstellung professioneller Musikvideos und Social-Media-Clips (YouTube, TikTok, Shorts, Reels) mit direktem Export von **transparenten Videos (ProRes 4444 mit Alpha-Kanal)** für **DaVinci Resolve**.

---

## ✨ Features

- **⭕ Zentraler Kreis & Artwork-Core**:
  - Dynamischer Bass-Pulse & Bounce im Takt (sub-bass / kick-reaktiv).
  - 0–360° Fortschrittsring um das Artwork.
  - Vinyl-Drehung & Beat-Drehimpuls bei Drops.
  - Randfarben, Stärken & Glow frei anpassbar.
- **📊 360° Frequenzspektrum**:
  - 4 Modi: **Balken (Bars)**, **Flüssige Welle (Wave)**, **Punkte (Dots)** und **Dual Ring**.
  - Anpassbare Balkenanzahl, Höhe, Frequenzempfindlichkeit & Symmetrie-Spiegelung.
  - Eigener Gradient-Editor (Winkelverlauf, Radial, Linear, Regenbogen).
- **✨ Partikel- & Raum-Effekte**:
  - Schwebender Sternenstaub & Warp-Explosion bei Drops.
  - Dynamischer Bass-Shake & Cam-Zoom.
  - RGB-Split / Chromatic Aberration & Beat-Flash.
- **📝 Typografie & Safe-Zones**:
  - Titel, Artist und Live-Timecode Overlay.
  - Umschaltung zwischen **16:9** (YouTube 1080p/4K), **9:16** (Shorts/TikTok) und **1:1** (Instagram).
  - Einblendbares **Shorts Safe-Zone Overlay** zur optimalen Platzierung.
- **🎬 DaVinci Resolve Export**:
  - **QuickTime ProRes 4444 (.mov)** mit echtem 100% Alpha-Kanal für verlustfreie Studioqualität.
  - **WebM VP9 (.webm)** mit Alpha-Kanal für kompakte Dateigrößen.
  - **MP4 (H.264)** für fertige Standalone-Videos.
- **💾 Preset-Manager**:
  - Vorgefertigte Styles (*Trap Nation Classic*, *Cyberpunk Neon*, *Minimal Clean*, *Fire & Amber*, *Matrix Glitch*, *Deep Violet*).
  - Eigene Presets als JSON speichern, exportieren und importieren.

---

## 🚀 Schnelle Inbetriebnahme (Lokal auf Windows)

### 1. Per 1-Klick
Einfach einen **Doppelklick** auf die Datei **`Start-Local.bat`** ausführen.
Das Skript installiert bei Bedarf die Abhängigkeiten und öffnet automatisch deinen Browser unter `http://localhost:849`.

### 2. Manuell über Terminal
```bash
# Repository klonen
git clone https://git.orfel.de/Jannik/Viz.git
cd Viz

# Abhängigkeiten installieren
npm install

# Server starten
npm start
```
Die Web-App ist nun unter **`http://localhost:849`** erreichbar.

---

## 🎬 DaVinci Resolve Workflow (So nutzt du das exportierte Video)

1. Öffne dein Projekt in **DaVinci Resolve**.
2. Ziehe die aus **VIZ** exportierte `.mov` Datei (ProRes 4444 mit Alpha) in deinen Media Pool.
3. Lege deinen Hintergrund (Video, B-Roll oder KI-Animation) auf **Video-Spur 1 (V1)**.
4. Ziehe den exportierten Visualizer-Clip auf **Video-Spur 2 (V2)** direkt darüber.
5. Da der Hintergrund der Datei transparent ist, legt sich der pulsierende Kreis und das Spektrum perfekt über dein Footage!

---

## ☁️ Deployment in Jannik-Cloud (Docker Compose)

VIZ ist als nativer Service in **Jannik-Cloud** integriert:
- **Subdomain**: `https://viz.orfel.de`
- **Port**: `849`
- **Volume**: `/mnt/Jannik-Cloud-Volume-01/viz:/data` (Upload-Zwischenspeicher mit automatischem Cleanup bei jedem Rebuild).

---

## 🛠️ Technologien

- **Frontend**: HTML5 Canvas (60 FPS Multi-Layer Rendering), Web Audio API, Vanilla CSS (Glassmorphism Dark Theme).
- **Backend**: Node.js, Express, Multer (200 MB Upload-Limit), FFmpeg Video Rendering Engine.

---

## 📄 Lizenz
MIT License — Erstellt von Jannik.