nwe files

some files

TEASER_COMPARISON.md

@@ -0,0 +1,66 @@
+# Teaser Comparison (Before / After)
+
+This doc is a template you can fill in after generating teasers with different versions/settings.
+
+The goal: make it obvious *what improved* and *why it sounds more DJ-like*.
+
+---
+
+## How to generate comparable teasers
+
+Use the **same input folder** and keep teaser length constant.
+
+### V2 (baseline)
+```bash
+cd V_2
+python dj_teaser_v2.py --tracks-dir ./tracks --select all --teaser 60 --bars 2 --preroll-bars 0
+# output: out/album_teaser.mp3
+```
+
+### V3 (DJ-focused)
+```bash
+cd V_3
+python dj_teaser_v3.py --tracks-dir ./tracks --select all --teaser 60 --bars 2 --preroll-bars 1 --avoid-intro 30 --harmonic
+# output: out/album_teaser.mp3
+```
+
+Optional: also compare `--bars 4` for a mini-mix feel.
+
+---
+
+## What to listen for (checklist)
+
+### A) Grid / phrasing
+- [ ] Cuts land on bar boundaries
+- [ ] Kick is not chopped mid-hit
+- [ ] Transitions feel “countable” (1-2-3-4)
+
+### B) Loudness consistency
+- [ ] No harsh jumps between clips
+- [ ] No sudden distortion/clipping
+
+### C) Harmonic smoothness
+- [ ] Fewer “key clashes”
+- [ ] Transitions feel less dissonant
+
+### D) Teaser pacing
+- [ ] Energy builds naturally
+- [ ] No long dead intros
+
+---
+
+## Fill-in results table
+
+| Test | Output file | Notes (what you hear) |
+|------|-------------|------------------------|
+| V2 bars=2 preroll=0 | `...` | ... |
+| V3 bars=2 preroll=1 harmonic | `...` | ... |
+| V3 bars=4 preroll=1 harmonic | `...` | ... |
+
+---
+
+## Suggested artifacts to include in the repo (optional)
+
+- A short 15s sample MP3 from V2 and V3 (if you can legally share it)
+- A screenshot/waveform image showing smoother transitions
+- The `teaser_report.json` for each comparison run