DOS Lemmings in your terminal, rendered in braille characters. Watch lemmings spawn, navigate levels autonomously, and interact with terrain. Pan with arrow keys, quit with Esc.
git clone https://github.com/peteraxelblom/braillings.git
cd braillings
python3 braillings.pyNo dependencies beyond Python 3.
Braillings can also work as a directory picker — menu items become platforms that lemmings walk on. Pick a destination, watch them all explode, and land in that directory.
python3 braillings-launcher.py # standalone with fun labels
./setup-launcher # configure real directories + shell integrationSetup will:
- Suggest directories from your shell history (opt-in)
- Let you choose: launch on terminal start, manual command, or screensaver only
- Optionally start Claude in the selected directory
- Show you exactly what it adds to your shell config before changing anything
Auto-launch is intentionally skipped in Warp. Warp routes anything that runs during shell startup into a block that doesn't pass keystrokes through, so the launcher would render but ignore your input. The shell snippet checks $TERM_PROGRAM and skips the auto-invoke under Warp. The braillings function is still defined, so you can type braillings once the prompt appears — at that point Warp treats it as a regular command and forwards keys normally.
- Python 3 (stdlib only, no pip packages). Gamedata was baked with Python 3.9.6.
- A terminal that supports Unicode braille characters and ANSI truecolor
- macOS or Linux
After running setup, destinations live in ~/.config/braillings/config:
# display_name|/path/to/directory
projects|~/projects
work|~/work/repo
Edit this file directly or re-run ./setup-launcher.
- Arrow keys: Pan the camera
- Esc / q / Ctrl-C: Quit
- Number keys (1-9): Select a destination
- Arrow keys: Pan the camera
- Esc / q / Ctrl-C: Quit without selecting