readme
name
This commit is contained in:
121
V_1/README_V1.md
121
V_1/README_V1.md
@@ -1,121 +0,0 @@
|
||||
# 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**.
|
||||
Reference in New Issue
Block a user