Sign in

Motions / @iamsuosi/lab-notebook

A frame of a film in Lab Notebook

Plays live in your browser, drawn by web code rather than a video, so it can use your computer's processor and graphics while it runs. The sound is on.

Lab Notebook

A page of a squared notebook where the diagram is drawn stroke by stroke as it is explained, labelled by hand, the result boxed in red.

Also 实验手记

Make a film in this look

Read https://motionhub.dev/llms.txt, then make a film about "<your topic>" in the motion https://motionhub.dev/m/@iamsuosi/lab-notebook/

Put in your topic and paste it into any agent that can open a URL.

Or install the skill for every agent, then use /motionhub
npx skills add motionhub-dev/motions -g
Works in
RemotionHyperFramesand any engine, from MOTION.md
Version
1.0.5
Format
motion/0.3
Licence
CC-BY-4.0 for the look · MIT for the code
Looks
hand-drawnline-artlight
Package
123 KB, sha256:808a50418982

Use it

  1. Copy the prompt, put in your topic and paste it into your agent
    Read https://motionhub.dev/llms.txt, then make a film about "<your topic>" in the motion https://motionhub.dev/m/@iamsuosi/lab-notebook/

    Any agent that can open a URL: it reads llms.txt, fetches the motion, checks it against its SHA-256 and makes your film in whatever engine it uses.

  2. Or install the motionhub skill once, for every agent on your computer
    npx skills add motionhub-dev/motions -g

    Claude Code, Codex and the other agents skills knows; without -g, for this project only.

  3. Then call it by name
    /motionhub make a film about <your topic> in @iamsuosi/lab-notebook
  4. Made a look of your own? Share it the same way
    /motionhub share this project's look as a motion

    Your agent writes the motion under your GitHub name, runs the checks and opens the pull request when you say yes.

MOTION.md

Raw · GitHub

A page of a squared notebook where an explanation is worked out by hand: the diagram is drawn stroke by stroke as the narration describes it, labelled as each part is named, and the result is boxed in red. It feels like watching someone who understands the thing think it through on paper.

Essence, and what it is not

  • One notebook page, squared, with a red margin rule and punched holes. Everything is drawn or written on it.
  • Every line is drawn on the word that describes it, in the order a person would draw it: the vessel before the liquid, the atom before its bonds.
  • Three pens with fixed meanings: ink draws and writes, red marks the one result, pencil is working and asides.
  • Paper things are stuck on, never typeset: an index tab for what to come back to, a figure label under a framed drawing.

Not a whiteboard (no marker, no erasing: a notebook keeps its working), not a blueprint (no ruler-perfect lines, no title block), not a textbook diagram (nothing appears finished; the drawing is the explanation happening).

Ground and material

sheet.tsx draws the ground: warm paper (panel) ruled in pale blue squares of 40 px (faint), a double red margin rule (border) at x 220, punched holes on the left, the heading written by hand at the top, the sheet lying on a grey desk (bg) and ending above the caption band. SHEET gives the writing area (x 260 to 1800). Ink has a feathered edge (a lighter hair beside each stroke); pencil is plain and thinner. A drawn shape may get a pale wash of colour once its outline closes.

Colour roles

  • text: the ink. Every drawn line and handwritten word unless it is the result or working.
  • grad: the red pen. The one result of a scene (a boxed value, an exclamation), never more than one red thing at a time.
  • muted: pencil. Construction lines, angles, figure labels, the date.
  • faint, border: the paper's grid and margin. Never drawn with.
  • warn, good, data, op: tab papers and the pale wash inside a drawn shape (data), nothing else.

Type and captions

Shantell Sans (display) is the hand: labels 40 to 60 px, the heading 46 px, working 40 to 52 px at weight 500 to 600. Atkinson Hyperlegible Next (sans) only where the page needs print: the caption and dense small text. Chinese: LXGW WenKai writes, Noto Sans SC prints. The caption is a paper slip with a short red stroke above its text, in the print face, 34 px.

Motion

Drawing is the motion. A line or outline draws over 0.6 to 1.5 s with an ease in and out (the hand slows at corners); writing is linear, about 0.15 s a word, left to right; a label's underline follows its words. Tabs are stuck on in one beat (no slide). Nothing that is drawn moves afterwards, and the page does not move: a new idea is drawn further along the page, or on a new scene's page.

Composition and framing

