AMSpiriT Lite — Kurzreferenz

AMSpiriT Lite ist ein Linux-Amstrad-CPC-Emulator, der auf dem AMSpiriT-Kern von David MANUEL basiert.

Steuertasten

Taste	Aktion
`F1`	Diese Hilfe im Browser öffnen
`F2`	PNG-Screenshot im aktuellen Verzeichnis speichern
`Shift`+`F4`	Snapshot (.sna) im aktuellen Slot speichern
`Ctrl`+`F4`	Snapshot aus dem aktuellen Slot laden
`Ctrl`+`0` bis `Ctrl`+`9`	Zum Snapshot-Slot 0–9 wechseln (persistente Speicherung)
`Ctrl`+`E`	BASIC-Programm aus RAM exportieren (detokenisieren)
`F7`	Lautstärke verringern (-10 %)
`F8`	Lautstärke erhöhen (+10 %)
`F9`	Turbo-Modus ein-/ausschalten (volle Geschwindigkeit, Audio stumm)
`F10`	Kalt-Reset (Cold Boot)
`Shift`+`F10`	Warm-Reset (Warm Restart)
`F11`	Bildschirmtypen durchschalten (Farbe, Grünmonitor, ASIC-Varianten)
`Shift`+`F11`	FPS-Anzeige ein-/ausblenden
`Ctrl`+`F11`	CRTC-Debug-Visualisierungsmodi durchschalten
`F12`	Vollbild / Fenstermodus umschalten
`Shift`+`F12`	Ansicht umschalten: sichtbarer CPC-Bildschirm ↔ vollständiger CRTC-Rahmen
`Pause`	Emulation pausieren / fortsetzen
`Ctrl`+`O`	Dateiauswahldialog öffnen
`Alt`+`F4`	Fenster schließen (vom Fenstermanager verwaltet)
`Esc`	Beenden (nur wenn die Emulation pausiert ist)
`Ctrl`+`1` bis `Ctrl`+`0`	CPC-Ziffernblock 1–0 (für Laptops ohne Nummernblock)

Dateien laden

Ziehen Sie eine Datei auf das Emulatorfenster, um sie zu laden, oder verwenden Sie Ctrl+O für einen Dateidialog (erfordert zenity oder kdialog).

Tipp: Halten Sie Ctrl gedrückt, während Sie eine Datei ablegen, um vor dem Laden einen Kalt-Reset durchzuführen — nützlich, um ein Disk-Image in einem sauberen Maschinenzustand zu starten.

Format	Beschreibung
`.dsk`	Standard-Disk-Image
`.hfe` / `.ipf`	High-Fidelity-Disk-Image (CAPS)
`.cdt` / `.wav`	Kassette (CDT oder WAV-Audio)
`.sna`	Snapshot (gespeicherter Zustand)
`.cpr`	CPC Plus / GX4000 Cartridge — wechselt automatisch zum CPC 6128+-Modell und CRTC-Typ 3

Turbo-Modus

Der Turbo-Modus deaktiviert den 50-Hz-Takt und schaltet das Audio stumm, sodass der Emulator mit voller CPU-Geschwindigkeit läuft. Nützlich, um lange Kassettenladezeiten oder Intros zu überspringen.

Drücken Sie F9, um den Turbo-Modus jederzeit ein- oder auszuschalten.
Bei Start mit --turbo zusammen mit --autotype oder -A stoppt der Turbo automatisch, wenn die automatische Tippsequenz abgeschlossen ist.

Joystick

USB-Joysticks werden beim Start und beim Anschließen automatisch erkannt. Der erste gefundene Joystick wird dem CPC-Joystick-Port 1 zugeordnet.

Taste	CPC-Aktion
Taste 0	Feuer 1
Taste 1	Feuer 2
Taste 2	Feuer 3
Taste 3 / Start	Emulation pausieren / fortsetzen
LB (linke Schultertaste)	Snapshot schnell speichern im aktuellen Slot
RB (rechte Schultertaste)	Snapshot schnell laden aus dem aktuellen Slot
Achse X / Y oder Hat	Richtungen (oben, unten, links, rechts)

Web-Debug-Server

Beim Start mit --web-ui startet der Emulator einen lokalen HTTP-Server, der eine Debug-Schnittstelle im Browser bereitstellt: Z80-Register, Gate Array, PSG, FDC, FPS und Steuerungen (Pause, Reset, Modellwechsel).

amspirit-lite-sdl --web-ui [--web-addr 0.0.0.0] [--web-port 8765] [--web-html Pfad/zur/ui.html]

Option	Beschreibung
`--web-ui`	Server aktivieren (standardmäßig deaktiviert)
`--web-addr <Adresse>`	Bind-Adresse (Standard: `127.0.0.1` — nur lokal; `0.0.0.0` für alle Schnittstellen)
`--web-port <Port>`	Listening-Port (Standard: `8765`)
`--web-html <Datei>`	Pfad zur HTML-UI-Datei (Standard: `amspirit-lite.html` neben der Binärdatei)

