Installation

Prerequisites

Required

• Ruby v2.0 or later (Ruby 2.7+ recommended)
• VICE emulator v3.6.1 or later (includes the petcat utility)

Optional

• Make (for automated builds)
• Blitz! BASIC Compiler by Daniel Kahlin (see version compatibility details)
• Filesystem watching via inotify-tools

Installation procedure

# Clone repository
git clone https://github.com/cbase-larrymod/bpp-plus.git
cd bpp-plus

# Set executable permissions
chmod +x bpp

# Verify installation
./bpp --version

Verification

# Test basic functionality
echo 'main: print "test": end' | bpp
# Expected output:
# 1 print"test":end

# Test with petcat
echo 'main: print "test": end' | bpp | petcat -w2 -o test.prg --
# Should create test.prg without errors

---

Next steps

Once installation is complete, proceed to the Compilation pipeline to learn the full build workflow.