Setrixtui is a Setris/Sandtrix-style game in the terminal. Place coloured blocks; when they lock, they turn into sand. Clear lines by making a single colour connect the left edge to the right edge (8-neighbour, path can be diagonal). Matching piece colours and completing those spans scores points; remaining sand falls under gravity.

• Rust 1.86+ (ratatui 0.30)
• Edition 2024

cargo install setrixtui

Or build from source:

cargo build --release
./target/release/setrixtui

Run without installing:

nix run github:Mjoyufull/setrixtui

install from github:

nix profile add github:Mjoyufull/setrixtui

./target/release/setrixtui

By default you get the main menu (difficulty, mode, autoplay, auto-restart), then play. Endless mode and easy difficulty are selected by default. Use --theme ./theme.theme for your theme (otherwise the built-in One Dark is used).

Start without the menu:

./target/release/setrixtui --no-menu

With autoplay (Bot* plays the game) and auto-restart on game over for it to keep playing:

select

setrixtui --autoplay
# or: -r / --ar

**bot kinda sucks rn Help: -h / --h for short help, --help / --Help for full tree-style help with controls.

Custom playfield and options:

setrixtui --width 10 --height 24 --theme ./onedark.theme
setrixtui -m timed --time-limit 180 -d hard --no-animation

Playfield size is in grid cells (columns × rows). Default is 10×24. The game sizes the board to fit your terminal: in the menu, zooming out gives a larger playfield (up to 12×28); during play, the size is fixed. If the terminal is small, the board is reduced so everything fits.

Game over: R restart, Q quit.

• Playfield (left, bordered): each block is 6×6 “grains”; the board uses half-blocks (▀) so two grain rows map to one terminal row.
• Sidebar (24 cols): next-piece preview with exact colours (1–3 pieces depending on difficulty), six sand colours, score, level, and in timed mode the remaining time. When autoplay is on, the next area shows an AUTOPLAY indicator instead.

Rough size: playfield needs (width×6 + 2) columns and (height×3 + 2) rows including border, plus 24 columns for the sidebar.

Movement keys repeat when held. Normal and vim-style bindings are supported.

P toggles pause. On game over or win: R restart, Q quit.

Themes are btop-style: theme[key]="value" with hex colours. See onedark.theme in the repo.

• --theme FILE: load colours from the file. Sand colours use keys such as mem_box, title, cpu_end, cpu_box, net_box, hi_fg; UI uses meter_bg, div_line, main_fg, title, inactive_fg. Hex values are used as-is.
• No theme file: built-in One Dark is used (same hex values as in onedark.theme).

--palette high-contrast or --palette colorblind overrides only the sand colours; the rest of the theme is unchanged.

• Playfield: --width COLS, --height ROWS (default 10×24). Sized to fit the terminal.
• Mode: -m endless | timed | clear40. Timed: --time-limit SECS. Clear40: --clear-lines N (default 40).
• Difficulty: -d easy | medium | hard (gravity, next-piece count, and colour-repeat bias: 40% / 20% / 8%).
• Theme: --theme FILE (btop-style). --palette normal | high-contrast | colorblind for sand only.
• Autoplay: --autoplay (with --no-menu), or toggle in main menu. --auto-restart / -r to restart on game over (handy with autoplay).
• Help: -h / --h short help; --help / --Help full tree-style help.
• Tuning: --tick-rate, --frame-rate, --spawn-delay-ms, --lock-delay-ms, --initial-level, --relaxed, --sand-settle, --no-animation, --no-menu, --high-color.

Full list: setrixtui --help or setrixtui -h.

bit of help from gemini flash from antigravity and zeditor (struggled with codex still learning how to use AI)