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

164 lines
3.0 KiB
Markdown
Raw Permalink 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 V3 (DJ / Trance Focused)
**Auto Clip V3** er den mest avancerede og musikalsk fokuserede version af Auto Clip.
Den er designet specifikt til **old school trance** og andre elektroniske genrer, hvor **bars, flow og harmonic mixing** betyder noget.
V3 er der, hvor Auto Clip går fra “smart klipper” til **mini DJ-mix teaser**.
---
## Hvad gør V3 anderledes?
V3 bygger ovenpå V2 og tilføjer:
- Harmonic mixing (key detection + Camelot mapping)
- DJ-venlig ordering af tracks
- Bar-snap (phrase-aligned cuts)
- Preroll bars (DJ lead-in)
- Bedre teaser-flow
- Konsistent loudness (loudnorm)
- Klar integration med Ollama til repo/promo-assets
---
## Install (V3) 🐍
```bash
python -m venv .venv
source .venv/bin/activate
pip install -U pip
pip install numpy librosa soundfile
```
> ⚠️ **FFmpeg skal være installeret og ligge i PATH**
---
## Kommandoer 🎛️
*(optimeret til dine 14 old school trance tracks)*
---
### 1⃣ Rollcall alle tracks (DJ flip, harmonic ordering ON)
God til:
- album previews
- “alle tracks med”-teaser
```bash
python dj_teaser_v3.py \
--tracks-dir ./tracks \
--select all \
--teaser 60 \
--bars 2 \
--preroll-bars 1 \
--avoid-intro 30 \
--harmonic
```
---
### 2⃣ Best-of mini-mix vibe (8 tracks, 4 bars)
God til:
- promo-teaser
- social media
- mere musikalsk sammenhæng
```bash
python dj_teaser_v3.py \
--tracks-dir ./tracks \
--select auto \
--auto-n 8 \
--teaser 75 \
--bars 4 \
--preroll-bars 1 \
--avoid-intro 30 \
--harmonic
```
---
## Typiske V3 tweaks til trance 💡
- `--avoid-intro 30` eller `45`
→ lange trance-intros
- `--bars 2`
→ rollcall (alle tracks hurtigt igennem)
- `--bars 4`
→ mere “rigtig” trance / mini-mix feel
- `--preroll-bars 1`
→ DJ lead-in (overgange føles naturlige)
- `--harmonic`
→ næsten altid ON til trance 👌
---
## Hvordan du bruger V3 i praksis
### Byg teaser
```bash
python dj_teaser_v3.py \
--tracks-dir ./tracks \
--select all \
--teaser 60 \
--bars 2 \
--preroll-bars 1 \
--avoid-intro 30 \
--harmonic
```
---
### Generér repo-ting + promo via Ollama 🤖
Hvis du kører Ollama lokalt:
```bash
pip install requests
python ollama_assets.py \
--report ./out/teaser_report.json \
--ollama http://192.168.2.60:11434 \
--model llama3.1:8b-instruct-q4_0 \
--artist DjGulvBasS \
--genre "old school trance"
```
---
## Output 📦
Efter kørsel ligger output i `./out/`:
```
out/
├── album_teaser.wav
├── album_teaser.mp3
└── teaser_report.json
```
---
## Begrænsninger (V3)
- Key detection er **best effort**
- pad-heavy tracks kan give upræcis Camelot
- Downbeat er heuristisk (ikke ML-trænet)
- Ikke en erstatning for et rigtigt DJ-mix men tæt på 😉
👉 For eksperimenter og videre udvikling, se **V4 roadmap**.
---
## Kort version
> **V3 = DJ teaser med bars, flow og harmonic mixing**
> Brug den, når det skal lyde som et rigtigt trance-mini-mix 🔥🎛️