# Auto Clip – V1 (Minimal MVP)

**Auto Clip V1** er den første og mest simple version af projektet.  
Formålet er at lave en **hurtig proof-of-concept DJ teaser**, hvor korte klip fra flere tracks samles til én teaser.

V1 fokuserer på:
- simpel track-udvælgelse
- hurtig teaser-render
- minimal DJ-logik

---

## Hvad gør V1?

Scriptet:

- Scanner en mappe med audio-tracks
- Vælger tracks manuelt eller automatisk
- Klipper korte segmenter fra hvert track
- Samler dem til en teaser
- Eksporterer:
  - `album_teaser.wav`
  - `teaser_report.json`

> ⚠️ V1 har **ingen** harmonic mixing, Camelot, preroll eller avanceret DJ-logik.  
> For mere “DJ-feel”, se **V2** og **V3**.

---

## Krav

- Python 3.10+
- FFmpeg installeret og i PATH
- En mappe med audiofiler (`wav`, `mp3`, osv.)

---

## Mappestruktur (eksempel)

```
V_1/
├── dj_teaser.py
├── tracks/
│   ├── 01 - Track.wav
│   ├── 02 - Track.wav
│   └── ...
└── out/
```

---

## Brug 🚀

### Scan mappe og brug alle tracks (max 20)

```bash
python dj_teaser.py \
  --tracks-dir ./tracks \
  --select all \
  --mode rollcall \
  --teaser 60 \
  --bars 2
```

---

### Vælg specifikke tracks (1-baseret index)

```bash
python dj_teaser.py \
  --tracks-dir ./tracks \
  --select 1,2,3,7,9 \
  --teaser 60 \
  --bars 2
```

---

### Range + mix

```bash
python dj_teaser.py \
  --tracks-dir ./tracks \
  --select 1-4,7,10-12 \
  --teaser 60 \
  --bars 2
```

---

## Output 📦

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

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

### `album_teaser.wav`
Den færdige teaser (samlede klip).

### `teaser_report.json`
Metadata om:
- hvilke tracks der blev brugt
- rækkefølge
- kliplængder og timing

---

## Begrænsninger (V1)

- Ingen harmonic mixing
- Ingen Camelot / key detection
- Ingen preroll
- Cuts er simple (ingen downbeat-snap)
- Loudness kan variere mellem tracks

👉 **V1 er ment som baseline / MVP**.  
For mere avanceret DJ-flow og trance-venlige teasers, brug **V2** eller **V3**.