XTETRIS

🕹️ XTETRIS - Advanced Terminal Tetris

XTETRIS is a highly portable, cross-platform Tetris clone written entirely in pure C. It runs directly in your terminal using ncurses and features background audio playback via miniaudio.

Tested and verified on modern Linux, macOS, BSD, and even legacy PowerPC Mac G4 hardware.

📸 Visuals

⚙️ Features

• 100% C and ncurses: Lightweight, fast, and terminal-native.
• Cross-Platform Makefile: Automatically detects your OS (Linux, Darwin, BSD, Windows) and links the correct libraries.
• Audio Engine: Uses miniaudio for non-blocking background music (BGM).
• Modes: Single-player and Multi-player support.

💾 Installation & Build

You need a C compiler (gcc or clang) and the ncurses development headers.

1. Install Dependencies

macOS (via Homebrew):

brew install ncurses

Debian / Ubuntu:

sudo apt-get install libncurses5-dev libncursesw5-dev

Fedora / RHEL:

sudo dnf install ncurses-devel

FreeBSD:

sudo pkg install ncurses

2. Compile

Just run make. The Makefile will handle OS detection automatically.

make

3. Play

Run the executable passing the background music file as an argument, or simply use the Make target:

make run

👥 Authors

• Jacopo Costantini (jcostd)
• Alvise Silvestri
• Matteo Zambon

Note: This project is part of a university assignment. The code is kept as-is for historical reference.