HAL
08 / 11

What to build

The tools behind the films, specified so that you or an agent can build them: what each takes and returns, the check that says it is done, and how far ours has got.

The tools are written while LATENCY is made. Each row has its spec, and the scripts in the kit that do it now. Download them all as kit/hal-kit.zip.

ToolTakesReturnsDone whenIn the kitStatus
lyrica lyric draftsyllables per line, hook and verse lengthsevery hook is 6–7 syllables and every verse line 10–13lyric.pydone
songmapthe picked take and its stemsthe beat and bar map, the line table read off the lead stem's leveleach line's start lands within 30 ms of its onset in the stemanalyze.mjs, bars.py, lines.pydone
shotbookthe board and the line tablewindows, prompts and jobs for every shotshotbook lint passes the auditlines.py, windows.py, shotbook.py lintdone
runthe jobs and a spend capone take per job, re-rolls only for failuresthe total stays under the captakes.mjsin use
syncthe takes and the windowsan alignment path per take (DTW)lips stay on the words after every pausecheck.py, lips.pymeasures the path and the lag; does not warp yet
cutthe paths and the songthe film at −14 LUFS, a 9:16 cut, the flash checkno word clipped, no seam heardcut.pythe cut on the bars; LUFS, 9:16 and the flash check to come
cut sheetsthe cutone sheet of eight frames per shottwo reviewers can read the film shot by shotcheck.py (one sheet per take)to come

lyric

python kit/lyric.py <film> checks the lyric in the film's data, and python kit/lyric.py --file draft.txt checks any draft with [Section] tags. It prints every line with its syllables and writes <film>/song/lyric.json. A chorus line has to be 6–7 syllables and a verse line 10–13. A verse line of 5–8 reads as a chopped fragment and is flagged. A pre-chorus outside 8–14 is a warning. Spoken sections are not checked. Numbers are counted as spoken: "300" is "three hundred". Syllables are counted by rule, with a short dictionary for the words the rule gets wrong. It is right on almost every word and off by one on a few, so read the flagged lines aloud before changing them.

LATENCY's lyric, approved at checkpoint 2, has three lines outside the rule. Verse 2 ends on 14 syllables ("I laugh back at a joke you don't remember anymore"). The first two lines of the final chorus are 8 each ("Wait for me, I'm already here"). They stay as they are: a line the director approved is not touched.

shotbook lint

python kit/shotbook.py lint <film> runs the board audit from the recipe on book.json and writes <film>/book.lint.json. It checks these rules:

  • no gaps or overlaps along the song;
  • every cut within 0.03 s of a beat;
  • every sung word inside a shot that lists its line;
  • his share of the screen at least 70%;
  • never more than two bars without him (a warning);
  • sung windows of 4–15 whole seconds, with a 0.7 s lead-in;
  • no two shots from one first frame;
  • no banned words in any prompt;
  • every shot names its size;
  • no TODO.

LATENCY passes. The one warning is the two shots without him: the board insert that opens the film (4 bars) and the train in the server field (5 bars). Both are in the board as approved at checkpoint 4.