The page fills the frame and stays. A scene's main drawing takes the left two thirds of the writing area at a size that fills it; labels sit beside what they name, close enough to need no leader, or with a short arrow; working and results sit to the right. A new scene may start a clean page. Leave room for the result: the boxed value is the last thing written and needs space beside or under the drawing.

Sound

Optional: a soft nib scratch while a long line draws, very low. No music is part of the motion.

Components

  • ground — Notebook sheet (react/parts/sheet.tsx): A page of squared paper with a red margin rule and punched holes, the topic written at the top by hand. Fits: every scene; a new question is a new heading on the same page, or the page turned
  • link — Curved arrow (react/parts/arrow.tsx): A hand-drawn arrow that bends from one place on the page to another, its head added when the line arrives. Fits: this leads to that; a cause and its effect; from a drawing to the formula it explains
  • steps — Working (react/parts/formula.tsx): Lines of working written one after another by hand, the last one boxed in red as the result. Fits: a short derivation; a definition then a value; a comparison reduced to one inequality
  • steps — Ink line (react/parts/ink.tsx): Any line, shape or diagram as SVG path data, drawn with the pen as the narration describes it. Fits: a vessel, a molecule, a circuit, a graph's curve: whatever the explanation draws
  • term — Hand label (react/parts/label.tsx): A word or a short phrase written by hand on the word that names it, underlined when it matters. Fits: naming a part of the drawing; a term the narration introduces; a quantity next to what it measures
  • title — Figure frame (react/parts/frame.tsx): A pencil box drawn round a drawing, with its figure label written underneath. Fits: setting one drawing apart as the thing to look at; naming a view (from above, in section, magnified)
  • transition — Index tab (react/parts/tab.tsx): A coloured paper tab stuck to the page with a strip of tape, marking a place to come back to. Fits: the question a section answers; a result to remember; a page that changes topic

Native moves

  • Draw it as you say it. An outline draws itself on the noun; its parts on theirs. Fits content like: a cell and its membrane; a circuit's loop; a gear train.
  • Label on the word. A name is written next to its part the moment it is said, underlined if it is the key term. Fits content like: parts of an engine; the layers of the atmosphere; the axes of a graph.
  • Work it out. Lines of working written one by one, the last boxed in red. Fits content like: a density; a speed from distance and time; a probability from counts.
  • Frame the figure. A pencil box closes around a finished drawing and its figure label is written beneath. Fits content like: a view from above; a cross-section; a magnified detail.
  • Tab the question. A paper tab is stuck at the page edge with the scene's question or answer. Fits content like: the gap a theory fills; the step that changes everything; the thing to remember.

Avoid: pitfalls

  • A diagram drawn all at once: it is a picture, not a notebook. Fix: tween the drawing over the words that describe it.
  • Lines too thin to read at 1920 × 1080: Fix: ink 4 to 6 px, pencil 3 px.
  • Red for decoration: the result stops standing out. Fix: one red thing per scene.
  • Handwriting for long sentences: Fix: keep written text to labels and short working; the narration carries the sentences.
  • A label far from its part: Fix: write it beside, or draw a short arrow.

Freedom in each work

Each film decides its story, scenes, drawings, which pens, how many pages, tabs and the ending. Three far-apart structures: one drawing built up across the film until the result is boxed; a comparison of two drawings on facing halves of the page; a sequence of steps, each a small numbered drawing down the page.

Colours tokens.json

  • bg#D9D5C9
  • panel#FBFAF5
  • panel2#F1EFE6
  • border#E2A3A0
  • text#1B2A47
  • muted#6A7180
  • faint#D3DFEC
  • data#2F67A8
  • grad#CF4F33
  • op#7A5BA6
  • good#3B8A5F
  • bad#CF4F33
  • warn#F2C14E

Faces

sans
Atkinson Hyperlegible Next, Noto Sans SC, sans-serif
mono
JetBrains Mono, monospace
display
Shantell Sans, LXGW WenKai, cursive

Credits

Lab Notebook is an original motion by SuoSi.

Fonts

  • Atkinson Hyperlegible Next: SIL Open Font License 1.1
  • Noto Sans SC: SIL Open Font License 1.1
  • JetBrains Mono: SIL Open Font License 1.1
  • Shantell Sans: SIL Open Font License 1.1
  • LXGW WenKai: SIL Open Font License 1.1

More by SuoSi See all