Update the readme
This commit is contained in:
Thomas
2026-01-29 10:57:20 +01:00
parent 2b81d5843a
commit a9654acb5c
3 changed files with 452 additions and 0 deletions

121
V_1/README_V1.md Normal file
View File

@@ -0,0 +1,121 @@
# 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**.