[duffarn-dev]

The user's choice for teasers from a match with few kills (2026-11-04): take kills from several matches, "best of the week", so it's always about 30 s.

python main.py teaser runs/<id> runs/<id> ... --music "<song>" [--out <folder>]

• It takes the kills of all the runs. The best climax kill of them all is the hero on the drop, and the other runs' climax kills are ordinary cuts. Otherwise it's the same teaser as finish --teaser (feat: a teaser next to the film (finish --teaser) #65): it speeds up into the drop, the climax goes on the drop, then quicker cuts and an end card.
• Runs without an edit plan or raw clips are skipped, with a note. It uses the raw clips, so it has to run before cleanup.
• The song is found by name in the music folder, subfolders included, with or without the extension. A path works too. The default is the first run's track.
• The output is runs/teaser-<time>/teaser.mp4, or --out.
• build_teaser now takes a list of runs, and finish --teaser passes one.

How it was tested

tests/test_teaser.py, new section "best of the week":

• the hero is the best climax across two runs
• the other run's climax kill is one of the cuts
• the rendered teaser: 9 cuts plus the hero, the drop in the middle (12.26 of 24.6 s), the music's drop on the hero kill
• with two runs, it's longer than with one (24.6 s against 14.4 s)

The one-run tests pass unchanged.

Real matches: the four matches from the mixtape, with "Final Braam": 30.7 s, 23 kills, the drop at 15.4 s. That's filmer/fragsmith-teaser-ukas-beste.mp4.

🤖 Generated with Claude Code