# Auto Clip – V3 (DJ / Trance Focused)

**Auto Clip V3** er den mest avancerede og musikalsk fokuserede version af Auto Clip.  
Den er designet specifikt til **old school trance** og andre elektroniske genrer, hvor **bars, flow og harmonic mixing** betyder noget.

V3 er der, hvor Auto Clip går fra “smart klipper” til **mini DJ-mix teaser**.

---

## Hvad gør V3 anderledes?

V3 bygger ovenpå V2 og tilføjer:

- Harmonic mixing (key detection + Camelot mapping)
- DJ-venlig ordering af tracks
- Bar-snap (phrase-aligned cuts)
- Preroll bars (DJ lead-in)
- Bedre teaser-flow
- Konsistent loudness (loudnorm)
- Klar integration med Ollama til repo/promo-assets

---

## Install (V3) 🐍

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

pip install -U pip
pip install numpy librosa soundfile
```

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

---

## Kommandoer 🎛️  
*(optimeret til dine 14 old school trance tracks)*

---

### 1️⃣ Rollcall – alle tracks (DJ flip, harmonic ordering ON)

God til:
- album previews
- “alle tracks med”-teaser

```bash
python dj_teaser_v3.py \
  --tracks-dir ./tracks \
  --select all \
  --teaser 60 \
  --bars 2 \
  --preroll-bars 1 \
  --avoid-intro 30 \
  --harmonic
```

---

### 2️⃣ Best-of – mini-mix vibe (8 tracks, 4 bars)

God til:
- promo-teaser
- social media
- mere musikalsk sammenhæng

```bash
python dj_teaser_v3.py \
  --tracks-dir ./tracks \
  --select auto \
  --auto-n 8 \
  --teaser 75 \
  --bars 4 \
  --preroll-bars 1 \
  --avoid-intro 30 \
  --harmonic
```

---

## Typiske V3 tweaks til trance 💡

- `--avoid-intro 30` eller `45`  
  → lange trance-intros

- `--bars 2`  
  → rollcall (alle tracks hurtigt igennem)

- `--bars 4`  
  → mere “rigtig” trance / mini-mix feel

- `--preroll-bars 1`  
  → DJ lead-in (overgange føles naturlige)

- `--harmonic`  
  → næsten altid ON til trance 👌

---

## Hvordan du bruger V3 i praksis

### Byg teaser

```bash
python dj_teaser_v3.py \
  --tracks-dir ./tracks \
  --select all \
  --teaser 60 \
  --bars 2 \
  --preroll-bars 1 \
  --avoid-intro 30 \
  --harmonic
```

---

### Generér repo-ting + promo via Ollama 🤖

Hvis du kører Ollama lokalt:

```bash
pip install requests

python ollama_assets.py \
  --report ./out/teaser_report.json \
  --ollama http://192.168.2.60:11434 \
  --model llama3.1:8b-instruct-q4_0 \
  --artist DjGulvBasS \
  --genre "old school trance"
```

---

## Output 📦

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

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

---

## Begrænsninger (V3)

- Key detection er **best effort**
  - pad-heavy tracks kan give upræcis Camelot
- Downbeat er heuristisk (ikke ML-trænet)
- Ikke en erstatning for et rigtigt DJ-mix – men tæt på 😉

👉 For eksperimenter og videre udvikling, se **V4 roadmap**.

---

## Kort version

> **V3 = DJ teaser med bars, flow og harmonic mixing**  
> Brug den, når det skal lyde som et rigtigt trance-mini-mix 🔥🎛️