Die Datei amspirit-lite.html kann ohne Neukompilierung bearbeitet werden. Falls sie fehlt, wird die in der Binärdatei eingebettete UI als Fallback verwendet.

Tastaturbelegung

Die CPC-Tastaturbelegung wird beim Start über die Option --lang ausgewählt. Verfügbare Belegungen:

Wert	CPC-Tastaturbelegung
`FR`	Französisch (AZERTY)
`EN` / `UK`	Englisch (QWERTY, Großbritannien)
`US`	Englisch (QWERTY, USA)
`ES`	Spanisch
`GE`	Deutsch (QWERTZ)
`IT`	Italienisch
`DA`	Dänisch

AltGr: Die AltGr-Taste wird abgefangen und nie an den CPC weitergeleitet. AltGr-Zeichen (|, {, }, ~, @, …) erreichen den Emulator direkt über ihr SDL-Sym.

Befehlszeilenoptionen

amspirit-lite-sdl [OPTIONEN] [DATEI]

Emulation

Option	Beschreibung
`-m <Modell>`	CPC-Modell: `464`, `664`, `6128` (Standard), `6128+`, `464+`, `GX4000`
`-c <Typ>`	CRTC-Typ (0 bis 4)
`-R <Pfad>`	ROMs-Verzeichnis (Standard: `./ROMs`)
`-C <Pfad>`	Konfigurationsverzeichnis (Standard: `./config`)
`-k <Layout>` / `--keyboard <Layout>`	Tastaturbelegung wählen: FR, EN, US, ES, DA, DE, IT, PT, BE, SW, CA (Standard: FR)
`-F`	Im Vollbildmodus starten
`-Z` / `--turbo`	Im Turbo-Modus starten (volle Geschwindigkeit)

Automatisches Laden

Option	Beschreibung
`-A` / `--autorun`	Tippt automatisch `RUN"` nach dem Start, um das erste Programm zu starten
`-T <Name>` / `--run <Name>`	Tippt automatisch `RUN"<Name>` beim Start
`-t <Datei>` / `--autotype <Datei>`	Tippt den Inhalt einer Textdatei nach dem Start in den CPC
`--basic <Datei>` / `-b <Datei>`	Ein Locomotive-BASIC-Programm tokenisieren und in RAM injizieren (~3s nach dem Start)

Audio und Anzeige

Option	Beschreibung
`-L <ms>` / `--audio-latency <ms>`	Audio-Puffer-Latenz in Millisekunden (Standard: 80 — erhöhen bei Audioknistern)
`--show-overlay`	FPS-Anzeige in der oberen linken Ecke einblenden (rot = zu langsam, blau = zu schnell)

Web-Debug-Server

Option	Beschreibung
`--web-ui` / `--web-server`	HTTP-Debug-Server aktivieren (standardmäßig deaktiviert)
`--web-addr <Adresse>`	Bind-Adresse (Standard: `127.0.0.1`)
`--web-port <Port>`	Listening-Port (Standard: `8765`)
`--web-html <Datei>`	Pfad zur Debug-UI-HTML-Datei

Verschiedenes

Option	Beschreibung
`-K`	Ausführliche Tastatur-Debug-Ausgabe aktivieren
`--dump-keymap`	Eine Referenz-`keymap.cfg`-Datei basierend auf dem aktuellen Layout generieren und auf stdout ausgeben
`-X <Sekunden>`	Nach N Sekunden automatisch beenden (automatisierte Tests)

Tastenbelegung konfigurieren (keymap.cfg)

Generieren Sie eine keymap.cfg-Datei mit der Option --dump-keymap, bearbeiten Sie sie nach Ihren Wünschen und starten Sie den Emulator neu:

amspirit-lite-sdl --dump-keymap > keymap.cfg

Platzieren Sie die generierte keymap.cfg-Datei in Ihrem Verzeichnis ROMs/ oder config/. Die Datei verwendet INI-Format mit zwei Abschnitten: [keyboard layout] und [emulator hotkeys].

Unterstützte Tastenkombinationsaktionen: PAUSE, HELP, SCREENSHOT, SNAPSHOT_SAVE, SNAPSHOT_LOAD, BASIC_EXPORT, VOLUME_UP, VOLUME_DOWN, FULLSCREEN, MONITOR_TYPE, CRTC_SELECT, VISIBLE_FRAME

Tastaturformat: Einzelne Taste (F1, A, Escape, Return, Space) oder Modifizierer (Ctrl+X, Shift+F1, Alt+Shift+P). Groß-/Kleinschreibung wird ignoriert.

Änderungen werden beim Neustart wirksam. Um den Code einer Taste zu finden, starten Sie den Emulator mit -K und suchen Sie nach DOWN-Meldungen in der Konsole. Hinweis: SDL- und Qt-Anwendungen verwenden unterschiedliche Tastencodes; verwenden Sie separate Keymap-Dateien für jede, wenn Sie beide ausführen.

AMSpiriT-Kern von David MANUEL — Linux-Port von Siko — amspirit.fr