Clemens IIgs
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.
Last updated:
Platforms
Architecture
Mac OS X - macOS
Apple Silicon
64-bit
Download and links
- Download Clemens IIgs
- Official website
- Source code 70 GitHub stars
- License : MIT
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.exebinary in a folder with a 256K ROM 3 binary namedgs_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
ImGuito1.88andfmtto9.1.0sokolto latest
0.3
- Ajout du support officiel des cartes Apple IIgs et Mockingboard C (mais désactivé en attente d’interface utilisateur dédiée).
- Prise en charge de Super Hi-res et du démarrage de ProDOS 16 vers le Finder.
- Support des disquettes 2MG (3,5 pouces et 5,25 pouces) avec commandes DO, PO et DSK pour le chargement/sauvegarde.
- Amélioration du support du haut-parleur Apple II (fonctionnement toujours imparfait mais corrigé en partie).
- Boot fonctionnel de jeux Apple II 128K comme Nox Archaist et compatibilité avec Tower of Myraglen via Ensoniq.
The "G" and "S" in an Apple IIgs. Also included Mockingboard C support, but this is currently disabled in code within the host application since there's no GUI to toggle Mockingboard card insertion and removal.
Note: ROM 03 is the only ROM currently supported. ROM 1 is on the roadmap.
A lot of Apple II titles work. Mockingboard is limited to the patched Ultima IV release. Mockingboard + IIgs has issues as documented in various online sources due to IIgs ROM implementation. A better fix would be to support an Apple //e ROM + IIgs machine architecture which should be possible.
- Super Hi-res mode and ProDOS 16 boot to finder
- 2MG 3.5 and 5.25" support
- DO, PO and DSK Load and Save
- Mockingboard C without SSI-223 (voice) support (Patched re-mastered Ultima IV)
- Improved Apple II Speaker support (still flawed but better)
- Boots Nox Archaist and various Apple II 128K games
- Ensoniq support - boots Tower of Myraglen
Reply on the forum
A question or a hands-on report? Open the discussion on the forum.