122 lines
2.0 KiB
Markdown
122 lines
2.0 KiB
Markdown
# 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**.
|