← All tools

Aiie

An Apple //e emulator for the desktop. The same emulator that runs on a Teensy handheld, now on your Mac, Windows, or Linux box.

Download

Desktop app. Installs once, then keeps itself up to date.

Desktop app
macOS (Apple Silicon).dmg macOS (Intel).dmg Windows.exe Linux.AppImage

Every release, with notes, is on GitHub. The emulator core is open source at JorjBauer/aiie.

Current versionv0.1.1

About Aiie

Aiie started in 2017 as an Apple //e emulator written from scratch for the Teensy microcontroller, small enough to run on a battery in a handheld case. This is that same core, compiled to WebAssembly and wrapped in a desktop app, so it runs the same everywhere.

Two Disk II drives and two hard drives, reading and writing WOZ, DSK, NIB, and hard drive images in place. An Epson FX-80 printer that prints to a scrolling paper roll you can save as PNG. A Mockingboard for sound, a mouse card, and an Uthernet II card that gets the //e onto your real network. Save and restore the whole machine. Disk drive sounds recorded from a real Disk II.

For programmers: a full debugger window with breakpoints, watchpoints, stepping, a hex editor over all 64K and every bank, disassembly with symbols, and a trace.

No disk images are included. Bring your own.

Status: Early release. The Mac build gets the most use; the Windows and Linux builds are newer and have had less testing. Bug reports are welcome at info@whimology.com.

The Mac build is signed and notarized. Windows and Linux builds aren't signed, so Windows will warn the first time.

First-time install help (macOS / Windows / Linux)

macOS

Open the .dmg and drag Aiie to Applications. The app is signed and notarized, so it opens without any Gatekeeper workaround.

Not sure which build you need? Choose About This Mac from the Apple menu. A Chip line that says Apple M-something means Apple Silicon; a Processor line that says Intel means Intel. The wrong one still runs (Rosetta handles the Intel build on Apple Silicon) but the right one is faster.

Windows

Running the .exe shows a blue SmartScreen dialog: “Windows protected your PC”. The installer isn't signed with an Authenticode cert.

  1. Click More info at the top of the dialog.
  2. A Run anyway button appears below the message; click it.

Linux

AppImage just needs the executable bit:

  1. chmod +x Aiie-*.AppImage
  2. ./Aiie-*.AppImage

If you see a sandbox error on older distros, add --no-sandbox.

Updates and betas
  • Automatic updates: Aiie checks GitHub for a new release a few seconds after it starts. A new one downloads in the background, you're told once it's ready, and it installs the next time you quit. Help → Check for Updates... checks right now.
  • Betas: By default only full releases are offered. Turn on Help → Use Beta Updates to get prereleases too.
  • Manual: Every build is attached to its release on GitHub. Installing over the old version keeps your settings and mounted disks.
Getting started
  • Disks: File → Insert Disk 1... mounts an image, or drop one on the window. Images are read and written in place, so keep a copy of anything you care about.
  • Reset: Ctrl+Alt+Delete is a warm reset. Ctrl+Alt+Cmd+Delete (Win on Windows and Linux) is a cold reboot that ejects the disks. Backspace works in place of Delete on keyboards without one.
  • Open and closed apple: the left and right Alt (Option) keys.
  • The BIOS: Ctrl+Cmd+Escape (Ctrl+Win+Escape) opens the same setup screens the handheld has. Everything in it is also in the menu bar.
  • Debugger: Machine → Debugger... opens it in its own window. F5 continues, F6 pauses, F10 steps over, F11 steps in.