Files
Andrew Beveridge ☄️andClaude Opus 5.5 85390fd12b docs: medley-making guide + spec-driven make_medley script (#1174)
## Summary
Documents the multi-song medley process used for the first
classic-country medley, and turns it into a reusable script so the next
one only needs a spec file.

- `docs/MEDLEYS.md`: the full process. One gen job per original song,
then identical cuts on every audio variant, and the reviewed lyrics
shifted onto the medley timeline and rendered with gen's own
`OutputGenerator`. Also covers how to choose cut points (crossfades,
pot-out/pot-in, keys/tempos, checking the brief against the recording)
and gotchas.
- `scripts/medley/make_medley.py`: `fetch` (Firestore + gcloud CLI) →
`audio` (per-section LUFS gain, crossfade/gap/pot fades, `loudnorm` to
-14 LUFS / -1 dBTP, three variants) → `video` (shifted reviewed lyrics +
countdown + themed title/end screens + karaoke and guide MP4s).
- `scripts/medley/example-spec.json`: the country medley as a worked
example.
- Linked from `CLAUDE.md` Quick Reference and `docs/README.md`.

Ops tooling only. No backend or frontend change, so no version bump.

## Testing
- `tests/unit/test_make_medley.py`: 12 unit tests covering spec
validation, the timeline offset maths, lyric-segment shifting (including
the same song used twice) and the ffmpeg filtergraph.
- End-to-end run against the real prod jobs: `fetch` → `audio`
reproduces the hand-built v1 medley **bit-for-bit** (max sample diff 0.0
on both the instrumental and guide WAVs). `video --resolution 360p`
renders both MP4s and the LRC.
- Local CodeRabbit review: 1 finding (unchecked ffmpeg exit code in
`measure_lufs`), fixed.

@coderabbitai ignore

🤖 Generated with [Claude Code](https://claude.com/claude-code)

https://claude.ai/code/session_01QV2TQwyC7pwVkGPCk98Bqg

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-16 19:44:27 -04:00

19 lines
1.0 KiB
JSON

{
"title": "Classic Country Medley",
"artist": "George Jones, Kris Kristofferson, George Strait & Randy Travis",
"theme_job_id": "a70794e2",
"workdir": "work",
"outdir": "out",
"sections": [
{"label": "He Stopped Loving Her Today (verse 1)", "job_id": "a70794e2", "start": 0.0, "end": 54.0},
{"label": "Help Me Make It Through the Night (intro, verse 1, chorus)", "job_id": "0ac008b5", "start": 0.0, "end": 52.0,
"join": "crossfade", "join_duration": 2.0},
{"label": "Amarillo by Morning (fiddle intro, verse 1, chorus)", "job_id": "4c90a9a2", "start": 0.0, "end": 57.0,
"join": "crossfade", "join_duration": 2.0},
{"label": "On the Other Hand (verse 1, chorus, pot out on 'hand')", "job_id": "6a9ce5e2", "start": 0.0, "end": 82.0,
"join": "crossfade", "join_duration": 2.0, "fade_out_start": 80.7},
{"label": "He Stopped Loving Her Today (fiddle bridge to end)", "job_id": "a70794e2", "start": 132.2, "end": null,
"join": "gap", "join_duration": 0.7, "fade_in": 0.5}
]
}