Clemens IIgs

Emulator 0.6

Clemens IIgs is an Apple IIGS emulator developed by Samir Sinha, available in version 0.6 and requiring at least macOS Catalina to run on Mac.

This software no longer receives updates. Its last known release dates from August 18, 2023. Check that it still works with your version of macOS.

Clemens IIgs is an emulator dedicated to the Apple IIGS, a retro machine from the late 1980s. Developed by Samir Sinha, it primarily targets users looking to explore or develop on this platform, with a programming-oriented interface rather than a consumer-friendly one. While functional on recent macOS (from Catalina onward), it remains in development, with key features such as SmartPort disk emulation or serial communication still missing.

Its technical approach, documented via a README and embedded documentation, makes it a suitable tool for enthusiasts or developers. Successive updates have improved debugging and compatibility with peripherals like joysticks, but some iconic features (such as ROM 01 support) are yet to be implemented. An evolving project, ideal for demanding users.

Screenshot animé de Clemens IIGS
Fenêtres dans Clemens IIGS

Last updated:

Platforms

Architecture

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

Download and links

Version history

0.6
  • Nouveautés majeures : ajout du mode d’affichage écran plein écran (maximisé) et du débogueur en développement.
  • Améliorations matérielles : support de l’émulation double disque sur le Slot 7 et prise en charge des manettes de jeu.
  • Performances : mode d’émulation accélérée et correction des temporisations horloges (28 MHz) pour une meilleure stabilité.
  • Compatibilité macOS : support officiel de macOS Catalina et supérieur, avec amélioration du suivi de la souris en mode GS/OS.
  • Corrections techniques : fixes des registres I/O, du bus flottant Apple II, et des mécanismes de copie de protection des disquettes IWM.
  • Stabilité : amélioration de la gestion des snapshots et correction des problèmes liés à l’ADB et aux modes graphiques 80 colonnes.

This release should be considered an alpha product. Significant feature and overall stability improvements have been made in this version.

All future versions will maintain snapshot capability with this version.. Version 0.5 and earlier snapshots are no longer supported.

Installation Notes

See Installation in the README for details.

The MANUAL.md contains more detailed instructions on using the emulator.

  • Windows 10 or later required - Users will likely run into SmartScreen warnings as this is not a signed executable
  • macOS Catalina or later
  • Linux 64-bit - Tested under Ubuntu 20.xx (.deb file) and Manjaro (source build.)

New Features

For a complete list of changes see the CHANGELOG.md

  • Maximized / non-debugger screen view mode added
  • macOS Catalina support
  • Dual hard drive emulation on Slot 7
  • New Debugger Screen (WIP)
  • Gamepad support
  • Fast emulation mode
  • Mouse tracking on the host desktop under GS/OS
  • All Self-Diagnostic tests pass

Fixes

  • Improved performance
  • Better emulation of Apple II graphics modes
  • Cycle timings based on the 28mhz IIgs clock
  • IWM 3.5" disk emulation improvements to support more copy protection mechanisms and disk switching
  • Apple II style floating bus
  • Various I/O register fixes
  • Shadowing and 80COLSTORE fixes
  • ADB keyboard handling improvements
  • Disabled s2d1 IWM Smartport
  • Snapshot stability

Known Issues

  • No 640 mode dithering
  • ROM 1 not supported
  • SCC only implemented to pass self-diagnostic (i.e. no practical use.)
  • No ethernet, printers.
  • Mockingboard VIA implementation is inefficient
  • Textfunk demo does not work
  • Ninjaforce demo does not work (No bit 16 address shadowing)

Tested Software

  • Various titles from the "What is the Apple IIgs" launcher
  • GS/OS System Software 6.0.1, 6.0.4
  • ProDOS 8/16
  • Where in the World is Carmen Sandiego (IIgs)
  • California Games
  • Kings Quest I, IV
  • Space Quest I
  • Thexder
  • Silpheed
  • Rastan
  • Ultima IV remastered
