tetris-terminal 0.2.6

A tetris game runs in the terminal

English | 中文

Tetris Terminal🎮

A terminal-based Tetris game written in Python using the curses library.

Features

• Modern Tetris design following the Tetris Design Guideline
  • Extended Placement
  • Next Piece Preview
  • SRS System
  • Piece Holding
  • Shadow Piece
  • Modern Scoring System
  • Modern Level System

Platform Support

Based on Python's curses module:

• ✅ Linux/macOS: Works out of the box
• ✅️ Windows: With windows-curses
• Can run on basically any terminal setup, even a linux tty.

Installation & Usage

pip install tetris-terminal
tetris

Controls

Key	Action
a, ←	Move left
d, →	Move right
w, ↑,x	Rotate cw
z	Rotate ccw
s, ↓	Soft drop
space	Hard drop
c	Hold
p	Pause
q	Quit game

CLI Options

Option	Description
--generate-config	Generate a default config file and exit
--disable-config	Ignore config file and run with built-in defaults
--version	Show version and exit

Configuration

On first run, or via tetris --generate-config, a configuration file is created at:

Platform	Path
Linux	~/.config/tetris-terminal/config.json
macOS	~/Library/Application Support/tetris-terminal/config.json
Windows	%APPDATA%/tetris-terminal/config.json

The config file references a JSON Schema for editor autocompletion and validation. All fields are optional — missing keys fall back to their defaults.

display

Visual appearance of the game board.

Key	Default	Description
empty_cell	" "	Empty cell character
solid_cell	"██"	Filled cell character
shadow_cell	"░░"	Shadow piece character
bd_v	"│"	Border vertical
bd_h	"─"	Border horizontal
bd_tl	"╭"	Border top-left
bd_tr	"╮"	Border top-right
bd_bl	"╰"	Border bottom-left
bd_br	"╯"	Border bottom-right
bd_vr	"├"	Border T-right
bd_vl	"┤"	Border T-left
bd_hb	"┬"	Border T-bottom
bd_ht	"┴"	Border T-top

timing

Frame rate and animation settings.

Key	Default	Description
fps	30	Frames per second
clear_anim_flash_interval	0.05	Line clear flash interval (seconds)
clear_anim_duration	0.3	Line clear animation duration (seconds)

game_rules

Gameplay parameters.

Key	Default	Description
max_lock_down_move_count	15	Max moves before piece locks down
time_attack_duration	120	Time Attack mode duration (seconds)

License

MIT License - see LICENSE for details.

Acknowledgements

Idea from tinytetris (a C implementation).

Going to be implemented(Maybe)

1. sound
2. ...