CcmaketerminaltmuxASCII

braille-snake

A Snake game rendered entirely in Unicode Braille characters, playable inside any terminal — optimised for tmux status bar.

$ Screenshot

braille-snake running in a terminal

braille-snake — full screen in a tmux pane

$ Demo

braille-snake gameplay demo

Recorded with asciinema + converted to GIF

$ Demo Within Tmux

braille-snake demo inside tmux status bar

Recorded with ShareX + converted to GIF

$ Configurable

braille-snake help function

braille-snake — cli usage function

$ Features

  • Rendered entirely with Unicode Braille block characters (U+2800–U+28FF)
  • Compatible with any POSIX terminal; works inside tmux status bar
  • Smooth input handling with no external dependencies
  • Configurable board size, speed, and other params
  • Compatible with tmux with unix socket server

$ Build & run

bash
# Clone the repo
git clone https://github.com/Pierre-Mollard/braille-snake
cd braille-snake

# Build program
cmake --build build

# Install program
cmake --install build --prefix ~/.local

# Run
./braille-snake

$ Run in a tmux status bar

tmux
 # Copy the config file to your own tmux configuration (see README.md) 

$ Stack

C99 Language
🖥 Terminal Custom TUI rendering
TMUX Multiplexer target
cmake Build chain

Want to try it or contribute?

Open on GitHub →
k