Tetris (Terminal Edition)

Minimalist, terminal-based implementation of the classic Tetris game

Tetris Gameplay

Designed for simplicity, portability, and developer curiosity.

Installation Guide

Supports macOS and most Linux distributions. Windows may require workarounds.

macOS

Install using Homebrew:

brew install gautamankoji/tui/tetris

Arch Linux

Available via AUR:

yay -S tetris-terminal-git

Supports other AUR helpers like yaourt, paru, etc.

Snap (Universal Linux)

Thanks to @thefenriswolf:

sudo snap install tetris-thefenriswolf
alias tetris=/snap/bin/tetris-thefenriswolf.tetris

Consider adding the alias to your shell config for persistence.

Manual Installation (From Source)

Requires Haskell Stack:

git clone https://github.com/gautamankoji/tetris.git
cd tetris
stack install tetris

Running the Game

tetris

Options for appearance or behavior:

tetris --ascii-only
tetris --preview-chars 'XX'

Start at a specific level:

tetris --level <n>

Check high score:

tetris --high-score

See all options:

tetris --help

Developer Notes & Tips

Binary Compatibility

Linux binaries may be dynamically linked and not portable across distros. Build from source if needed. Report issues on GitHub.

Build Your Own

Built using brick, a Haskell library for terminal UIs.

Want to contribute or learn? Check out this intro tutorial.