.---------------------------.      ____                 _        ____    _    ____ ___ ____
        /---------------------------/|     / ___|_ __ _   _  ___| |_ _   | __ )  / \  / ___|_ _/ ___|
       /| _________________________ ||    | |   | '__| | | |/ __| __| | ||  _ \ / _ \ \___ \| | |
      | | |                       | ||    | |___| |  | |_| |\__ \ |_| |_|| |_) / ___ \ ___) | | |___
      | | | 10 PRINT "CRUSTYBASIC"| ||     \____|_|   \__,_||___/\__|\__,|____/_/   \_\____/___|____|
      | | | 20 GOTO 10            | ||                                |___/
      | | | RUN                   | ||
      | | | _                     | ||
      | | |_______________________| ||
      | |  _           _        _   ||    .----------.
      | | |_|_________|_|______|_|__|/    | [======] |
      /_____________________________/     |    __    |
      |_____________________________|     |   |  |   |
        [_][_][_][_][_][_][_][_][_]       |___|__|___|
        [_][_][_][=======][_][_][_]

            \ )             ( /
             \ \__~^~^~^~__/ /
      _______-<   \ o   o /  >-_______
     ----------|    \___/   |----------
               \___________/

crustyBASIC

CrustyBASIC is a Rust-based BASIC cross-compiler for 80s era computers and consoles. It compiles BASIC source into native machine code.

Currently supported machines: Apple II, Atari 8-bit, Atari 2600, Commodore 64, Plus/4, and VIC-20, TRS-80 Color Computer, and the NES.

Downloading the Compiler

To download the latest compiled binaries for Windows, macOS, or Linux, please visit the Releases Section on the right side of this page.

Quick Start

Save the below text as hello.cbs:

@OPTION TARGET "c64"

CLS
POSITION 0, 0
PRINT "HELLO, WORLD!"

Compile it to assembly:

crustybasic compile hello.cbs -o hello.s

Build a runnable C64 .prg in one shot. This needs a compatible assembler (like vasm); see USAGE.md#assemblers.

crustybasic build hello.cbs -o hello.prg

Screenshots

Screenshots and emulator captures live in screenshots.

Submitting Bugs

Please submit bug reports through the GitHub Issues tab for this repository. Include the CrustyBASIC version, your operating system, the target or system you are building for, the command you ran, and any compiler or assembler output.

Small self-contained .cbs files are the easiest reports to reproduce. If the bug came from a private project, please reduce it to a minimal public example before posting.

Learn more

• Usage guide - commands, targets, dialects, assemblers, and examples.
• Language reference - core language syntax.
• API reference - portable runtime calls, graphics, sound, input, and target capabilities.
• Target documentation - machine-specific notes for supported targets.