Clemens is an Apple IIgs emulator for macOS (Catalina or later), Linux and Windows 10.
It runs most IIgs software under a ROM 3 compliant backend. It also aims to provide a solid
frontend for both users and developers.
NOTE This software is in late Alpha. A variety of bugs have been fixed in the latest version. While this software will run most IIgs software, features like serial communication, printers and internationalization are currently planned but unfinished.
There is a work-in-progress manual
Please refer to the list of Missing Features for details.
- Standard Apple IIgs and IIx video modes
- ROM 3 up to 8MB
- Ensoniq, Mockingboard C (without SSI voice) and A2 speaker audio
- WOZ 2.0, 2IMG, PO, DO and DSK support
- 5.25", Apple 3.5" and hard drive emulation
- Joystick/Gamepad support
- Passes Self-Diagnostic Tests
- Load and save machine snapshots
- Instruction level debugging
- Breakpoints on execution at, read from or write to an address
- Break on IRQ
- Execution trace output and export
- Memory bank dump to file
See the Releases page for the latest release.
Download and mount the DMG to copy Clemens IIGS into your Applications folder.
There is a 64-bit .deb for Debian or Ubuntu 20.04 systems.
# On Ubuntu 20.04 or later, download the .deb file, copy it to a directory and run (for example, version 0.6.0):
sudo apt install ./Clemens_IIGS-0.6.0-linux-x64.deb
There's an build script for the flatpak binary. Detailed instruction on what is Flatpak or how to use it are beyond the scope of this doc. If new to Flatpak refer to the linked page.
Building from source may be the best option on Linux if running on older Ubuntu distribution, or another disto like Manjaro/Arch, etc.
A single Windows 64-bit executable is available. You will receive a SmartScreen warning since this executable is not code-signed with a certificate (this is free software, developed by a single developer, and not a corporation, during his spare time.)
Simply select 'More Info' and 'Run Anyway' if your security policy (and personal comfort level) allows for running untrusted applications.
This is always an option instead of installation if you have the prerequisites on your machine.
All platforms require CMake 3.15 or later.
Requires Xcode 12 or later.
# For debug builds
cmake -B build -S . -DCMAKE_BUILD_TYPE=Debug
cmake --build build --config=Debug
# For Release builds
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --config=Release
The following packages must be installed to successfully build the binary.
- GCC version 8 or later
- libx11-dev
- libxcursor-dev
- libxi-dev
- mesa-common-dev
- libasound-dev
- uuid-dev
Inside the project directory execute the following.
cmake -B build -DCMAKE_BUILD_TYPE=<Debug|RelWithDbgInfo|Release> -DBUILD_TESTING=OFF
cmake --build build --config <Debug|RelWithDbgInfo|Release>
cp build/host/clemens_iigs <your_selected_install_directory>
Requires Visual Studio 2019 or later. Optionally you may run these commands in a Developer Prompt if CMake does not detect your compiler from a regular Command Prompt.
Inside the project directory execute the following.
cmake -B build -DBUILD_TESTING=OFF
cmake --build build --config <Debug|RelWithDbgInfo|Release>
cp build-run/clemens_iigs/<Config>/clemens_iigs.exe <your_selected_install_directory>
They are welcome. Refer to the repository issue list for details.
This project is not entirely novel as there are finished emulator projects like KEGS and MAME.
I've open-sourced this project for exposure. Contributions are welcome if they are made.
The best ways to run Apple IIgs software are:
- From a legitimate upgraded Apple IIgs with a Floppy Emu
- A KEGS port available on MacOS or Linux (Windows ports are available though some haven't been updated in a while - GSPort, GSPlus, etc.)
- MAME in the browser https://archive.org/details/softwarelibrary_apple2gs
- Clemens - it's catching up!
External libraries referenced below are used by the host project (the debugging front-end.) The actual Clemens emulator backend does not have any dependencies beyond the C standard library and the two listed dependencies included in the project.
All projects below have permissive enough licenses (MIT, BSD, Apache) to be distributed by this project.
- mpack : A single source file MessagePack implementation written in C in the
externalfolder used for serialization of a machine - unity : A C testing framework
- stb_truetype.h For font rendering
- Fonts From Kreative Korp for 40/80 column text
- Dear ImGui A well-known IMGUI C++ library
- Dear ImGui Markdown ImGui Markdown Implementation
- Sokol A cross-platform minimal rendering backend
- fmt A minimal std::format implementation
- doctest A minimal C++ single-header testing framework
- miniz A Zlib compliant single file library with PNG write support
- inih A minimal C based INI file parser
- json Used for test serialization
See LICENSE.txt (MIT)