Amiga Emulation on the Mac

FS-UAE Emulator:

Setup a 3.1 System

Create a virtual Amiga 1200
  • Start FS-UAE Launcher
  • Create a new config called "3.1 Amiga"
  • Click on the image of the floppy and create a "Media Swap List"
    • Add all of the Amiga DOS install disks
    • Mount the Install disk in DF0:
  • Click the image of a harddrive and create two Amiga drives
    • System (/Users/your-user/Desktop/Amiga Emulation/Emulated Amigas/3.1)
    • Work (/Users/your-user/Desktop/Amiga Emulation/Emulated Amigas/3.1)
  • Click the image of a chip and do the following:
    • Select a "Custom" Kickstart ROM
    • Check "Chip RAM" and set to 2MB
    • Check "Fast RAM" and set to 8MB
  • Click the image of an expansion card and do the following:
    • Check "Graphics Card" and set it to UAEGFX
    • Check UAE bsdsocket.library and set to Enabled
  • Click on the image of a switch and do the following:
    • Check "CPU" and set it to "68040-NOMMU"
    • Check "JIT Compiler" and set it to "Enabled"
  • Save this configuration

Tweak the default FS-UAE Settings


On my Mac I had a couple issues right off the bat:
  • No matter what I tried I could not get the on screen menu to display. F12 would always just increase the volume.
  • Screen resolution was odd after I went above base NTSC

Click the Amiga Check on the left of FS-UAE Launcher, select Settings and change the following:
  • Select Video
    • Set "Keep aspect ratio when scaling (do not stretch)" to "On"
  • Select Advanced Settings and add to enable CMD-M to bring up the onscreen menu
    keyboard_key_mod_m = action_menu

Install OS 3.1

Don't over think this. Since the hard drives are emulated you can install the OS straight away without partitioning and formatting drives. Just boot the virtual machine from the Install disk and install to the System drive. When you are done, eject any floppy images and reboot the machine.

Source: (Substitute the CMD key for F12)

The following shortcuts will be necessary:
  • CMD-M : Bring up the on screen menu and do things like swap floppies
  • CMD-R : Reset the Amiga
  • CMD-G : Grab and release the mouse pointer
  • CMD-Q : Power off the Amiga

Setup a development Environment

There are at least a couple options for native development on AmigaOS 3.1. VBCC is an awesome choice. Binaries are available for AmigaOS 68k and PPC, MorpgOS, Atari MiNT and Atari TOS. Compiler targets are available for even more platforms.

In this case I chose ADE from Aminet for the consistency of using GCC on AmigaOS 68k, PPC and MorpgOS. ADE is easy to install. Just download from Aminet, extract the archive and add the following to S:User-Startup:
Cd Sys:ADE
Execute ADE-Startup

Here is an example project from the ADE readme:
(Open a new shell or CLI then enter the following commands)

1.> cd ram:
1.> ed test.c

#include <stdio.h>

int main(int argc, char **argv) 
  printf("Hello ADEn");
  return 0;

1.> gcc -noixemul test.c
1.> a.out
Hello ADE
Topic revision: r2 - 10 Nov 2017, BobWicksall
This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Foswiki? Send feedback