| project name: | terrarium |
| project url: | https://github.com/carlosedp/terrarium |
| author: | carlosedp |
| description: | 馃尡 A small world of modular instruments for monome norns. |
| discussion url: | https://talk.splines.cc/t/terrarium-splines/16/2 |
| documentation url: | https://github.com/carlosedp/terrarium/blob/main/doc/MANUAL.md |
| tags: | generative synth engine |

馃尡 A small world of modular instruments for monome norns.
Read the manual for how to play it (also as a PDF), or try it in your browser, phones included: the real script, playing the real Mutable Instruments code. It also comes as a VST3 / AU plugin for your DAW, on its tempo and automation: see the plugin's manual (and plugin/ for building it).
The patch is a landscape. Five parts each draw one piece of the scene and play one part of the sound. Swap a module and that piece of the scene changes; turn a macro and the scene moves with the sound. The screen shows no numbers.
| Part | In the scene | Modules |
|---|---|---|
| weather | when notes happen and which ones | rain (clocked to the norns clock), lightning (random), snow (drifting, and it settles) |
| soil | what grows from the ground: what plays | meadow (Plaits), crystals (Plaits 6-op FM), reeds (Rings), visitors (MIDI out, the audio in back) |
| water | the pond and the fog: what shapes it | pond (Rings), fog (Ripples) |
| air | the sky: where it rings out | clouds (Clouds), fireflies (Beads), mountains (MiVerb) |
| hum | always there, under it all, on the key's root and fifth | aurora (Plaits), roots (Elements), none |
The whole scene sits behind the terrarium's glass. Rain beads up on it, and freezing the air frosts it over.
Every note is a place: where it lands across the screen sets its pitch in the current key and scale. The weather keeps a Turing Machine-style phrase, and each note leaves a mark on the ground. Change sets how often notes are replaced, dropped to a rest or added back. Seasons (slow by default) let the key drift between close neighbors and find its way home, at dawn and dusk when the day is on, a note at a time.
From the maiden REPL:
;install https://github.com/glassgarden/terrarium
| Control | Does |
|---|---|
| E1 | choose a part (the others dim for a moment) |
| E2, E3 | that part's two macros (their names show for a moment while you turn) |
| K2 | swap the part's module |
| hold K2 + E2 | pick the module's variant: Plaits engine (meadow), DX bank (crystals), Rings model (reeds, pond), MIDI device (visitors), Clouds mode |
| K3 | gesture: new phrase (weather), strike (soil, water), freeze (air), hush / rise (hum) |
| hold K1 | peek at all parts; while held, E2 picks a setting and E3 changes it |
| hold K1 + K3 | a new terrarium: random modules, varieties, knobs and settings, all but the day (also PARAMS > randomize the jar) |
Climate (a setting, off by default) lets a chaotic attractor slowly move the macros: fronts (Lorenz), gusts (R枚ssler), tides (Thomas) or squalls (Chua). It moves them, the way CV moves a module's knobs: the macro you set is the center and the climate pushes it around it. Each macro has a cv amount in PARAMS; the peek view shows where each macro is right now and the attractor's path.
Day (a setting, off by default) adds the longest arc: a day and night of 20 minutes, an hour, or following the norns' clock. Night slows the weather, darkens the soil, opens up the air and brings the hum forward; the sky shows a sun by day and a moon and stars by night.
Erosion (a setting: off, faint, worn, deep, ancient; faint by default) gives the whole sound the wear of an old recording: wow, flutter, crackle, hiss, a rolled-off top, a little warmth. It glues the notes, the hum and the sky together; dust settles on the glass as it wears.
Snow (a weather module) falls slower and looser than rain and settles on the ground. The snow cover muffles the soil, more the longer it snows; with the day on, the sun thaws it (the meltwater drips a few soft notes) and the night lets it build up again.
Breath (a setting, gentle by default) adds silence: now and then the weather calms for a phrase or three, notes rest (the phrase keeps them) and their marks dim, then it breathes in again.
Presets: the jar you leave (for another script, or SLEEP) comes back the next time you open terrarium; PARAMS > reset the jar brings back the plain one. To keep more than one, norns saves presets for you: in the norns menu, PARAMS > PSET > save / load. A preset holds everything, including modules, variants, settings, levels, and whether the air is frozen or the hum hushed.
A quick tap of K1 still opens the norns menu. Settings (key, scale, range, length, seasons, climate, drift, day, breath, erosion), every macro, and each module's fixed options (Plaits engine, DX bank, Rings model, Clouds mode) are also in PARAMS, so they save with PSETs and can be MIDI-mapped.
How it's built, testing without a norns, running it in a browser, tuning and what's left to do on hardware: see doc/DEVELOPMENT.md.
The device under the night sky, for a desktop (3840 脳 2160) or a phone (1179 脳 2556), in the aluminium case or the black one.
| Scene | Desktop | Phone |
|---|---|---|
![]() Rain on a meadow and a pond, clouds, an aurora |
aluminium 路 black | aluminium 路 black |
![]() Snow settling on crystals, mountains behind |
aluminium 路 black | aluminium 路 black |
![]() Reeds over a pond, fireflies in the dark |
aluminium 路 black | aluminium 路 black |
terrarium is made by glassgarden. 漏 2026 glassgarden.
lib/Engine_Terrarium/, built
from mi-UGens (BUILDINFO there records
the source).
wasmoon (MIT) is vendored in tools/norns-web, and
norns-deps (MIT, by vehka) in lib/deps.lua and
lib/deps/; it installs and removes the mi-UGens. The plugin's
downloads carry THIRD-PARTY-NOTICES.txt, with the licences of all it
includes.