← all repositories
sarpstar/cinecode

An AI agent that renders films as code, frame by frame

cinecode hands your one-line idea to a coding agent that writes the script, builds every frame in headless Chrome, designs the sound, and hands you an MP4.

Collecting fresh signals — velocity needs a few days of history.
collecting data…
star history

What it does

You give cinecode a sentence — “a lino-print mail train in the snow” — and an AI coding agent (best in Claude Code, also Cursor; users have run it in Codex and Antigravity) turns it into a finished video. Frames are generated as code in headless Chrome via Canvas 2D or three.js/WebGL, audio is designed with Web Audio, and ffmpeg assembles the final MP4 at −14 LUFS. It runs locally on your machine; no paid service required, and external voice/music are optional.

The interesting bit

The whole pipeline is code, not diffusion: scenes are functions of time in a self-contained film.html, which means drafts are inspectable, revisable, and deterministic in a way generated pixels aren’t. It also has taste-guardrails — idea suggestions are collided with real-world artifacts (museum pieces, historical places) to avoid the obvious first idea, and every proposal is checked against your previous films so it never pitches the same thing twice.

Key highlights

  • Two modes: Quick (single-file film, ~3 min max, 1–2 revision rounds) and Film (roadmap → script → style frames → animatic → render, with staged approvals for 10+ minute documentaries)
  • Formats span 15-second vertical explainers to 5+ minute documentaries, ads with 9:16/1:1/16:9 safe-area variants, and music videos cut to a measured beat grid
  • Drafts get automated QC (motion from first frame, loudness, readability, repetition) plus an independent “cold viewer” agent pass
  • Can measure the format of a video you like (cuts, tempo, light, color) and remake a film in that style — without reusing its frames
  • Multilingual README (Turkish, English, Chinese, Japanese) with free Turkish voice options

Caveats

  • Longer films cost more time and agent usage — the README is upfront that Film mode involves roughly 6–8 approval rounds
  • The primary README is Turkish; the English version is a separate file
  • Output quality depends heavily on the coding agent you run it in — Claude Code is the stated best case

Verdict

Worth a look if you want programmatic video with an agent doing the directing, or vertical explainers without a motion-graphics subscription. If you need photoreal footage or a traditional editor timeline, this isn’t that — and it’s only as good as the agent driving it.

Frequently asked

What is sarpstar/cinecode?
cinecode hands your one-line idea to a coding agent that writes the script, builds every frame in headless Chrome, designs the sound, and hands you an MP4.
Is cinecode open source?
Yes — sarpstar/cinecode is open source, released under the MIT license.
What language is cinecode written in?
sarpstar/cinecode is primarily written in Python.
How popular is cinecode?
sarpstar/cinecode has 2.3k stars on GitHub.
Where can I find cinecode?
sarpstar/cinecode is on GitHub at https://github.com/sarpstar/cinecode.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.