riso-windowseat README

The project's README from github.com/sevenevesai/riso-windowseat. As one markdown file: README.md.

riso-windowseat

Procedural risograph films and prints, each a single index.html of Canvas 2D and Web Audio: no libraries, fonts, images or network calls. The repo began as the release of Window Seat. Making it, and the two shorts before it, produced a reusable kit of Claude Code skills, craft docs and a render harness. Roost, Held and Nonpareil were made with it next.

Window Seat, dawn from the viaduct

Films

All are 1080 × 1080, 30 fps. MP4s are on the v1.0 release. To watch the source instead, open any index.html in a browser and press play.

Film Length
Window Seat 78 s A night train journey through one window, scored for piano
Roost 70 s One take of a starling murmuration from sunset to roost, scored for strings
Held 70 s A kite that flies only while something holds its line, scored for found instruments
Nonpareil 70 s Paper marbling from the first drop to the one print it makes, scored for handpan
Lumen 28 s A seed that contains a sun; the first short, in call-and-response form
Emergence 28 s Lumen's sibling: how machines learned to listen, as nine worlds

Window Seat

A night train journey seen through one fixed window with a glass of water on the sill. Every pixel and every sound except the piano is procedural.

Time Passage
0–19 s Golden departure from a platform, fields, a red truss bridge, a conifer cutting, a tunnel
19–38 s A night city with a canal and a level crossing; another train overtakes, passengers in its windows
38–57 s Fireworks over a lake, sleeper hours with star trails, pre-dawn fog
57–78 s Dawn from a viaduct, rain streaming back along the glass, a lakeside halt under a rainbow

The score, "A Light Left in the Window", is an original piano piece in 6/8 whose phrasing follows the picture's timeline. The glass of water leans with every acceleration and is the last thing to settle.

Contact sheet of Window Seat's shots

Roost

A murmuration over a marsh in one fixed view. Each starling is a 2–3 px ink dot, so the flock is the halftone: where the sheet turns edge-on, the birds pile into dark printed ribbons. A falcon stoops through it and the flock pours into the reeds at nightfall. The string score is timed from the picture.

Held

A paper kite's line frays and parts at a hillside stake. Loose, it can only tumble; it falls across a harbour town, is snagged for a moment by a church weathervane, and over the water its line catches on a sloop's forestay, so the kite climbs again, held by the boat sailing into dusk. Its tail and loose line are simulated ropes. The score uses CC0 mbira, harp, glockenspiel, chimes, strings and flute, with every cue read from the picture's events.

Nonpareil

Paper marbling seen straight down into the bath. Drops of colour land on the beat and push each other outward; a rake and a fine comb drag them into the nonpareil pattern, and a flower is dropped and pulled into the middle. A sheet unrolls across the bath, is peeled back toward the lens like a turning page, and lands face up and mirrored beside the emptied tray. The marbling is closed-form geometry, so every frame is exact. The drops are the handpan's notes, over a slow cello and contrabass line.

How they're made

