ORRERY · THE CLOCKWORK COSMOS PLANETARY ENGINE No. 360 · MMXXVI

ORRERY

THE CLOCKWORK COSMOS
SCROLL — OR GRAB THE CRANK
CHAPTER I — MACRO

The Mechanism

A computer cast in brass. Every wheel you see is cut in code — no model files, no textures on a wire. Each tooth engages its neighbour at a ratio chosen two thousand years before the transistor. The machine does not depict the sky. It computes it.

CHAPTER II — GEAR RATIOS

The Ratios

Count the teeth. 47 : 120 carries Mercury's year into Venus's. 8 : 13 finds Earth — the same Fibonacci fraction that traces Venus's pentagram across eight of our years. The error in every stage is under six-tenths of one percent.

CHAPTER III — PULL BACK

The Cosmos

Keep pulling back and the gears come apart into the thing they were always computing. The brass was a mnemonic. Every planet on screen is still being driven by the train — the crank in your hand, through eight meshing stages.

CHAPTER IV — DEEP TIME

The Long Now

The engine winds itself forward to 8 September 2040 — Mercury, Venus, Mars, Jupiter and Saturn gathered inside a ten-degree circle at dusk. Orreries were built for exactly this: to hold a future sky in your palm.

ORBITAL ELEMENTS — NASA JPL, “Keplerian Elements for Approximate Positions of the Major Planets”, J2000 epoch. Gear-train conception after the Antikythera mechanism, c. 150–100 BC. All geometry, texture and sound generated in code.

⟲ DRAG THE CRANK
2000 JAN 01
T + 0.0 YR SINCE J2000
DIMA × KIMI
0.3 D/S

ABOUT THE ENGINE

ORRERY — The Clockwork Cosmos is an astronomical clock come alive. It opens on a brass-and-glass gear mechanism in the Antikythera tradition — every wheel generated in code, no model files — and as you scroll, the camera pulls back and the gears dissolve into the solar system they were always computing. Each planet's motion is literally driven by the visible train: the hand crank is the master wheel, through eight meshing stages.

THE TRAIN

One crank revolution = 21.99225 days. The crank's 20T pinion turns an 80T wheel — the Mercury shaft, one revolution per 4 crank turns (87.969 d, exact). From there each visible pair carries one planet: 47:120 → Venus (Δ0.018%) · 8:13 → Earth (Δ0.05%, the Fibonacci fraction of Venus's pentagram) · 17:32 → Mars · 5:59 → Jupiter · 8:20 → Saturn · 7:20 → Uranus · 21:41 → Neptune. Every stage is within six-tenths of one percent of the true period — the same trick the Antikythera mechanism pulled two thousand years ago.

CONTROLS

SCROLL — ride the four chapters · DRAG THE CRANK (or drag anywhere) — wind time by hand, with detents and inertia · FLOW — autonomous rate, 0.1 day/s to 10 yr/s, HELD at zero · ORRERY/TRUE SCALE — toggle real AU distances · SOUND — procedural WebAudio: tooth ticks, detent clicks, a drone that deepens with distance.

DATA & PRECEDENT

Orbital elements: NASA JPL, “Keplerian Elements for Approximate Positions of the Major Planets”, J2000 epoch; positions integrated by Newton's method from Kepler's equation. Gear-train conception after the Antikythera mechanism, c. 150–100 BC. Chapter IV winds to the real five-planet dusk conjunction of 8 September 2040. All geometry, textures and sound are procedural; three.js r160 via pinned CDN import map; one self-contained HTML file.

THE COMMISSION

Build "ORRERY — The Clockwork Cosmos" — a single-page immersive web experience, delivered as ONE self-contained index.html (CDN libraries via pinned import map; no build step; deployable as a static file on Cloudflare Pages). CONCEPT: An astronomical clock come alive. The page opens on a procedurally-modeled brass-and-glass gear mechanism (three.js) in the Antikythera tradition. As the visitor scrolls, the camera pulls back and the gears dissolve into the solar system they compute — every planet's motion is literally driven by the visible gear train. Engineering made cosmic. 1. PROCEDURAL GEAR TRAIN — model a working epicyclic gear train in three.js (gear geometry generated in code; no external 3D files). Gears must visibly mesh and rotate at mathematically correct ratios matching real planetary periods. Brass/patina/glass materials with environment lighting, subtle bloom and depth of field. 2. REAL DATA — embed real Keplerian orbital elements for 8 planets (inline JSON, JPL-sourced, cited in footer). Planets orbit at correct relative periods; a time scrubber accelerates days→years; toggle between true scale and "aesthetic" scale. 3. THE HAND CRANK — a visible crank the user grabs and drags in a circle (raycast + circular drag math), gear train and cosmos responding together; inertial spin on release. It must feel physical — damped springs, subtle resistance, mechanical feedback. 4. SCROLL NARRATIVE — 4 chapters: The Mechanism → The Ratios → The Cosmos → The Long Now (scrub to a future planetary alignment). Camera rides damped spline paths. 5. ENGINEERING CALLOUTS — screen-space projected annotation lines with real facts; monospaced spec typography; blueprint styling that morphs into constellation styling as the scene turns cosmic. 6. SOUND — procedural WebAudio only: tick per gear tooth, a drone that shifts with camera distance, crank resistance clicks. Muted by default. 7. POLISH — zero linear tweens; 60fps; loading sequence styled as a watchmaker assembling the mechanism; resize handling; prefers-reduced-motion support; mobile fallback; zero console errors; no hotlinked external images.

CREDITS

Direction & concept — Dima (madeby.dev). Design, engineering & words — Kimi, an AI coding agent by Moonshot AI, working in Kimi Code CLI. One prompt, one self-contained index.html, no build step.

0%
A WATCHMAKER IS ASSEMBLING THE MECHANISM