Skip to content
Back to search

riso-windowseat

Procedural risograph films in single HTML files (Window Seat, Roost and more), with the Claude Code skills, docs and tools to make your own.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/sevenevesai--riso-windowseat/badge.svg)](/listings/sevenevesai--riso-windowseat)

HTML

<a href="/listings/sevenevesai--riso-windowseat"><img src="/api/listings/sevenevesai--riso-windowseat/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 208 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # riso-windowseat
  2. Procedural risograph films and prints, each a single `index.html` of Canvas 2D and Web Audio:
  3. no libraries, fonts, images or network calls. The sampled scores carry their recordings inside
  4. the file. The repo began as the release of **Window Seat**. Making it, and the two shorts before
  5. it, produced a reusable kit of Claude Code skills, craft docs and a render harness. Every film
  6. and print since was made with that kit.
  7. **[Watch the films](https://seveneves.ai/riso/)** ·
  8. [Download the MP4s](https://github.com/sevenevesai/riso-windowseat/releases/tag/v1.0) ·
  9. [Make your own](#make-your-own)
  10. ![Window Seat, dawn from the viaduct](films/window-seat/poster.png)
  11. ## Films
  12. All are 1080 × 1080, 30 fps, and each is an MP4 on the
  13. [v1.0 release](https://github.com/sevenevesai/riso-windowseat/releases/tag/v1.0). Every film
  14. except Standby also plays at [seveneves.ai/riso](https://seveneves.ai/riso/). To watch the
  15. source instead, open any `index.html` in a browser and press Play; sound starts off and has its
  16. own toggle.
  17. | Film | Length | |
  18. |---|---|---|
  19. | [Window Seat](films/window-seat/) | 78 s | A night train journey through one window, scored for piano |
  20. | [Roost](films/roost/) | 70 s | One take of a starling murmuration from sunset to roost, scored for strings |
  21. | [Held](films/held/) | 70 s | A kite that flies only while something holds its line, scored for found instruments |
  22. | [Nonpareil](films/nonpareil/) | 70 s | Paper marbling from the first drop to the one print it makes, scored for handpan |
  23. | [Eclosion](films/eclosion/) | 36 s | A monarch leaves its chrysalis, pumps its wings full and flies, in one take, scored for vibraphone, clarinet and horn |
  24. | [Passenger](films/passenger/) | 36 s | A butterfly draws itself in the fog on a train window and comes alive at sunrise, scored procedurally |
  25. | [Standby](films/standby/) | 52 s | A DVD player's idle logo bounces round a bedroom TV around 2001 until it hits the corner, scored as slow 90s lo-fi |
  26. | [Lumen](films/lumen/) | 28 s | A seed that contains a sun; the first short, in the call-and-response [Resonance form](docs/forms/resonance.md) |
  27. | [Emergence](films/emergence/) | 28 s | Lumen's sibling in the same form: how machines learned to listen, as nine worlds |
  28. ### Window Seat
  29. A night train journey seen through one fixed window with a glass of water on the sill. Every
  30. pixel and every sound except the piano is procedural.
  31. | Time | Passage |
  32. |---|---|
  33. | 0–19 s | Golden departure from a platform, fields, a red truss bridge, a conifer cutting, a tunnel |
  34. | 19–38 s | A night city with a canal and a level crossing; another train overtakes, passengers in its windows |
  35. | 38–57 s | Fireworks over a far town, reflected in a lake; sleeper hours with star trails; pre-dawn fog |
  36. | 57–78 s | Dawn from a viaduct, rain streaming back along the glass, a lakeside halt under a rainbow |
  37. The score, "A Light Left in the Window", is an original piano piece in 6/8 whose phrasing follows
  38. the picture's timeline. The glass of water leans with every acceleration and is the last thing to
  39. settle.
  40. ![Contact sheet of Window Seat's shots](films/window-seat/sheet.jpg)
  41. ### Roost
  42. <a href="films/roost/preview.webp" title="Open the larger preview"><img src="films/roost/preview-thumb.webp" width="180" align="right" alt="Roost: the flock over the sun, the falcon strike, starlings pouring past, the roost"></a>
  43. A murmuration over a marsh in one fixed view. Each starling is a 2–3 px ink dot, so the flock
  44. is the halftone: where the sheet turns edge-on, the birds pile into dark printed ribbons. A
  45. falcon stoops through it and the flock pours into the reeds at nightfall. The string score is
  46. timed from the picture.
  47. <br clear="right">
  48. ### Held
  49. <a href="films/held/preview.webp" title="Open the larger preview"><img src="films/held/preview-thumb.webp" width="180" align="right" alt="Held: the kite on the hill, the line parting, the church vane, the sloop's catch"></a>
  50. A paper kite's line frays and parts at a hillside stake. Loose, it can only tumble; it falls
  51. across a harbour town, is snagged for a moment by a church weathervane, and over the water its
  52. line catches on a sloop's forestay, so the kite climbs again, held by the boat sailing into
  53. dusk. Its tail and loose line are simulated ropes. The score uses CC0 mbira, harp, glockenspiel,
  54. chimes, strings and flute, with every cue read from the picture's events.
  55. <br clear="right">
  56. ### Nonpareil
  57. <a href="films/nonpareil/preview.webp" title="Open the larger preview"><img src="films/nonpareil/preview-thumb.webp" width="180" align="right" alt="Nonpareil: drops landing, the comb crossing, a bullseye pulled into a flower, the sheet peeling back"></a>
  58. Paper marbling seen straight down into the bath. Drops of colour land on the beat and push each
  59. other outward; a rake and a fine comb drag them into the nonpareil pattern, and a flower is
  60. dropped and pulled into the middle. A sheet unrolls across the bath, is peeled back toward the
  61. lens like a turning page, and lands face up and mirrored beside the emptied tray. The marbling
  62. is closed-form geometry, so every frame is exact. The drops are the handpan's notes, over a
  63. slow cello and contrabass line.
  64. <br clear="right">
  65. ### Eclosion
  66. <a href="films/eclosion/preview.webp" title="Open the larger preview"><img src="films/eclosion/preview-thumb.webp" width="180" align="right" alt="Eclosion: the case splitting, the butterfly swinging out, the full display, the flight"></a>
  67. One monarch's first morning, in one continuous macro take. A jade chrysalis clears and splits;
  68. the butterfly drops out, hangs from the empty shell and pumps its crumpled wings full in six
  69. slow pulses while its swollen abdomen shrinks. It turns, opens its wings twice and flies, and
  70. the camera returns to the empty case, framed as the chrysalis was in the first second. The
  71. wings are a planar 3D model whose pattern was measured from a specimen photograph, layered by
  72. depth so the body reads right from the side, from behind and in flight. A slow trio in F for
  73. vibraphone, clarinet and horn shares the picture's clock.
  74. <br clear="right">
  75. ### Passenger
  76. <a href="films/passenger/preview.webp" title="Open the larger preview"><img src="films/passenger/preview-thumb.webp" width="180" align="right" alt="Passenger: the drawing in the fog, sunrise and ink, lift-off, the wings opening on the glass"></a>
  77. A child of this repo and [alexgreensh/anidoodle](https://github.com/alexgreensh/anidoodle):
  78. Window Seat's window and glass of water, and anidoodle's drawing that makes itself and then comes
  79. alive. Before dawn a butterfly draws itself in the fog on a train window, stroke by stroke in the
  80. order a finger would. Its clear lines are windows, so lamps slide through the drawing and the dawn
  81. fills its wings. The sunrise warms it off the glass and the camera pulls back from the pane to the
  82. seat. It lands on the rim of the glass of water and drinks, and the butterfly-shaped hole it left
  83. stays in the fog. The score is procedural, from the shared kit: every mark of the drawing is a
  84. note, and the opening motif is answered as the wings open.
  85. <br clear="right">
  86. ### Standby
  87. <a href="films/standby/preview.webp" title="Open the larger preview"><img src="films/standby/preview-thumb.webp" width="180" align="right" alt="Standby: a near miss at the screen's corner, the hit in pink, the raster collapsing to a dot, headlights sweeping the stars"></a>
  88. A kid's bedroom around 2001, long after bedtime. The DVD player has idled so long that its logo
  89. bounces round the dark CRT, taking a new ink at every edge and lighting the room in it. From the
  90. bed we wait for the logo to land exactly in a corner; it nearly does three times, each miss
  91. closer, and the camera leans in after each. When it lands, the screen flares pink, and the sleep
  92. timer switches the set off: the picture collapses to a line, then a dot. In the dark the glow
  93. stars come up, the DVD/VCR blinks 12:00, and a passing car sweeps the blind stripes across the
  94. wall. The room is a per-pixel raycast feeding the plates. In the score the logo's two wall
  95. rhythms are its two voices, drifting into phase at the corner.
  96. <br clear="right">
  97. ## Prints
  98. Still series driven like a film (each integer time is one print) and exported as native
  99. 2160 × 2160 PNGs with `tools/still.mjs`.
  100. **[Cabinet](prints/cabinet/)**: five plates from an imaginary natural-history cabinet (a sectioned
  101. nautilus, arranged diatoms, a luna moth, a cut agate, a sunflower), each built from its own growth
  102. geometry and cut as fine line over screened colour.
  103. ![Cabinet, plates I–V](prints/cabinet/sheet.jpg)
  104. **[Sceneries](prints/sceneries/)**: a curved viaduct in fog, a cliff village at dusk over its own
  105. reflection, and a stepped canyon at sunrise.
  106. ![Sceneries: viaduct, harbour, canyon](prints/sceneries/sheet.jpg)
  107. ## How they're made
  108. I directed each work; Claude Code (Anthropic's coding agent) wrote the code, using the skills,
  109. rules and docs in this repo. A work is designed in its `FILM.md` or `PRINT.md`, its hardest frame
  110. is proved first, and then it is inspected as frame strips, 1:1 crops and loudness sheets rendered
  111. by `tools/`. Every frame is a pure function of time (`seek(t)`), so any moment can be inspected
  112. exactly and the MP4 cannot drop frames. Each record keeps the design decisions and measurements;
  113. from Window Seat on, each also lists the work's remaining weaknesses.
  114. ## Make your own
  115. You need Node.js 18 or later and [Claude Code](https://code.claude.com/docs/en/overview).
  116. ```
  117. git clone https://github.com/sevenevesai/riso-windowseat
  118. cd riso-windowseat/tools
  119. npm install && npm run setup && npm test
  120. ```
  121. `npm install` brings playwright-core and a bundled ffmpeg. `npm run setup` downloads the Chromium
  122. and Firefox builds the harness drives; the released MP4s are Firefox renders
  123. (`render.mjs --engine firefox`). `npm test` runs the harness's self-tests and exits 0 when they
  124. pass.
  125. Then open Claude Code in the repo root and ask, for example:
  126. - "Make a 40 second riso film of a lighthouse keeper's night."
  127. - "Make a riso poster of a heron on a pier at dusk."
  128. - "Score this film" or "The rain at 66 s is too loud."
  129. - "Extend Window Seat with a snowy mountain pass after the lake."
  130. `CLAUDE.md` gives the session the contract and commands. The `riso-film`, `riso-still` and
  131. `riso-score` skills in `.claude/skills/` carry the workflow and gates. Each skill's `examples.md`
  132. points to the routines in the shipped films that are worth reusing. After each edit to a film, a
  133. hook flags any `Math.random()` call and a missing `window.__riso`.
  134. ## What's inside
  135. | Path | Contents |
  136. |---|---|
  137. | `films/` | One folder per film: `index.html` and its `FILM.md`; sampled films add `AUDIO-SOURCES.md` and the script that rebuilds their sample bank |
  138. | `prints/` | Cabinet and Sceneries with their `PRINT.md`, and Workings, which donates the print kit new works start from |
  139. | `docs/` | The craft: [brief](docs/brief.md) (which doc to read when), visual development, drawing, characters, scene space, motion, live plates, sound, quality bar, and the optional Resonance form |
  140. | `studies/` | The drawing, composition, scene-space and sound kits as interactive A/B study pages |
  141. | `tools/` | Scaffolding, verification, contact sheets, still and MP4 export, audio analysis ([README](tools/README.md)) |
  142. | `.claude/` | Skills, the ink-plate rule and the determinism hook |
  143. ## License
  144. The code, films and prints are MIT, see [LICENSE](LICENSE), except the third-party material
  145. below. [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) sets out the two parts with terms beyond
  146. MIT: Window Seat's piano recordings (CC BY 3.0; keep the credit when you redistribute the film
  147. or its exports), and Eclosion's wing geometry, measured from "Danaus plexippus MHNT dos.jpg" by
  148. Didier Descouens (Wikimedia Commons, CC BY-SA 4.0) and offered under that license.
  149. Each sampled film's `AUDIO-SOURCES.md` credits its recordings and pins their source commits. CC0
  150. asks for no credit, so for those recordings the credit is provenance.
  151. | Film | Recordings | License |
  152. |---|---|---|
  153. | [Window Seat](films/window-seat/AUDIO-SOURCES.md) | Salamander Grand Piano V3, Alexander Holm | CC BY 3.0 |
  154. | [Roost](films/roost/AUDIO-SOURCES.md) | Strings from VSCO 2 Community Edition, Versilian Studios | CC0 1.0 |
  155. | [Held](films/held/AUDIO-SOURCES.md) | Instruments from Versilian Studios' VCSL and VSCO 2 | CC0 1.0 |
  156. | [Nonpareil](films/nonpareil/AUDIO-SOURCES.md) | Handpan from GAMEDRIX974's HandPan pack on Freesound; cello and contrabass from VSCO 2 | CC0 1.0 |
  157. | [Eclosion](films/eclosion/AUDIO-SOURCES.md) | Vibraphone from VCSL; clarinet and horn from VSCO 2 | CC0 1.0 |
  158. | [Standby](films/standby/AUDIO-SOURCES.md) | Electric piano (Yamaha TX81Z), upright piano, kalimba, bass drum, hi-hat and shaker from VCSL | CC0 1.0 |

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.