tetro-tui
A highly customizable, cross-platform Tetris-like game that runs entirely in the terminal.
What is tetro-tui?
Tetro TUI is a terminal-based Tetris-like game written in Rust that offers extensive customization and modern gameplay mechanics. It provides a feature-rich alternative to traditional Tetris games, with support for various gamemodes, rotation systems, and input configurations. The game runs cross-platform and leverages terminal capabilities for a smooth, flicker-free experience.
Terminal enthusiasts, Rust developers, and gamers who enjoy customizable retro-style games and want a modern Tetris experience in their command-line environment.
Developers choose Tetro TUI for its deep customization, modern mechanics (e.g., Ocular rotation system, advanced randomizers), and seamless terminal integration. It stands out as a fully open-source, cross-platform alternative with no dependencies beyond a terminal, offering both nostalgia and cutting-edge features.
Overview
Terminal-based but modern tetromino-stacking game that is customizable and cross-platform
Use Cases
Best For
- Playing a customizable Tetris game directly in the terminal
- Testing advanced tetromino mechanics like rotation systems and randomizers
- Learning Rust by exploring a well-structured terminal application
- Creating custom gamemodes and gameplay configurations
- Integrating retro gaming into a minimalist, terminal-based workflow
- Experimenting with terminal user interfaces (TUIs) and input handling
Not Ideal For
- Users without enhanced terminals (e.g., Kitty, Alacritty) who need precise key holding and modifier support
- Projects requiring graphical interfaces or high-end visual effects beyond terminal capabilities
- Casual players seeking a simple, out-of-the-box Tetris game without configuration overhead
- Environments where multiplayer or online features are essential for gameplay
Pros & Cons
Pros
Offers deep configuration for graphics (glyph sets, color palettes), keybinds, gameplay mechanics (rotation systems, randomizers), and gamemodes, as detailed in comprehensive menus like Adjust-Graphics and Adjust-Gameplay.
Supports advanced features such as DAS, ARR, SDF, IRS/IHS, and multiple rotation systems including the innovative Ocular system, making it competitive with modern tetromino stackers.
Runs on Linux, macOS, and Windows via pre-built releases or compilation from source, and is easily installable through package managers like crates.io and AUR.
Uses custom diff'ing techniques to prevent flicker and ensure smooth performance within terminal constraints, as mentioned in the TUI programming section.
Cons
Relies on enhanced terminals for key holding and modifier support; unenhanced terminals cannot fully implement mechanics like DAS and ARR, as admitted in the FAQ, which degrades gameplay.
The sheer number of settings and options, while a strength, can overwhelm users who prefer a straightforward gaming experience without extensive tweaking.
Being a terminal-based Rust project, it has a smaller user base and fewer community resources compared to mainstream Tetris games or graphical applications, limiting extensibility and troubleshooting.
Frequently Asked Questions
Related Projects
ArnisGenerate any location from the real world in Minecraft with a high level of detail.
cityboundA work-in-progress, open-source, multi-player city simulation game.
LudusaviBackup tool for PC game saves
rust-doomA Doom Renderer written in Rust.
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.