You caught the crab.
crab-rave
A crab rave in your terminal. Run it first. Ask questions later.

--sound for the full experience.Install
Turn the volume up.
Run it before you read anything else, and make the window as big as it goes. You need Rust 1.88 or newer. On Linux, install the ALSA development package first.
Source on GitHub (opens in a new tab)cargo install --git https://github.com/yannelli/crab-rave
crab-rave --soundWhat is this
No images. No audio files. No engine.
A 1,650-line Rust program draws every crab from scratch, every frame: jointed arms, snapping pincers, and eyes that look around. The music is synthesized sample by sample while you watch, on the same 125 BPM timeline, so each kick lands with its shockwave. The crabs know four routines. Watch to find out what they are.
crab-rave | Rave until you press a key. |
|---|---|
crab-rave --sound | Rave with the beat. |
crab-rave -d 30 | Rave for 30 seconds. |
It looks best in a terminal with 24-bit color, like Ghostty, iTerm2, WezTerm, or Kitty. A bigger window gets a bigger crab. iTerm2 users get something extra. Look at your tab.
How it works
Six files.
src/main.rs | Arguments, terminal setup, and the 30 fps frame loop |
|---|---|
src/canvas.rs | A pixel canvas of half-block characters, two pixels per cell |
src/crab.rs | The crab, drawn from joints, and its dance poses |
src/scene.rs | Sky, sun, floor grid, light beams, shockwaves, confetti, and the drop |
src/audio.rs | Kick, claps, hats, bass, pad, and arpeggio at 125 BPM |
src/art.rs | The banner font |
Make it better
The crabs want more.
New dance routines
A routine is a list of arm positions per beat. The crabs have never done the worm.
More crabs
A crab line, a crab conga, a crab that crowd-surfs across the screen.
Better music
The synth is about 230 lines. Write a breakdown, a second drop, or a better bassline.
New scenes
The stage is a synthwave sunset. It could be an underwater club or a disco ball.
Pull requests are welcome, from one-line fixes to new scenes. Open one on GitHub (opens in a new tab).