Skip to content

The Interface

WacKEDmaN edited this page Nov 16, 2026 · 2 revisions

The interface

Windows and docking

  • Each part of the program is a window: the Screen, the Machine, the media windows, the debugger windows, the tools.
  • The windows dock and change size. Drag a window by its title or tab to dock it in another place, or out of the main window (it then becomes a window of its own, which you can put on another display).
  • A window that you open for the first time docks with its group: the debugger windows to the right of the screen, the tools below it.
  • Window → Reset layout puts back the default layout.
  • Window → Interface size makes the text and controls larger or smaller (90% to 200%).
  • Window → Status bar shows or hides the status bar. The status bar shows the last message (for example "Loaded game.dsk"), the speed and the frame rate.

The menus

Menu What it has
File Open (disc A/B, tape, cartridge, snapshot, assembler source, BASIC text), Quick save, Quick load, Undo the last load, Save snapshot, Save screenshot, Record, Recent files, Run CSL script, ROM folder, Exit
Machine Model, RAM, Video chips (CRTC, Gate Array), Z80, ROMs, Reset, Pause, Unlimited speed, Speed, Movie
Media Save disc and tape writes to their files, Drive A, Drive B, Tape, Cartridge, Snapshot
Video The monitor, the tube, the renderer, scaling, the CRT effect, the Advanced CRT Filter, the GFX9000 monitor
Audio Sound on or off, the volume, each sound source, machine noises, the printer-port DAC
Input The keyboard layout, the on-screen keyboard, joysticks and buttons, the mouse interface, the lightgun, the Plus analogue port
Expansions M4, Multiface II, RS232C, Symbiface / X-MASS, HD20, printer port, GFX9000, sound cards, speech, OPL4
Tools DSK editor, Cheats, Graphics finder, CRO editor, CSL scripts, Printer output, GFX9000, Assembler, BASIC
Debug Debugger windows, steps, breakpoints, the raster timing overlay, External debugging
Window The windows, Media, Settings, Interface size, Status bar, Reset layout
Help Keyboard shortcuts, About

The Video, Audio, Input and Expansions menus have the same settings as the Settings windows (Window → Settings: Video settings, Audio settings, Input settings, Expansions, External debugging). Use the one that you like.

The Screen window

  • The Screen window shows the CPC's picture. With a GFX9000 fitted, it can also show the GFX9000's picture beside it (refer to GFX9000).
  • Double-click the picture, or press F11, for full screen. Press F11 or double-click again to go back.
  • Video → Full screen: the picture only: full screen shows only the picture, with no menus or windows.
  • A click on the picture gives the mouse to the emulated mouse (Symbiface or mouse interface). F12 or the middle mouse button gives it back.
  • When the machine is paused, the picture shows PAUSED (or the reason for the stop, for example a breakpoint).

The file picker

  • The file picker shows all the drives (C:, D: and more on Windows). You can type a folder name or a full path in it.
  • It remembers the last folder for each type of file.
  • File names with accents, CJK characters and emoji open (Windows 10 version 1903 or later).
  • You can also drop a file on the main window. The program loads it by its extension: .dsk, .edsk, .hfe, .ipf (disc), .cdt, .tzx, .tap, .wav (tape), .cpr, .cro (cartridge), .sna (snapshot).

Recent files

File → Recent files lists the last 12 discs, tapes, cartridges and snapshots. Clear the list empties it.

Themes

Window → Settings → Colours and themes sets the colours of the interface.

  • Every Dear ImGui colour (in groups: text, windows, frames, buttons, tabs and more) and the program's own colours (the accent, the debugger's PC line, good, bad, warning, information).
  • Five themes are included. The default is the look the program always had.
  • Save as a theme file... and Load a theme file... keep your own themes as .cpctheme files. Undo the changes goes back to the theme chosen.

The command palette

Ctrl+Shift+P (or Help → Command palette) opens a box at the top. Type part of a command's name (the words in any order), choose with the Up and Down keys, and press Enter. It has the machine, the media, the snapshots and slots, the debugger, the assembler and every window.

Copy the screen

Ctrl+Shift+C (or File → Copy the screen to the clipboard) puts the CPC's picture on the clipboard. On Windows it is a picture; on other systems a PNG is saved and its path is put on the clipboard.

Pause, reset and speed

  • Machine → Pause (Ctrl+P) stops or starts the machine.
  • Machine → Reset (Ctrl+R) resets it, as the reset of a real CPC (power off and on).
  • Machine → Speed: 25%, 50%, 100%, 200% or 400%. Unlimited speed runs as fast as your computer can.

Clone this wiki locally