bf16

The first ever visual Brainfuck runtime built for running interactive games.

Usage

In order to use this runtime, you will have to compile it under a Linux distribution or Windows.

Requirements

Linux

A C compiler (gcc), make and Simple DirectMedia Layer (SDL2) development packages are required.

You can install them with one of the following commands.

On RHEL-based distributions (includes Fedora).

sudo dnf install gcc make SDL2-devel

On Debian-based distributions (includes Ubuntu and Mint).

sudo apt install gcc make libsdl2-dev

On Arch-based distributions (includes EndeavourOS, CachyOS and Manjaro).

sudo pacman -S gcc make sdl2

If your Linux distribution is immutable (such as Fedora Atomic, Bazzite or SteamOS), you can use Distrobox.

Windows

Visual Studio 2022 or later with the C++ and C development tools installed and vcpkg integration is required.

Compiling

Simply run the following commands inside a personal directory.

git clone https://github.com/p2r3/bf16

cd bf16

Linux

make

Windows

In Visual Studio Developer Command Prompt, run the following commands:

msbuild /p:Configuration="Release"
msbuild /p:Configuration="Release Grayscale"

This will produce two binaries — bf16 and bf16_grayscale. The former uses an RGB332 palette, the latter renders in grayscale. Test with the programs under examples/. Note that badapple.b is best used with bf16_grayscale.

Example usage

./bf16 examples/snake.b

./bf16_grayscale examples/badapple.b

Contributing

Submit issues before pull requests (discuss, then code), and adhere to the code style. Ideally, use the conventional commits naming scheme. Code that doesn't respect the style/conventions of the code base will not be accepted.