1,000 stars. Thank you to everyone who starred Papermorph, tried the Skill, filed issues and sent pull requests. The first roadmap is done; the next is below.
Everything is a static web page: no server, no database, no account. A book is a folder you can host anywhere.
On the shelf
Lessons, from a textbook PDF
Formulas, diagrams and scenes change step by step as the narration explains, with quick checks and chapter practice that grade the maths, not the string.
Elementary Algebra (68 chapters) · Linear Algebra (40, planes you can drag in 3D) · Elementary Mathematics (23) · Elementary Physics (9)
Picture books, from a story, a joke or a fairy tale
Paper puppets in front of sets drawn in code or painted by an image model, with acted voices, subtitles, sound effects, music and camera work. For children who can't read yet, the film stops for a game: a character asks for one thing at a time, the child touches it in the picture, and nothing is ever called wrong. A scanned picture book can bring its own art: the figures, sets and hand lettering are cut from the pages and moved as puppets.
The Little Horse Crosses the River (小马过河) · Little Red Riding Hood · Millions of Cats (Wanda Gág, 1928, cut from the book's own pages) · Joke Collection (7 episodes)
Documentaries and upright shorts, from a book or an idea
Public-domain engravings, paintings, maps and charts, moved in step with the voice, with music. A documentary can be recut as a series of upright shorts for a phone feed.
Madness and Civilization (10 minutes, and 4 shorts) · The Pandemic (7 minutes, 6 shorts and a scroll story)
Pages you play
A film can stop and hand the reader the next move, a map can be walked a year at a time, and a story can unfold as the reader scrolls. The Skill makes all three: explorable maps and scroll stories have their own starting kits.
Shooting an Elephant (Orwell's essay; you hold the rifle) · Explorable maps: Time of the Magicians (Europe 1919–1929, four philosophers on the map) and The Map Redrawn (Japan 1868–1878) · The Pandemic as a scroll story
Get started
Install the Skill in your project, for Claude Code or OpenCode:
npx skills add DozenTwelve/Papermorph --skill papermorph --agent claude-code # or --agent opencode
Then type /papermorph. It finds the PDF in your project (or asks for your story), tells you what kind of book it is, suggests a chapter to try first and how much animation it needs, and offers a recommended option at every step. Your choices are saved in style.json, so every later chapter is made to the same style.
In OpenCode, a clone of this repository already has the command (.opencode/commands/papermorph.md) and the Skill; with a global install, copy that file to ~/.config/opencode/commands/.
You need uv, ffmpeg, and Playwright's browsers (uv run --with playwright playwright install chromium firefox). Narration uses Edge TTS (online) or Kokoro (local), free. A few steps are paid, optional and need an API key: acted ElevenLabs voices for picture books and documentaries, clips made from a still (OpenRouter), and painted sets for picture books (OpenRouter or OpenAI). The newest picture books cost under $0.45 each in voices.
How it works
A book is planned before it is drawn: chapters or scenes, then a script, then a storyboard. The narration is voiced and every word gets a time, and the picture is animated to those times. The model then watches its own output (contact sheets, overlap and blank-frame checks, end-to-end tests, a director's review against approved books) and fixes what it sees. Large chapters are made by a team of subagents, each step on the model you choose (core/team.md). The books on the shelf were made with Opus 5.5, GPT-6.1-Sol and Sonnet 5.5; an illustrated physics chapter costs about $10–18 of model usage.
Every book plays in the same player: pause anywhere, step back and forth, speed, captions, keyboard shortcuts, and progress saved per book, with the interface in English, Russian, Chinese, Japanese or Arabic (right to left). The player lives in engine/ and every book keeps its own copy, so a book never breaks when the engine changes; scripts/engine.py site updates them from the latest release (--from you/your-fork@main from your own).
Any chapter or episode also renders to a 1080p MP4 with an .srt, frame by frame from the lesson clock (scripts/export.py), and a book can be packaged for an LMS as SCORM (scripts/scorm.py, courses.md).
This is the beginning of the README. Read the rest at the original. Read the full README ↗
