# stingo

> Declarative video for people who ship content. A video is a text file: a
> script says what you are talking about, a taste profile says how it looks and
> moves, and stingo renders an MP4 with every cut landing on a downbeat. It
> also composites recorded takes, so an explainer can contain the explainer.

"Stingo" is Sheng — the Swahili-English creole spoken in Nairobi — for
*aesthetics*, which is the central idea: the look of a film is a named thing
that lives in its own file and can be swapped without touching the script.

stingo is a Bun and TypeScript library and CLI. It renders with satori and
resvg (no browser, no headless Chrome) and encodes with ffmpeg. A frame is a
pure function of its index, which is what makes scrubbing instant, rendering
parallel, and output deterministic.

The project is written and maintained entirely by Claude, Anthropic's coding
model, working from direction by Hersi (github.com/aynaash).

Every page below is also served as HTML at the same path without the .md.

## Start here

- [Connect your AI](https://aynaash.github.io/stingo/mcp.md): Give an agent the tools to write a script, render a frame, and look at what it made.
- [Getting started](https://aynaash.github.io/stingo/start.md): Install it, render the example, and change one line to see what happens.
- [Showcase](https://aynaash.github.io/stingo/showcase.md): Every frame stingo makes, generated rather than curated.

## Reference

- [The script](https://aynaash.github.io/stingo/script.md): Every field of a video document, and how a scene gets its length.
- [Blocks](https://aynaash.github.io/stingo/blocks.md): The fourteen scene types, what each one takes, and what it looks like.
- [Taste profiles](https://aynaash.github.io/stingo/taste.md): Palette, type, motion, pacing and texture — and what stingo decides for you.
- [Talking head](https://aynaash.github.io/stingo/camera.md): Putting yourself in the frame: three layouts, take audio, and writing before you shoot.
- [Commands](https://aynaash.github.io/stingo/cli.md): Every command and flag, and what each one is for.

## Under the hood

- [Written by Claude](https://aynaash.github.io/stingo/claude.md): Every line of it, and what a model got wrong along the way.
- [How it works](https://aynaash.github.io/stingo/internals.md): Pure frames, satori and resvg, the beat grid, and where the milliseconds went.
- [Roadmap](https://aynaash.github.io/stingo/roadmap.md): Where this is going: the complete technical content library for engineers.

## Also

- [Source](https://github.com/aynaash/stingo): the repository, AGPL-3.0
- [Everything, inlined](https://aynaash.github.io/stingo/llms-full.txt): all documentation in one file
- [The launch video script](https://github.com/aynaash/stingo/tree/main/examples/building-stingo): a worked example written before its footage existed