terminal-rain

Overview

A terminal based rain visualisation, inspired by nkleemann's implementation in C.

A terminal emulator that supports a 16 colour palette and ANSI escape codes is required for this program to function as expected

Installation

A C++20 compatible compiler is required for this program to function as expected

1. Clone this project

git clone https://github.com/Oakamoore/terminal-rain.git

2. Step into the repository

cd terminal-rain

3. Build the project using CMake

# Configure the build
cmake -S . -B build

# Build project binaries 
cmake --build build

A build configuration (Debug, Release etc.) can also be specified.

Disabling Testing

To prevent tests from being built, append -D ENABLE_TESTING=0 to the build configuration command.

Usage

Once the project is built, navigate to the newly created terminal-rain/build/ directory, locate the executable, then run the program using:

./terminal-rain

Press Escape or q while the program is running to quit.

Testing

Once the project is built, navigate to terminal-rain/build/tests/, locate the testing executable, then run the tests using:

./terminal-rain-tests