x16 emulator Getting Started

The x16-emulator provides early access to the x16 software.

You can download the latest release from this GitHub project. It includes the x16emu executable and the ROM image. It also includes documentation on the Kernal and BASIC interpreter (KERNAL-BASIC.html).

Kicking the Tires

1. Run the emulator ./x16emu or x16emu.exe
2. You start with the BASIC 'READY' prompt. Enter the following:

   10 PRINT"X16 IS AWESOME!":GOTO 10

3. Type RUN, and press the enter key.
4. Press Ctrl-C to stop.

Selecting a Keyboard Map (R30)

From within the emulator, you can press the F9 function key to cycle through 12 keyboard layouts. Or, use ./x16emu -keymap ___.

The available keymaps in R33 are:

• en-us
• en-gb
• de
• sv-se
• it
• pl
• hu
• es
• fr
• de-ch
• fr-be
• pt-br

Building from scratch on MacOS

# Compiler/Assembler/Linker
git clone https://github.com/cc65/cc65.git && cd cc65
make
sudo make avail
cd ..
# ROM
git clone https://github.com/commanderx16/x16-rom && cd x16-rom
make
cd ..
# Emulator
brew install sdl2
git clone https://github.com/commanderx16/x16-emulator && cd x16-emulator
make
./x16emu -rom ../x16-rom/rom.bin