# DeckTalk

> Narrated presentations, cut to the word.

- [Narrated presentations, cut to the word](https://docs.decktalk.ai/index.md): Make a narrated video from a markdown script and HTML slides, where each reveal starts on its word.
- [Quickstart](https://docs.decktalk.ai/quickstart.md): Install DeckTalk, build the scaffold video without an account, then add your voice.
- [Requirements and costs](https://docs.decktalk.ai/requirements.md): What DeckTalk needs, what setup downloads, and which commands spend ElevenLabs credits.
- [Your first deck](https://docs.decktalk.ai/guides/first-deck.md): Write one section in the four input files, then build it and verify its reveals.
- [Writing for the ear](https://docs.decktalk.ai/guides/writing-for-the-ear.md): Write a narration script that gives every reveal a word to start on.
- [Design a slide](https://docs.decktalk.ai/guides/design-a-slide.md): Size the elements of a slide, choose a reveal effect for each one, and add a camera push.
- [Slide recipes](https://docs.decktalk.ai/guides/slide-recipes.md): Copy six common slides into a project, each with its script lines, section table, cues, and scene.
- [Rebuild one section](https://docs.decktalk.ai/guides/rebuild-one-section.md): Find what an edit runs again, and rebuild only the sections you changed.
- [Add a clip section](https://docs.decktalk.ai/guides/clip-section.md): Play a video clip with its own audio as an opening, between page sections, or as a close.
- [Put a sound effect on a cue](https://docs.decktalk.ai/guides/sfx-on-a-cue.md): Play a one-shot sound effect that starts on a spoken cue.
- [Build in CI and offline](https://docs.decktalk.ai/guides/ci-and-offline.md): Build and check a DeckTalk video on every push, or on a machine with no network.
- [Write a page by hand](https://docs.decktalk.ai/guides/page-by-hand.md): Write a page that follows the page contract without decktalk-runtime.js, for a page built with another framework.
- [How it works](https://docs.decktalk.ai/concepts/how-it-works.md): Understand how DeckTalk turns a script and HTML pages into one mp4, and why each reveal starts on its word.
- [Cues](https://docs.decktalk.ai/concepts/cues.md): Learn how a cue phrase in cues.json becomes a cue time, and what happens when a cue and its page disagree.
- [The page contract](https://docs.decktalk.ai/concepts/page-contract.md): Learn how the recorder plays an HTML page in time with the narration, and which rules a page follows.
- [Sound](https://docs.decktalk.ai/concepts/sound.md): Understand how DeckTalk mixes narration, clip audio, and the optional soundscape into one loudness-normalized track.
- [Reference card for agents](https://docs.decktalk.ai/reference/card.md): Look up the whole DeckTalk contract on one page, with a link to the page behind each rule.
- [CLI](https://docs.decktalk.ai/reference/cli.md): Look up every decktalk command, option, output table, and exit code.
- [Verify](https://docs.decktalk.ai/reference/verify.md): Look up how decktalk verify measures section starts, cuts, cut continuity, and cues, and what each result means.
- [script.md](https://docs.decktalk.ai/reference/script-md.md): Look up the rules for DeckTalk's narration script, from section headings to pauses, placeholders, and length.
- [decktalk.toml](https://docs.decktalk.ai/reference/decktalk-toml.md): Look up every table and key in the DeckTalk project file, with its type and default.
- [cues.json](https://docs.decktalk.ai/reference/cues-json.md): Look up the shape and every key of the cue file, which names the spoken phrase for each cue.
- [Runtime](https://docs.decktalk.ai/reference/runtime.md): Look up every mode, URL parameter, function, data attribute, field, and warning of decktalk-runtime.js.
- [Configuration](https://docs.decktalk.ai/reference/configuration.md): Look up every DeckTalk tuning field, with its type, its default, and what it changes.
- [Build artifacts](https://docs.decktalk.ai/reference/artifacts.md): Look up the path, time base, and fields of every file that DeckTalk writes under build/.
- [Python API](https://docs.decktalk.ai/reference/python-api.md): Call the DeckTalk pipeline from Python, with each public name, its parameters, its result, and its errors.
- [Glossary](https://docs.decktalk.ai/reference/glossary.md): The one meaning of each DeckTalk term, the words to avoid, and the page that explains it.
- [Troubleshooting](https://docs.decktalk.ai/help/troubleshooting.md): Find a DeckTalk message, verdict, or warning by the text it prints, with its cause and fix.
- [FAQ](https://docs.decktalk.ai/help/faq.md): Answers about cost, lock-in, the voice, other tools, output files, and the scaffold's lesson.
- [Changelog](https://docs.decktalk.ai/changelog.md): See what changed in each DeckTalk release, including the file formats and the page contract.