Skip to main content
A playhead moves along the narration “A bowl. A ball. One. Two, three.” with a tick under each word. A bowl and a ball appear on the slide on their words. On each count word, the ball steps down the bowl and a box fills with that word's start time: 4.49 s, 5.26 s, and 5.77 s. A playhead moves along the narration “A bowl. A ball. One. Two, three.” with a tick under each word. A bowl and a ball appear on the slide on their words. On each count word, the ball steps down the bowl and a box fills with that word's start time: 4.49 s, 5.26 s, and 5.77 s. DeckTalk turns a Markdown script, HTML slides and your voice into one narrated mp4. You write the words in script.md and the pictures in an HTML page. cues.json names the spoken phrase each picture lands on, and the finished film is measured against that promise before you are told it is built.

Start here

Two pages take you from an empty machine to a section of your own.
  • Quickstart installs DeckTalk and builds the starter film with no account and no spend.
  • Your first deck writes one section across the four files, then checks, builds and verifies it.
Requirements and costs covers what a machine needs, what it downloads, and which commands spend money, and Examples lists the finished projects decktalk init writes.

Understand the model

  • How it works walks the six stages, from the spoken takes to the measured film.
  • Cues explains how a phrase from the script becomes a second on a section clock.
  • The page contract is how a slide tells the recorder what it is doing, and Design a slide turns that into a slide worth watching.
  • Writing for the ear gives every picture a word worth landing on.
  • Sound covers the music, the ambience bed and the effects.

What a section can be

Look something up

Building with an agent? The command line is the instruction set and it documents itself: decktalk --help, decktalk schema, decktalk schema setting and decktalk status --json answer most of it. Skills covers the craft those four calls cannot say, and the reference card puts every file, command and rule on one page.