Files
DJ_Teaser_Clipper/V_1/readme.md
2026-01-29 11:01:21 +01:00

2.0 KiB
Raw Permalink Blame History

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.