Skip to content
ScriptSmithPublic

Repository files navigation

Hypercube

Hypercube's pieces scrolling past, each with a screenshot, its title and a short description

Games, visualisations and interactive learning pieces for large multi-touch installations: rows of portrait touch panels under projectors, wide touch walls, kiosks and spherical displays. Each display loads one page of a static, frontend-only site that runs from any static host with no backend of its own. Pages that play together connect peer-to-peer with WebRTC, using a PeerJS broker only to find each other.

Live site: https://hypercube.adsm.dev/

  • / lists the pieces and builds the URL for each display.
  • /play/?app=<id> runs a piece. Add fit=1080x1920 to preview a portrait panel on a phone or laptop.
  • /sim/ simulates a whole installation in one browser tab.

Pieces

Each title links to the piece's page on the site, which shows a live preview and builds the URLs to set it up. The last column lists the kinds of display it runs on:

  • panel: a portrait touch panel
  • pair: two panels side by side, used as one surface
  • wall: a wide touch wall
  • kiosk: a landscape touch screen
  • screen: a large display above a row of panels, which nobody touches
  • sphere: a spherical display

Games

Piece What it does Runs on
Bluebottle Beach Bluebottle Beach Dig the sand together and work out where the bluebottles hide from the numbers, with no guessing needed. panel, pair, wall, screen
Crane Skyline Crane Skyline Send blocks to the yard and swing them up with a tower crane to build a skyline. panel, pair, wall, kiosk, screen
Many Hands Many Hands Quick tasks on every panel make parts for one big build that always gets finished. panel, pair, wall, screen
Pinball Pinball Flippers low for children, flippers high for grown-ups, and deck shots fly up to the screen. panel, pair, wall, screen
Recycling Rush Recycling Rush Grab rubbish off the belts and throw it in the right bin; full bins build a park. panel, pair, wall, kiosk, screen
Table Hockey Table Hockey Knock pucks into the other side's goal with a mallet that follows your finger. panel, pair, wall, kiosk, screen
Tangle Tangle Steer a glowing line and stay off every trail. The last line moving wins. panel, pair, wall, screen
Tilt Maze Tilt Maze Tip a wooden maze with a big pad and roll the ball into the goal; finished balls shoot up into a marble run. panel, pair, wall, kiosk, screen
Touchdown Touchdown Two people, one engine each: work together to set a little spacecraft down on a pad. panel, pair, wall, kiosk, screen
Treetop Race Treetop Race Tap to fly through the gaps and race everyone else on the same course. panel, pair, wall, screen

Visualisations and learning pieces

