x16-emulator

Emulator 49

Inspired by the retro-inspired Commodore 64 computer, the Commander X16 is emulated by x16-emulator, an open-source project by Michael Steil available in Release 48 for macOS 10.15 or later.

x16-emulator is an open-source emulator dedicated to the Commander X16, a neo-retro computer inspired by the Commodore 64 but featuring modern architecture. It accurately replicates its hardware, including the 65C02/65C816 processor, the VERA graphics card (with sprites and raster effects), audio (PCM, PSG, YM2151), and peripherals such as the SD card, keyboard, and joystick ports. The emulation is nearly cycle-accurate, ensuring optimal compatibility with software designed for the platform.

Available for macOS 10.15 and later versions, it relies on SDL2 for operation. While official binaries do not explicitly target Apple Silicon, it can run on these architectures via native SDL2. A compatible ROM (rom.bin) is required to launch the emulator, available in releases or compilable from the source repository. The tool is aimed at developers, collectors, and enthusiasts looking to explore this retro-modernist system.

Last updated:

Platforms

Computer

Architecture

Mac OS X - macOS Mac OS X - macOS Intel x86 Intel x86 Apple Silicon Apple Silicon 64-bit 64-bit SDL Library

Download and links

Version history

49
  • Ajout du support pour un système -gs avec 24 bits d’adressage RAM et un processeur 65C816, en prévision du X16 GS.
  • Correction des comportements incorrects des sprites 8bpp avec un décalage de palette non nul dans VERA.
  • Implémentation de la commande READ_MULTIPLE_BLOCK pour les cartes SD, et optimisation de MACPTR dans HostFS.
  • Correction du bruit du PSG VERA (fréquence doublée par rapport au matériel) et gestion améliorée des registres write-only/read-only.
  • Support MIDI série via FluidSynth, avec exclusion du threading dans la build Web pour éviter les conflits.
  • Débuggeur amélioré avec prise en charge du système GS et gestion des breakpoints (F9).
  • Passage à C11 avec corrections de syntaxe et de headers, et corrections des instructions MVN/MVP du 65C816.
  • Builds macOS Intel requièrent macOS 15 (Sequoia) ou supérieur, ARM/M1 requièrent macOS 14 (Sonoma) ou supérieur.

Release R49 ("Pyrite")

  • KNOWN BUGS

    • from X16EDIT, pressing Ctrl+F and then B fails to compile the program with BASLOAD. To work around the bug, exit X16EDIT back to BASIC and run BASLOAD ""
  • Features/Fixes

    • VERA: Add warnings when reading to write-only and when writing to read-only registers [irmen]
    • VERA: Make SPI busy time more true to hardware
    • VERA: Fix wrong behavior of 8bpp sprites when palette offset is nonzero
    • VERA PSG: Fix noise frequency being double that of hardware
    • SDCARD: add READ_MULTIPLE_BLOCK support [stople]
    • VIA: Fix for IFR flag handling [catharinejm]
    • Let emulator exit with Alt+F4 even if SDL does not handle it [JimmyDansbo]
    • Only free clipboard memory buffer when it comes from SDL's paste handler
    • Added serial MIDI emulation via FluidSynth
    • Exclude threading (needed for FluidSynth) in wasm build
    • Added -gs support, which implements a system with 24-bit addressable RAM and a 65C816 processor, in anticipation of the planned X16 GS with this feature. [Fulgen301]
    • Vastly improved performance of the HostFS's implementation of MACPTR
    • Added HostFS implementations of XMACPTR and XMCIOUT to mirror the CMDR-DOS implementations
    • 65C816 emulation fixes for MVN, MVP [Fulgen301, cnelson20]
    • Move from C99 to C11, some C syntax and header fixes [skeeto]
    • Additional web emulator options, including those to support CPU type and speed [JimmyDansbo]
    • Emulator debugger fixes, including support for GS, and pressing F9 a second time to clear the breakpoint
    • More changes in the ROM.

Due to the availability of GitHub runner images, the release builds published here may not work on versions of the OS older than what they were built on.

  • macOS Intel version is built on macOS 15 Sequoia (works on MacOS 15 or newer)
  • macOS ARM/M1/Apple Silicon version is built on macOS 14 Sonoma (works on MacOS 14 or newer)
  • Linux x86_64 version is built on Ubuntu 22.04 (works with glibc 2.35 or newer)

However, x16-emulator can be built from source on older versions of the OS.

48
  • Ajout du support du débogage pour les banques ROM 13 à 15 (utilisées par x16edit et Basload).
  • Correction du calcul des adresses indirectes relatives pour le processeur 65C816 (problème de page directe).
  • Mise à jour du débogueur pour afficher le temps CPU écoulé depuis le dernier point d'arrêt ou pas.
  • Prise en compte de l’inversion du rapport cyclique (pulse width) pour les ondes saw et triangle du VERA PSG (comportement conforme à la version matérielle 47.0.2).
  • Correction des lectures de débogage depuis la pile et des valeurs non bornées dans l’affichage du débogueur.

Release R48 ("Cadmium")

  • Features/Fixes
    • Emulated VERA SPI clock has been updated to half of the VERA clock speed rather than the CPU clock.
    • Trace for ROM banks 13-15 (x16edit and Basload) is now supported [stefan-b-jakobsson]
    • Fixed debug reads from the stack and a few unbounded values in the debugger display
    • VERA PSG: for the saw and triangle waves, the inverse of the pulse width value is XORed with the value of the wave. This is the behavior of VERA 47.0.2 on hardware. [m00dawg]
    • Allow setting the amount of RAM in the web version of the emulator [JimmyDansbo]
    • Windows 11: Rounded corners should no longer cut off the lower left and lower right of the emulator window.
    • New memory statistics feature [irmen]
    • HostFS: Implement DOS "T"ell command
    • Debugger now includes elapsed cpu clocks since the last breakpoint or step
    • 65C816: Fixed stack relative indirect address calulation wrongly using the direct page [Fulgen301]
    • 65C816: high bytes of .X and .Y are now cleared when PLP or RTI set x=1 [cnelson20]
    • 65C816: PEI no longer does improper page wraparound, [dp] indirect modes now properly read the address. [Fulgen301]
    • More changes in the ROM.
Release 48

No details for this version.

Reply on the forum

A question or a hands-on report? Open the discussion on the forum.

Reply on the forum