DJ_Teaser_Clipper/V_2

Auto Clip – V2 (DJ Tooling & Best‑Of)

Auto Clip V2 bygger videre på V1 og er den første version, der er tænkt som et praktisk DJ‑værktøj – ikke kun et proof‑of‑concept.

V2 introducerer:

• track‑udvælgelse (manuel + auto best‑of)
• bedre teaser‑flow
• preroll og crossfade
• trance‑venlige defaults
• mulighed for at generere README / promo via Ollama

---

Hvad gør V2?

V2‑scriptet kan:

• Scanne en mappe med tracks (max 20)
• Vælge tracks:
  • alle
  • specifikke index / ranges
  • automatisk best‑of
• Undgå lange intros
• Klippe DJ‑venlige segmenter
• Samle dem med crossfade
• Eksportere:
  • album_teaser.wav
  • album_teaser.mp3
  • teaser_report.json
• (Valgfrit) generere README / promo‑tekst via Ollama

---

Install (til repo) 🐍

python -m venv .venv
source .venv/bin/activate

pip install -U pip
pip install numpy librosa soundfile requests

⚠️ FFmpeg skal være installeret og ligge i PATH

---

Mappestruktur (eksempel)

V_2/
├── dj_teaser_v2.py
├── tracks/
│   ├── 01 - Track.wav
│   ├── 02 - Track.wav
│   └── ...
└── out/

---

Anbefalede kommandoer 🎛️

(til dine 14 old school trance tracks)

---

1️⃣ Rollcall – alle tracks (hurtigt DJ‑flip)

God til:

• album previews
• “hvem er med?”‑teasers

python dj_teaser_v2.py \
  --tracks-dir ./tracks \
  --select all \
  --teaser 60 \
  --bars 2 \
  --preroll-bars 1 \
  --avoid-intro 30 \
  --crossfade 0.25

---

2️⃣ Best‑of – mini‑mix vibe

God til:

• promo‑teaser
• social media
• mere musikalsk flow

python dj_teaser_v2.py \
  --tracks-dir ./tracks \
  --select auto \
  --auto-n 8 \
  --mode bestof \
  --teaser 75 \
  --bars 4 \
  --preroll-bars 1 \
  --avoid-intro 30 \
  --crossfade 0.25

---

3️⃣ Generér README / promo via Ollama (valgfrit) 🤖

Hvis du kører Ollama lokalt, kan V2 også generere README og promo‑tekst automatisk.

python dj_teaser_v2.py \
  --tracks-dir ./tracks \
  --select auto \
  --auto-n 8 \
  --teaser 75 \
  --bars 4 \
  --ollama http://192.168.2.60:11434 \
  --ollama-model qwen2.5:latest \
  --gen-readme

ℹ️ Ollama er valgfrit – audio‑delen virker uden.

---

Output 📦

Efter kørsel ligger output i ./out/:

out/
├── album_teaser.wav
├── album_teaser.mp3
└── teaser_report.json

---

Hvad er forskellen på V1 og V2?

Feature	V1	V2
Track selection	Basis	Avanceret (index / range / auto)
Best‑of mode	❌	✅
Preroll	❌	✅
Crossfade	Simpel	Justerbar
MP3 output	❌	✅
Ollama integration	❌	⚠️ Valgfri
DJ‑flow	Basis	Mærkbart bedre

---

Begrænsninger (V2)

• Ingen harmonic mixing / Camelot
• Ingen ægte downbeat‑detektion
• Key detection bruges ikke til ordering

👉 For trance‑venligt DJ‑flow, se V3.

---

Næste skridt

• V3: harmonic mixing, Camelot, loudnorm, bar‑snap
• V4: single CLI, bedre phrase‑logik, tempo‑normalisering