garrett-webb/terminalpolyominos — explained in plain English
Analysis updated 2026-05-18
Play a Tetris-style block-stacking game directly in a terminal with no GUI required.
Compete for local high scores across different game modes and piece randomizers.
Build the game from source on Linux or macOS and customize keybindings and timing settings.
| garrett-webb/terminalpolyominos | 4brm01/picture-poker | bong-water-water-bong/npu-gpu-cpu | |
|---|---|---|---|
| Stars | 3 | 3 | 3 |
| Language | C++ | C++ | C++ |
| Setup difficulty | easy | easy | hard |
| Complexity | 2/5 | 1/5 | 5/5 |
| Audience | developer | general | researcher |
Figures from each repo's GitHub metadata at analysis time.
Download the prebuilt AppImage or binary for your OS and run it directly in a real terminal.
This is a falling block puzzle game, in the style of the classic genre often called Tetris-likes, that runs entirely inside a Unix terminal window. It is written in C++ with no third-party libraries at all, relying only on the C++ standard library and the terminal control system built into Unix-like operating systems, which keeps the download tiny, around 1 megabyte. The game includes the features players expect from a modern block-stacking game: a hold slot to save a piece for later, a ghost piece showing where the current piece will land, adjustable drop speeds including instant hard drops, and the classic rotation system with wall kicks that lets pieces rotate near walls or other blocks. It tracks combos and back-to-back bonuses for chaining difficult line clears, and it keeps local high scores separately for each combination of game mode and piece randomizer. One of its more distinctive features is a choice of six different piece randomizers. Besides the standard method of shuffling the seven classic piece shapes, there are modes that generate entirely new, computer-created piece shapes on the fly, giving the game a different feel each time. Players can choose between endless play, a fixed 150-line marathon, or a 40-line speed sprint, and the game supports full color piece display when the terminal supports it, falling back gracefully to fewer colors or no color at all. To play, someone can download a prebuilt release for Linux or macOS and run it directly in a terminal, Windows users are expected to use WSL, since there is no native Windows build planned. All keybindings and timing settings, such as how quickly a held direction repeats, can be changed from an in-game settings menu and are saved to a configuration file. Building it from source requires a C++20 compiler and CMake. The project is released under the GPL-3.0-or-later license.
A lightweight, dependency-free block-stacking puzzle game for Unix terminals with wall-kick rotation, six piece randomizers, and local high scores.
Mainly C++. The stack also includes C++, CMake, POSIX termios.
GPL-3.0-or-later: you can use and modify it freely, but any distributed modified version must also be open-sourced under the same license.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
Verify against the repo before relying on details.