Skip to content

Installation and First Start

WacKEDmaN edited this page Oct 31, 2026 · 1 revision

Installation and first start

Download

Get the package for your system from the Releases page.

System Package
Windows (64-bit) CPCSyntaxError-win64-<version>.zip
Linux (x86_64) CPCSyntaxError-linux-x86_64-<version>.tar.gz
Linux (x86_64), Flatpak CPCSyntaxError-linux-x86_64-<version>.flatpak
macOS 10.15 or later (Apple silicon and Intel) CPCSyntaxError-macos-universal-<version>.zip

Install and start

Windows

  1. Unzip the package into a folder that you can write to (not Program Files).
  2. Run cpcse.exe.

The program keeps its settings beside cpcse.exe, so the folder must be writable.

Linux (tar.gz)

  1. Install SDL2 from your distribution, for example sudo apt install libsdl2-2.0-0.
  2. Unpack the package into a folder.
  3. Run ./cpcse.

For the LambdaSpeak 3 voices, install espeak-ng. For AAC, Ogg and other audio formats on the SYMBiFACE III, install ffmpeg.

Linux (Flatpak)

You do not unpack this package. The first install gets the freedesktop runtime from Flathub:

flatpak remote-add --user --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
flatpak install --user CPCSyntaxError-linux-x86_64-<version>.flatpak

Then start CPCSyntaxError from your applications menu. The Flatpak keeps its settings, screenshots and ROM folder in ~/.var/app/io.github.wackedman.CPCSyntaxError/data/cpcsyntaxerror. It can open files in your home folder.

macOS

  1. Unzip the package.
  2. Keep CPCSyntaxError.app in a folder that you can write to. The app keeps its settings inside itself.
  3. The app has no Apple Developer ID signature. The first time, right-click CPCSyntaxError.app, select Open, then select Open again.

The ROMs

The firmware ROMs of the CPC 464, 664, 6128 and the Plus, and the GX4000 system cartridge, are in the roms folder of the package. Amstrad gave permission to distribute them. Amstrad keeps the copyright.

The program looks for the roms folder beside itself. To use another folder, select File → ROM folder..., or start the program with --roms <folder>.

The program finds each ROM by a word in its file name. Upper and lower case are the same.

For The file name must contain
CPC 464 464 OS, 464 BASIC
CPC 664 664 OS, 664 BASIC, AMSDOS
CPC 6128 6128 OS, 6128 BASIC, AMSDOS
464 Plus, 6128 Plus 6128+ OS, 6128+ BASIC; the 6128 Plus also Plus A2 (its AMSDOS 0.7). Without them, the system cartridge.
GX4000 burning rubber (the system cartridge, a .cpr file)
M4 Board M4ROM (included, with permission from Duke)
Multiface II multiface (not included)
OPL4 General MIDI samples yrw801 (not included: the program asks for it)
SSA-1, dk'tronics, LambdaSpeak 3 speech sp0256-al2.bin, 2 KB (not included: the program asks for it)

When a device needs a ROM that is not in the folder, a box asks for it. You can choose a file on your computer, or paste a download address that you know. The program does not have download addresses of its own.

The first start

  • The first start uses a CPC 6128. To use another machine, select Machine → Model.
  • At the start, these windows are open: the Screen, Machine and ROMs windows, and the media windows (Discs, Tape, Cartridge, Snapshot) as tabs. Open the other windows from the menus.
  • To load software, use the File or Media menu, or drop a file on the window. The program knows each type by its file extension. Refer to Discs and the DSK editor, Tapes, Cartridges and CRO files and Snapshots, save slots and the timeline.

Run a disc

  1. Drop a .dsk file on the window, or select Media → Drive A → Insert....
  2. Type CAT and press Enter to see the files.
  3. Type RUN"NAME and press Enter. Use |CPM for a CP/M disc.

Run a tape

  1. Drop a .cdt file on the window, or select Media → Tape → Insert tape....
  2. On a 664 or 6128, type |TAPE and press Enter first. (Type | with Shift and the key @.)
  3. Type RUN" and press Enter. Press any key at "Press PLAY then any key". The deck presses PLAY for you.

The settings go into cpcse.ini, and the window layout into cpcse_layout.ini. Refer to Settings, files and folders.

Clone this wiki locally