DJ_Teaser_Clipper/V_1

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)

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

---

Vælg specifikke tracks (1-baseret index)

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

---

Range + mix

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.