whatisgithub

What is amigaemu?

burnermcburnface33/amigaemu — explained in plain English

Analysis updated 2026-05-18

0MakefileAudience · developerComplexity · 4/5LicenseSetup · hard

In one sentence

An iOS app that emulates a classic Amiga 2000 computer with a full set of touch controls, letting you run old Amiga software on an iPhone or iPad.

Mindmap

mindmap
  root((AmigaEmu))
    What it does
      Emulates Amiga 2000
      Runs on iPhone and iPad
      Boots Workbench OS
    Tech stack
      SwiftUI
      Metal rendering
      vAmiga core
    Use cases
      Play imported disk images
      Use touch controls
      Connect game controllers
    Audience
      Retro computing fans
      iOS developers
    Setup
      Needs Xcode and XcodeGen
      Requires own Kickstart 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

What do people build with it?

USE CASE 1

Run classic Amiga software and games on an iPhone or iPad using touch controls.

USE CASE 2

Import your own Amiga disk images through the Files app to play on the emulator.

USE CASE 3

Use a Bluetooth game controller or the onscreen D-pad and joystick to play Amiga games.

USE CASE 4

Build and sign the app yourself with Xcode to install it on your own device.

What is it built with?

SwiftSwiftUIObjective-C++MetalXcodeGen

How does it compare?

burnermcburnface33/amigaemuchmduquesne/opentopomaps-managercrowdsecurity/pfsense-freebsd-ports
Stars0
LanguageMakefileMakefileMakefile
Last pushed2022-04-042025-10-28
MaintenanceDormantQuiet
Setup difficultyhardmoderatehard
Complexity4/53/54/5
Audiencedeveloperdeveloperops devops

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

How do you get it running?

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 Kickstart ROM file.

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

So what is it?

This project is an iPhone and iPad app that lets you run old Commodore Amiga computer software directly on your device. It wraps an existing emulator engine called vAmiga inside a native Apple app built with SwiftUI, adding touch controls, sound, and graphics rendering designed for phones and tablets rather than a desktop computer. The emulated machine is a classic Amiga 2000 setup, with the kind of memory and processor an actual Amiga from that era had. It boots into the Amiga's own operating system, Workbench, just like the original hardware would. Because of the specific emulator core used, it can only emulate older Amiga models, not the later, more powerful ones. The app's biggest focus seems to be making an old computer usable with only a touchscreen. It offers seven different ways to provide input, including an onscreen keyboard, a virtual joystick, a customizable D-pad, and even letting the whole screen act like a mouse trackpad. It also supports save states so you can pause and resume later, lets you import Amiga disk images through the Files app, and works with physical Bluetooth game controllers. To build and run it yourself, you need a Mac with Xcode installed, plus a tool called XcodeGen to generate the actual Xcode project file. Importantly, the app does not come with the Kickstart ROM file the Amiga needs to boot, or with any disk images or software to run on it. You have to supply those yourself, and you are responsible for making sure you are legally allowed to use them. This is described by its author as a personal hobby project, offered as is with no warranty, and it is not affiliated with Commodore or Amiga in any way. It is aimed at people who want to relive or explore classic Amiga computing on a modern iOS device.

Copy-paste prompts

Prompt 1
Walk me through the steps in this README to build and run this Amiga emulator on my own iPhone using Xcode.
Prompt 2
Explain how the seven touch input modes described in this README work and how they differ from each other.
Prompt 3
Help me understand what a Kickstart ROM is and why this app requires me to supply my own, based on this README.
Prompt 4
Summarize the architecture section of this README describing how the SwiftUI shell talks to the emulator core.

Frequently asked questions

What is amigaemu?

An iOS app that emulates a classic Amiga 2000 computer with a full set of touch controls, letting you run old Amiga software on an iPhone or iPad.

What language is amigaemu written in?

Mainly Makefile. The stack also includes Swift, SwiftUI, Objective-C++.

What license does amigaemu use?

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

How hard is amigaemu to set up?

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

Who is amigaemu for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.