Leonxlnx / cinetic
git clone https://github.com/Leonxlnx/cinetic.git
v1.1.0 · 5d ago
Cinematic launch films and motion design from code, directed by your coding agent.
+13
stars, 24h · #1,091
+~91
stars, 7 days · #1,391
+758
stars, 30 days · #713
798
★ total · +14% this week
49
forks · 4 open issues
Star history (as recorded here)
LanguagePython
LicenseMIT
Created2026-09-28 (24d ago)
Last push5d ago
Watchers0
OwnerUser
GitHub topics
Links
README excerpt
Cinematic launch films and motion design from code, directed by your coding agent.
Kiln: a 25-second launch teaser that an agent branded, directed, scored and rendered from a two-sentence brief. The GIF is an excerpt; click it to download the full 1920x1080, 60 fps MP4 with sound (7 MB).
cinetic (cinema + kinetic) is an agent skill that makes your coding agent direct a short film instead of arranging animation components.
- **Idea first.** Before any code, the agent writes three concepts through different lenses, tests them, and picks one story device the film owns.
- **273 techniques, drawn at random.** A library of measured moves in 14 categories, each with a build recipe and timing at 60 fps. `pick.py` draws the film's plan, weighted for its format and energy, so two films don't share the same fade-up, push-in and end card.
- **Its own brand.** The look comes from three personality words, so a calm notes app and a fast CI tool don't end up looking alike.
- **Calm, with words in fragments.** Copy arrives a few words at a time, split around what the product does ("here is the newest" → the product → its name), with readable holds that drift instead of freezing and stretches of pure picture between. The fragment grammar comes from a frame-by-frame study of eight professional films; a crisp profile is there when a brief asks for energy.
- **One beat grid, measured sound.** `timeline.ts` drives the picture, the soundtrack and the QA scripts, so every hit lands on its frame. The effects come from an earshot sound kit: sounds designed in code and rendered with measured sync points, one soft sound per text fragment, one clean element on the lockup. Typing, clicks and ticks follow measured norms of top-tier launch films: soft, short and mostly left to the picture.
- **Finished and measured.** True motion blur, no banding, BT.709 and a sync-checked mux, then pixel forensics, an audio-sync audit, contact sheets and critic passes against a ship gate.
- **No generated look.** Hard bans, enforced by a linter and the critics, keep out the looks that mark a video as generated. A brand you supply always wins.
It builds with Remotion (React) by default, or HyperFrames (HTML and GSAP).
Quick start · Gallery · Technique library · Install · Requirements · Use · How it works · Hard bans · What's inside · Evaluation
## Quick start
[code]
Then ask your agent for a film, for example: "Make a 20-second launch teaser with sound for our database branching tool. Invent the brand." It works with Claude Code, Codex, Cursor and the other agents the skills CLI supports.
Before the first film, check your machine with a first test render. It needs Node 22+, ffmpeg 6+, Python 3.11+ and a headless Chromium; see Requirements.
## Gallery
**Quire Streaks.** A 12 s vertical video for Reels and TikTok, in the brand the brief supplied. A blue thread stitches each day's pages into the Streaks screen, one rising note per stitch. On Sunday at 11:41 pm the thread hangs loose until one