0.5
  • Ajout du support SmartPort 32 MB sur le port disque (slot virtuel 2, périphérique 1).
  • Intégration du support manette/joystick pour Windows (via DirectInput) et Linux.
  • Correction d’un bug ADB permettant d’ouvrir le Control Panel avec Ctrl+RightAlt+F1.
  • Séparation des APIs Apple IIGS et du noyau émulateur 65816 en bibliothèque dédiée.
  • Amélioration du reporting du statut de spindle pour les disques IWM.
  • Ajout de mappage clavier Linux pour les combinaisons Alt-Fn.

This should be considered a pre-release/alpha product.

Included in this release is Gamepad/Joystick support for both Windows and Linux, SmartPort 32MB hard drive support (running from the disk port vs Slot 7) and various emulator library API improvements.

Major IIGS features still missing include fask disk emulation, serial communication (Zilog SCC emulation) and ROM 01 support.

GSOS System 6.0.4 boots to the finder. Many games work with mouse support. There's a small glitch related to vertical refresh rate and the mouse pointer which may become obvious after starting at the screen for a while.

For missing features or documentation questions, feel free to enter issues.

See the README for details on features, build and usage instructions.

Abbreviated instructions - for Windows, drop the clemens_iigs.exe binary in a folder with a 256K ROM 3 binary named gs_rom_3.rom. The executable is not signed so you'll want to follow the usual instructions for running untrusted binaries. Linux builds currently should be built from source per the instructions in the README.

The Wiki is currently light. Eventually it will contain everything that's currently in the Documentation Folder.

Version 0.6 will contain fast disk emulation, ROM 01 and general usability improvements.

Changelog

  • SmartPort 32MB Hard Drive on the disk port, virtual slot 2, drive 1
  • Gamepad and Joystick support on Windows (DirectInput) and Linux
  • ADB fix allowing Ctrl-RightAlt-F1 to trigger the Control Panel
  • IWM properly report spindle status on each drive
  • Linux key mapping to support Alt-Fn key combinations
  • Decouple Apple IIGS device types and APIs from the 65816 emulator library into its own library
    • Moved some graphics mode bitmap rendering into the library
    • Added register set commands in the debugger

Dependencies

  • ininh (INI parsing) added to host
0.4
  • Interface de débogage entièrement repensée avec un affichage des diagnostics amélioré.
  • Système de gestion des images disque (importation, sauvegarde, chargement) avec support des fichiers WOZ.
  • Support natif de la souris pour GS/OS, permettant à de nombreux jeux de fonctionner.
  • Correction du rendu Super Hires pour une précision des couleurs accrue.
  • Correction d’un bug dans l’émulation du synthétiseur Ensoniq (compatibilité avec Neuromancer).

This should be considered a pre-release/alpha product.

Included in this release is a revamped debugger GUI, improved title support, mouse events and Linux builds. The Apple //e side is mostly complete. The IIgs features are almost there with a few missing features: Smartport support being the major piece. Serial (the SCC) is also missing.

GS/OS 5 boots to the finder. Many games work with mouse support. There's a small glitch related to vertical refresh rate and the mouse pointer which may become obvious after starting at the screen for a while.

See the README for details on features, build and usage instructions. For missing features or documentation questions, feel free to enter issues.

Version 0.5 will likely contain Smartport support and be released by the end of the year.

CHANGELOG:

  • New Debugger GUI and improved diagnostics display
  • New Disk Import/Save/Load system for disk images (save/load as WOZ image)
  • Mouse Support
  • Lores and Double Lores Support
  • Linux Builds with GCC using OpenGL for Rendering
  • Fixed Super Hires Renderer to display correct colors
  • Ensoniq fix that didn't account for the default voice (Neuromancer music plays)
  • Fixed confusion between INTCXROM and SLOTROMSEL switches
  • IRQs in native mode were firing the emulated IRQBRK vector
  • Incorrect sync timing lead to invalid Vertical and Horizontal VGC counters
  • Corrected BIT immediate flag manipulation
  • Fixed 3.5" drive emulation disk-in-place query value (allowing GS/OS to boot)
  • Flashing Text
  • List toolbox calls in program trace
  • Updated dependencies
    • ImGui to 1.88 and
    • fmt to 9.1.0
    • sokol to latest

Reply on the forum

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

Reply on the forum