DJ_Teaser_Clipper/TEASER_COMPARISON.md

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)

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)

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