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

169 lines
3.1 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Auto Clip V2 (DJ Tooling & BestOf)
**Auto Clip V2** bygger videre på V1 og er den første version, der er tænkt som et **praktisk DJværktøj** ikke kun et proofofconcept.
V2 introducerer:
- trackudvælgelse (manuel + auto bestof)
- bedre teaserflow
- preroll og crossfade
- trancevenlige defaults
- mulighed for at generere README / promo via Ollama
---
## Hvad gør V2?
V2scriptet kan:
- Scanne en mappe med tracks (max 20)
- Vælge tracks:
- alle
- specifikke index / ranges
- automatisk *bestof*
- Undgå lange intros
- Klippe DJvenlige segmenter
- Samle dem med crossfade
- Eksportere:
- `album_teaser.wav`
- `album_teaser.mp3`
- `teaser_report.json`
- (Valgfrit) generere README / promotekst via Ollama
---
## Install (til repo) 🐍
```bash
python -m venv .venv
source .venv/bin/activate
pip install -U pip
pip install numpy librosa soundfile requests
```
> ⚠️ **FFmpeg skal være installeret og ligge i PATH**
---
## Mappestruktur (eksempel)
```
V_2/
├── dj_teaser_v2.py
├── tracks/
│ ├── 01 - Track.wav
│ ├── 02 - Track.wav
│ └── ...
└── out/
```
---
## Anbefalede kommandoer 🎛️
*(til dine 14 old school trance tracks)*
---
### 1⃣ Rollcall alle tracks (hurtigt DJflip)
God til:
- album previews
- “hvem er med?”teasers
```bash
python dj_teaser_v2.py \
--tracks-dir ./tracks \
--select all \
--teaser 60 \
--bars 2 \
--preroll-bars 1 \
--avoid-intro 30 \
--crossfade 0.25
```
---
### 2⃣ Bestof minimix vibe
God til:
- promoteaser
- social media
- mere musikalsk flow
```bash
python dj_teaser_v2.py \
--tracks-dir ./tracks \
--select auto \
--auto-n 8 \
--mode bestof \
--teaser 75 \
--bars 4 \
--preroll-bars 1 \
--avoid-intro 30 \
--crossfade 0.25
```
---
### 3⃣ Generér README / promo via Ollama (valgfrit) 🤖
Hvis du kører Ollama lokalt, kan V2 også generere README og promotekst automatisk.
```bash
python dj_teaser_v2.py \
--tracks-dir ./tracks \
--select auto \
--auto-n 8 \
--teaser 75 \
--bars 4 \
--ollama http://192.168.2.60:11434 \
--ollama-model qwen2.5:latest \
--gen-readme
```
> Ollama er **valgfrit** audiodelen virker uden.
---
## Output 📦
Efter kørsel ligger output i `./out/`:
```
out/
├── album_teaser.wav
├── album_teaser.mp3
└── teaser_report.json
```
---
## Hvad er forskellen på V1 og V2?
| Feature | V1 | V2 |
|------|----|----|
| Track selection | Basis | Avanceret (index / range / auto) |
| Bestof mode | ❌ | ✅ |
| Preroll | ❌ | ✅ |
| Crossfade | Simpel | Justerbar |
| MP3 output | ❌ | ✅ |
| Ollama integration | ❌ | ⚠️ Valgfri |
| DJflow | Basis | Mærkbart bedre |
---
## Begrænsninger (V2)
- Ingen harmonic mixing / Camelot
- Ingen ægte downbeatdetektion
- Key detection bruges ikke til ordering
👉 For **trancevenligt DJflow**, se **V3**.
---
## Næste skridt
- **V3**: harmonic mixing, Camelot, loudnorm, barsnap
- **V4**: single CLI, bedre phraselogik, temponormalisering