I directed each film; Claude Code (Anthropic's coding agent) wrote the code, using the skills, rules and docs in this repo. A work is designed in its FILM.md, its hardest frame is proved first, and then it is inspected as frame strips, 1:1 crops and loudness sheets rendered by tools/. Every frame is a pure function of time (seek(t)), so any moment can be inspected exactly and the MP4 cannot drop frames. Each FILM.md records the design decisions and measurements, and lists the film's remaining weaknesses.

Make your own

git clone https://github.com/sevenevesai/riso-windowseat
cd riso-windowseat/tools
npm install && npm run setup && npm test

Then open Claude Code in the repo root and ask, for example:

CLAUDE.md gives the session the contract and commands. The riso-film, riso-still and riso-score skills in .claude/skills/ carry the workflow and gates. Each skill's examples.md points to the routines in the shipped films that are worth reusing. A hook warns when an edit breaks determinism.

What's inside

Path Contents
films/ The six films, each with its FILM.md; Window Seat, Roost, Held and Nonpareil include sample credits and bank rebuild scripts
prints/workings/ A still print series and the print kit new works start from
docs/ The craft: brief, visual development, drawing, scene space, motion, sound, quality bar
studies/ Interactive A/B studies of each technique, and the sound kit
tools/ Scaffolding, verification, contact sheets, audio analysis and MP4 export (README)
.claude/ Skills, the ink-plate rule and the determinism hook

License

MIT, see LICENSE. The piano recordings embedded in Window Seat are Salamander Grand Piano V3 by Alexander Holm under CC BY 3.0; see AUDIO-SOURCES.md. The string recordings embedded in Roost are VSCO 2 Community Edition by Versilian Studios under CC0 1.0; see AUDIO-SOURCES.md. Held's instruments are from Versilian's VCSL and VSCO 2, also CC0 1.0; see AUDIO-SOURCES.md. Nonpareil's handpan is GAMEDRIX974's HandPan pack on Freesound and its cello and contrabass are from VSCO 2, all CC0 1.0; see AUDIO-SOURCES.md.

riso-windowseat (sevenevesai/riso-windowseat)

Searching Database…

297 ·GitHub
Riso-windowseat
Что это такое?Анимационные фильмы в стиле ризографа, созданные процедурно: каждый — один самодостаточный HTML-файл на Canvas 2D и Web Audio, плюс навыки Claude Code, документы о ремесле и инструменты, которыми их делают.
Это видео, которые нужно скачать, или они запускаются в браузере?И то и другое: каждый фильм — это один файл index.html, который открывается в браузере по нажатию play, а отрендеренные MP4 — все в 1080 × 1080 при 30 fps — лежат в релизе v1.0.
Как сделать с его помощью свой собственный фильм?Запустите Claude Code в корне репозитория и просто попросите — например: «Сделай 40-секундный рисо-фильм о ноче смотрителя маяка». Навыки riso-film, riso-still и riso-score в .claude/skills/ содержат весь рабочий процесс и его проверки качества.
Нужен ли Claude Code или что-то ещё, просто чтобы посмотреть фильмы?Нет — достаточно браузера. В файлах нет ни библиотек, ни шрифтов, ни картинок, и они не обращаются к сети, так что работают даже офлайн; Claude Code нужен только для создания новых работ с этим набором.
Могу ли я подправить код фильма, ничего не сломав?Каждый кадр — чистая функция времени, поэтому любой момент остаётся в точности воспроизводимым, а экспортированный MP4 не может потерять кадры — и хук сразу предупредит, как только правка нарушит эту детерминированность.
Какие фильмы сюда входят?Шесть: Window Seat (78 с, ночная поездка в поезде под музыку для фортепиано), Roost (70 с, огромная стая скворцов), Held (70 с, воздушный змей, который летит лишь пока кто-то держит его леер), Nonpareil (70 с, мраморная бумага), плюс две 28-секундные короткометражки, Lumen и Emergence.
Откуда в фильмах печатный вид ризографа?Полутон создаётся процедурно: в Roost каждый скворец — это чернильная точка в 2–3 px, так что полутон — сама стая, сбивающаяся в тёмные печатные ленты там, где лист поворачивается ребром. Мраморные разводы в Nonpareil заданы замкнутыми формулами геометрии, поэтому каждый кадр точен.
Чья музыка и звуки встроены в фильмы?Сэмпловые библиотеки: фортепиано в Window Seat — это Salamander Grand Piano V3 (CC BY 3.0), а Roost, Held и Nonpareil опираются на наборы под CC0, такие как VSCO 2 CE, VCSL и пакет handpan с Freesound — все они указаны в AUDIO-SOURCES.md.
Как проверяется качество фильма?Каждая работа сначала проектируется в FILM.md, её самый сложный кадр доказывается первым, а инструменты из tools/ рендерят полосы кадров, кропы 1:1, контактные листы, анализ звука и экспорт MP4 для осмотра; в каждом FILM.md также перечислены оставшиеся слабые места фильма.
What are similar projects?procedural-film, pdoom-video, awesome-opus5-5-videos, world-execute-me-dsh-pv, huashu-art-motion, PDoomVideo, genart-skill, motion-video-kit
Which topics is it in?procedural, web-audio, ai-art, 2d, motion-graphics, claude-code-skills, generative-art, art, agentic-coding, creative-coding, no-dependencies, canvas
Creator
sevenevesai
Size
42.7 MB
Stars
297
Updated
CommitSep 25Releasev1.0Sep 22
Age
26d
Commits · 90 Days