Try
↑↓Move↵OpenCtrl↵New tabescClose

You caught the crab.

crab-rave

A crab rave in your terminal. Run it first. Ask questions later.

Three pixel crabs dance under a synthwave sun while CRAB RAVE glows in the sky.
No sound here. Use --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)
Terminal
cargo install --git https://github.com/yannelli/crab-rave
crab-rave --sound

What 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.

Commands
crab-raveRave until you press a key.
crab-rave --soundRave with the beat.
crab-rave -d 30Rave 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.

Source files
src/main.rsArguments, terminal setup, and the 30 fps frame loop
src/canvas.rsA pixel canvas of half-block characters, two pixels per cell
src/crab.rsThe crab, drawn from joints, and its dance poses
src/scene.rsSky, sun, floor grid, light beams, shockwaves, confetti, and the drop
src/audio.rsKick, claps, hats, bass, pad, and arpeggio at 125 BPM
src/art.rsThe 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).