Piece What it does Runs on
Airflow Airflow Put a wing, a car or a bird in a stream of smoke, turn it and change the wind, and watch the air part, swirl and shed eddies. panel, pair, wall, kiosk, screen
Answer Ball Answer Ball A giant answer ball: it rocks, and in its windows a die rises out of dark liquid with an answer. On a wall, touch a ball to shake it. wall, sphere
Ball Pit Poll Ball Pit Poll Answer a picture question and watch your ball whoosh up a pipe into its tube. panel, pair, wall, kiosk, screen
Beach Ball Beach Ball A sphere becomes a lazily spinning beach ball; on a wall, bat and throw beach balls and toys round a beach with an umbrella and a crab. wall, sphere
Big Eye Big Eye A realistic eye that darts glances round the room, at people below and level with it, and on a wall turns to whoever touches. wall, sphere
Brisbane Transit Brisbane Transit Every bus, train and ferry in inner Brisbane moving on a live map. Light up a mode, follow a route, or drag and zoom the map. wall, kiosk, screen
Cake Cake The whole ball is a round cake under a glossy glaze: a Christmas pudding or one of four others. sphere
Chladni Plate Chladni Plate Ring a sand-covered plate, move where it is shaken, stretch or damp it, and watch the sand find the still lines. panel, pair, wall, kiosk, screen
Claw Machine Claw Machine Claw machines that play themselves round the ball, or stand in a row on a wall for anyone to have a go. wall, sphere
Disco Ball Disco Ball The ball becomes a mirror ball, turning slowly and sparkling with spotlights. sphere
Evolution Evolution Catch the fish you can see. The hidden ones live to breed, and their family tree grows above the pond. panel, pair, wall, screen
Eye Lab Eye Lab Change an eye's length, curve, age and light, see where light focuses and how a scene looks through it. panel, pair, wall, kiosk, screen
Fireworks Fireworks Build a firework shell, send it up and watch it burst in the sky above. panel, pair, wall, screen
Fish Bowl Fish Bowl A planted tank of fish, shrimp and snails behind the wall's glass, or the ball as a glass bowl of water with funny fish that come up to the glass. wall, sphere
Fourier Loom Fourier Loom Each slider and dial sets one sine wave; together they weave any shape. panel, pair, wall, kiosk, screen
Fourth Dimension Fourth Dimension Push a 4D shape through our space and watch its slice grow, change and vanish. panel, pair, wall, kiosk, screen
Gravity Sandbox Gravity Sandbox Fling rocks, planets, gas giants and stars into a universe where everything pulls on everything else. panel, pair, wall, kiosk, screen
Hatching Egg Hatching Egg The ball is a hen's egg: it rocks, cracks round and opens, and a fluffy chick looks about. sphere
Hourglass Hourglass The ball is a giant hourglass: its sand runs out at a time you set, with a countdown round its collar and your own message below. sphere
Ink Mural Ink Mural Pour warm ink that billows up the wall and settles into a layer for each hour, or steer a kaleidoscope with your hands. panel, pair, wall, screen
Kites Kites Hold a spool to send a kite climbing, or steer a stunt kite through rings on the breeze. panel, pair, wall, screen
Light Bench Light Bench Place mirrors, prisms and lenses and turn them to steer beams of light into the crystals. panel, pair, wall, kiosk, screen
Logic Lab Logic Lab Flip big switches to light lamps, then wire logic gates between them to run a machine up on the wall. pair, wall, kiosk
Network Graphs Network Graphs Explore a network: tap a node to see what it connects to. panel, pair, wall, kiosk, screen
Petri Dish Petri Dish Seed a living culture with gliders, slime mould spores or drops of reagent and watch it grow. panel, pair, wall, screen
Robot Arm Robot Arm Turn one dial per joint to swing a six-axis arm, grab a block and put it down. panel, pair, wall, kiosk, screen
Salute Salute The ball is a friendly face that turns to each side of the room and salutes. sphere
Sleeping Echidna Sleeping Echidna The whole ball is an echidna curled up asleep, breathing slowly and twitching now and then. sphere
Snow Globe Snow Globe The ball is a giant snow globe: a little winter scene inside, snow drifting down, and a shake every minute or two. sphere
Sun, Earth and Moon Sun, Earth and Moon Carry the Earth round the Sun and watch the seasons, or the Moon round the Earth. panel, pair, wall, kiosk, screen
Ticker Ring Ticker Ring Rings of bright lettering crawl round the ball, so everyone round it can read them. sphere
Tiny World Tiny World Pour sand, water, seeds, fire and lava from your fingertips and watch them fall, flow and grow. panel, pair, wall, screen
Traffic Traffic Touch a car to brake it and watch the jam you made travel backwards round the ring. panel, pair, wall, screen
Unit Circle Unit Circle Turn a point round a circle and watch sin, cos and tan grow out of it. panel, pair, wall, kiosk, screen
Vision Orb Vision Orb The ball becomes a dark glass orb full of swirling smoke, where now and then a faraway place clears and fades. sphere
X-Ray Diffraction X-Ray Diffraction An interactive poster in eleven chapters on how X-rays show us the atoms inside a crystal. panel, pair, wall, kiosk, screen

Development

pnpm install
pnpm dev

See AGENTS.md for the layout, URL parameters and how to write a piece.

Libraries

Hypercube uses a few libraries at runtime:

Everything else is written for this project: the pieces with their physics and simulations, the rendering, the networking on top of PeerJS (rooms, a relay hub and a shared clock) and the runtime that every display loads.

Licence and credits

Hypercube's code is under the MIT licence (LICENSE). The build writes the licences of every library it bundles to third-party-licenses.txt, which the site serves and links from its footer.

  • Brisbane Transit's route shapes and recorded vehicle positions in src/apps/transit/data/ are adapted from Translink's open data under CC BY 4.0: simplified to route ids, shapes and positions.
  • The transit map shows OpenFreeMap tiles in the OpenMapTiles schema, built from data © OpenStreetMap contributors. The app shows this credit on the map, and so do its screenshots here.