gitwtfhub

wtf is appleiigs?

burnermcburnface33/appleiigs — explained in plain English

Analysis updated 2026-05-18

0C++Audience · developerComplexity · 4/5LicenseSetup · hard

TL;DR

An iOS app that emulates the Apple IIGS and Apple II computers with a sharp custom renderer and a full set of touch controls, for playing old software on iPhone or iPad.

Mindmap

mindmap
  root((AppleIIGS Emu))
    What it does
      Emulates Apple IIGS
      Emulates Apple II
      Runs on iPhone and iPad
    Tech stack
      SwiftUI
      Metal renderer
      KEGS core
    Use cases
      Load disk images
      Use touch controls
      Connect controllers
    Audience
      Retro computing fans
      iOS developers
    Setup
      Needs Xcode and XcodeGen
      Requires own IIGS ROM

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Run classic Apple IIGS and Apple II software on an iPhone or iPad.

REASON 2

Import your own disk images through the Files app to load onto the emulator.

REASON 3

Use physical Bluetooth game controllers or onscreen touch controls to play old games.

REASON 4

Switch between color, green, and amber display modes to mimic period-correct monitors.

What's in the stack?

C++SwiftSwiftUIMetalXcodeGen

How it stacks up

burnermcburnface33/appleiigsachanana/mavsdkalange/llama.cpp
Stars00
LanguageC++C++C++
Last pushed2024-05-20
MaintenanceDormant
Setup difficultyhardmoderatemoderate
Complexity4/54/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Requires a Mac with Xcode and XcodeGen, an Apple Developer account for signing, and your own legally obtained IIGS ROM file.

Built on the KEGS emulator core, so redistributing it means checking that project's license terms, the app itself doesn't ship any ROMs or copyrighted software.

Wtf does this do

This project is an iPhone and iPad app that emulates the Apple IIGS, and the earlier Apple II, so you can run old software from those computers on a modern touchscreen device. It builds on an existing emulator engine called KEGS, with additions from a project called ActiveGS, and wraps it in a native Apple app made with SwiftUI. Rather than reuse the original emulator's graphics output as is, the author wrote a new renderer from scratch that reads the Apple II's own memory directly, so text and graphics come out sharp instead of blurry on a phone screen. The emulated machine supports six virtual disk drives covering both older 5.25 inch floppy disks and later 3.5 inch and hard disk style storage, and it boots the IIGS's own ROM firmware. The app leans heavily into making an old computer usable with just your fingers: it offers seven different touch input modes, including a virtual keyboard, joystick, D-pad, and even using the whole touchscreen as a mouse trackpad. It also includes save states so you can pick up where you left off, options for different screen colors like green or amber to mimic old monitors, and support for physical Bluetooth game controllers. To build the app yourself you need a Mac with Xcode and a tool called XcodeGen, which generates the actual Xcode project from a configuration file. The README warns that the very first build compiles the entire emulator core and is slow, while later builds are faster. Neither the Apple IIGS ROM file nor any disk images or software are included. You must supply your own and are responsible for making sure you are legally allowed to use them. The author describes this as a personal hobby project offered as is, with no warranty, and states it is not affiliated with Apple. It is meant for people interested in exploring or reliving classic Apple II and IIGS computing on an iOS device.

Yoink these prompts

Prompt 1
Walk me through building and running this Apple IIGS emulator on my own Mac using the steps in this README.
Prompt 2
Explain how the custom renderer described in this README avoids the blurriness of the original KEGS output.
Prompt 3
Help me understand what ROM file this app needs and where the README says to place it.
Prompt 4
Summarize the seven touch input modes this README describes and what each one is meant for.

Frequently asked questions

wtf is appleiigs?

An iOS app that emulates the Apple IIGS and Apple II computers with a sharp custom renderer and a full set of touch controls, for playing old software on iPhone or iPad.

What language is appleiigs written in?

Mainly C++. The stack also includes C++, Swift, SwiftUI.

What license does appleiigs use?

Built on the KEGS emulator core, so redistributing it means checking that project's license terms, the app itself doesn't ship any ROMs or copyrighted software.

How hard is appleiigs to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is appleiigs for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.