# 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) 🐍

```bash
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

```bash
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

```bash
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.

```bash
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