Skip to content

smallhadroncollider/ascii-runner

Repository files navigation

ASCII-Runner

An infinite runner in your terminal

If you enjoy ASCII-runner, you might also like taskell - a command-line Kanban board.

Screenshot

Installation

Binaries

A binary is available for Mac and Linux. Download it and copy it to a directory in your $PATH (e.g. /usr/local/bin or /usr/bin).

Debian/Ubuntu

A .deb package is available for Debian/Ubuntu. Download it and install with dpkg -i <package-name>.

Fedora

Run sudo dnf install ncurses-compat-libs then download and run binary as described below.

Stack

If none of the above options work you can build ASCII-runner using Stack. First install Stack on your machine. Then clone the repo and run stack build && stack install: this will build ascii-runner and then install it in ~/.local/bin (so make sure that directory is in your $PATH). Building from scratch can take a long time and occasionally doesn't work the first time (if this happens try running it again).

Windows

Unfortunately the vty package, which this program is heavily dependent on, doesn't currently support Windows. This may change in the future, but for now it means that ASCII-runner is not available for Windows. However, you could install WSL with Ubuntu and then follow the Ubuntu instructions above.

Usage

Run runner

Optionally pass a number for game speed, e.g. runner 15. The number represents the number of columns to move per second. 10 is quite easy, 30 is quite hard.

  • Space to jump
  • q to quit
  • Enter to restart after game over

FAQ

Why?

Why not

Seriously?

Yup