
# Tetrs (tetrs-tui)
- A modern Tetris clone for your terminal, written in Rust with a responsive TUI and optional soundtrack.
- Check out the [crates.io page](https://crates.io/crates/tetrs-tui).
- Uses the [Cursive TUI library](https://github.com/gyscos/cursive) and [Rodio](https://github.com/RustAudio/rodio) for audio.
- Music synthesized from MIDI from [bitmidi.com](https://bitmidi.com/).
## Features
- Runs on Linux, MacOS, and Windows
- Beautiful TUI graphics
- Difficulty scaling
- Piece holding
- Toggleable music
- Toggleable ghost piece
- Persistent highscore
## Install
Before getting started, make sure you have [Rust and Cargo installed](https://doc.rust-lang.org/cargo/getting-started/installation.html).
Installing ALSA dev packages for (only needed for Linux):
```bash
# Ubuntu & Debian
sudo apt update
sudo apt install libasound2-dev pkg-config
# Fedora
sudo dnf install alsa-lib-devel pkgconf-pkg-config
# Arch
sudo pacman -S alsa-lib pkgconf
```
Installing Tetrs:
```bash
cargo install tetrs-tui
```
## Run
```bash
# if your Cargo binaries are on your path:
tetrs
# otherwise:
cd ~
./.cargo/bin/tetrs
```
## License
- Distributed under the [MIT License](LICENSE).