# 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