English Amiga Board

Go Back   English Amiga Board > Support > support.FS-UAE

Thread Tools
Old 01 December 2018, 18:06   #1
Registered User

Join Date: Dec 2018
Location: Geelong/Australia
Posts: 1
How to Install AmiKit in FS-UAE (Mac OSX)

(The old/existing instructions...well...kinda blow-dog).

So you have an Apple Mac and you want to install AmiKit (which uses WinUAE via Wine) on FS-UAE, who knows why you want to, you just do...because you can.

The speed of AmiKit on a modern Mac is fine, it plays everything great! Previous experiments had shown no noticeable gain upgrading the version of Wine and WinUAE in the AmiKit install. So, I wanted to see if there was a performance improvement by not using Wine.

I am using Amiga OS 3.1.4 (A1200 version) on my Mac Pro, with a Geekbench single-core score of 3854 (to compare these results with what you might expect from your own rig).

Spoiler Alert:
FS-UAE might be faster than Wine, but I'm not convinced you'll notice:

SysSpeed says yes:

MIPS. 1813.34
MFLOPS 1484.68

MIPS. 2475.15
MFLOPS 2079.07

SysInfo shows a slightly different result:

MIPS 580.21
MFLOPS. 44.39

MIPS 451.99
MFLOPS. 63.80

FS-UAE + Blizzard 060
MIPS 32.11
MFLOPS. 10.33

Both results are waaaay faster than a stock A4000, and capable of modern computing.

The 060 experiment shows emulating an Amiga 1200 with a Blizzard 060 accelerator card is 1.68 times faster than a stock A4000 040 25Mhz. Not really up to modern computing demands, and much slower than emulating the 020 with very little practical advantage, but still plenty fast enough to run your games.

A note on running WHDLoad games from FS_UAE and AmigaOS- using an Amiga faster than stock causes a bad flickering problem in at least a couple games, Nitro and IK+ (and its not an old .slave file issue). They work fine using FS-UAE with the original speed & config Amiga, or outside FS-UAE using the Wine AmiKit install, but they hiccup with FS-UAE running any AmigaOS and blazing fast (with or without an accelerator). It's not JIT either, as even with JIT off and using an 040 or 060 the same graphic error occurs. Most games work perfectly with no glitches, but my favs Nitro/IK+ suffer. So I play them using the Quickstart (File & Game database) options in FS-UAE, not from inside the AmigaOS.

Enough, lets move on. Getting an AmiKit drive into FS-UAE then...

You will need a Workbench boot floppy. I used a Workbench 3.0 .ADF file.

1. Install AmiKit on your Mac (no need to start a virtual machine and do the windows version and all that blah blah from the previous instructions)

2. I completed the AmiKit instructions through to the point where I had a bootable AmiKit install, and I let it install all the latest patches etc. I also did the upgrade to Amiga OS 3.1.4 (A1200 version - make a purchase on the Hyperion website http://hyperion-entertainment.com and support your girlfriend (the Amiga)).

3. I could not use the AmiKit install in FS-UAE. I get an error with the initial AmiKit install if I try to run it in FS-UAE, an error 'CopyReplace failed return code 20' - which is a fatal software error (at the point where it copies the files from your choice of Amiga OS 3.9 CD, Amiga Forever etc...); and an FS-UAE error about an unimplemented feature 52... anyway, it doesn't work, so do the initial install all the way using the AmiKit install and follow the AmiKit instructions.

4. Exit AmiKit. If you are using the default install of FS-UAE, then go to "Documents" on your Mac, and navigate to (or create the folders if you have not installed FS-UAE yet)

/Documents/FS-UAE/Hard Drives

create new folder and call it AmiKit_FSUAE (call it anything you want, but don't call it AmiKit as this is already used by AmiKit..duh)! Don't close the finder window yet.

5. Right click on AmiKit and choose "Show package contents". Then navigate to:


and copy a Workbench boot disk in ADF or DMS format here. I used a Workbench 3.0 .adf image, I don't think it will matter which WB you use for this next step. Keep it simple.

6. Navigate to:

Copy the RabbitHole folder to /Documents/FS-UAE/Hard Drives
Copy the Dropbox folder too, if you use that. I don't, so I left it out and it has not caused me any grief.

7. Relaunch AmiKit and choose 'Configure' - do not hit 'Launch'. Click on Floppy Drives, and put a Workbench disk into DF0: I put a Workbench 3.0 .adf disk image in DF0: to boot from. Do not start WinUAE yet.

8. Click on 'CD & Hard drives' and then on "Add Directory or Archive". Click on "Select Directory". Click on 'My Documents', 'FS-AUE', 'Hard Drives' and 'AmiKit_FSUAE' (or whatever you named the folder from step 4 above - from here on, I just assume you have used AmiKit_FSUAE) and click the 'open' button. Click OK.

9. (Give thanks to your favourite Deity), and click the start button in WinUAE.

10. If your Mac shows a message asking for Wine to control your computer, hit 'Deny'. it doesn't need sh.t.

11. Hopefully your workbench boot disk has started your amiga, and the familiar desktop shows up (looks fugly these days, heh?). Hopefully you see an 'AmiKit' and an 'AmiKit_FSUAE' icon.

12. Open WorkBench disk, open the System drawer, and open the Shell application in the Amiga you just booted up. In the Shell window type:

copy AmiKit: AmiKit_FSUAE: all quiet clone

Give your machine time to copy the almost 1Gb across. The Shell won't show you much love, if you want to see some action, just ask your Deity to grant you patience, but could they hurry-up.

....still waiting... My Mac has an SSD drive (not the bottleneck here) and took about 8 minutes before the command prompt reappeared in the Shell window. You can see it's doing something by the flashing "HD" icon at the bottom of the emulator window, or right clicking the AmiKit_FSUAE folder and choosing 'Get Info' (or select the folder and press CMD+i)- and watch the folder size grow before your very eyes.

13. With that done, close WinUAE, don't save anything - then you can go back to using AmiKit has designed should you wish.

14. Install/Open FS-UAE. I use the latest stable version, which at time of writing is v2.8.3.

15. If you have not already done so, copy your Kickstart rom to

If you purchased a digital copy of Amiga OS 3.1.4, the correct ROM is under AmigaOS-3.1.4-A1200.zip/ROMs/unsplit_unswapped/kck.a1200.46.143

16. I assume you know your way around FS-UAE to a basic level here. The FS-UAE website has good help if you need it. Create and save a config as follows:

a. Amiga Model A1200, using a 3.1 ROM and 68020 CPU, High Accuracy (as above, any other CPU will actually be slower, or not provide the right features to make this work). Nothing in the Floppy Drives.

b. Set Amiga Joystick to your gamepad or Joystick of choice (you need a gamepad/joystick connected to your Mac before it will be available in the drop down list here)

c. Set your first hard to the folder /Documents/FS-UAE/Hard Drives/AmiKit_FSUAE
d. Set your next Hard Drive to /Documents/FS-UAE/Hard Drives/RabbitHole
e. If you have a folder with unzipped WHDLoad files ready to use, then add that hard drive in as well.

f. Set your Kickstart ROM: to a 3.1 ROM, or if you have upgraded to Amiga OS 3.1.4, set this to the kick.a1200.46.143

g. Set Chip RAM to 8Mb (woohoo!), 0Mb Slow RAM, 0Mb Fast RAM, 0Mb Motherboard RAM, 0Mb Accelerator RAM

h. Tick the checkmark boxes for Zorro III Fast Memory and Graphics Card RAM and set both to 256Mb (go higher if you want - but what the heck are you doing that needs that much, and really - should be using an emulator for that work??)

i. Under Expansions, do not have tick in the Accelerator or Blizzard SCSI Kit checkmark boxes
j. Put a tick in the checkmark box for Graphics Card and set this to UAEGFX Zorro III
k. Put a tick in the checkmark box for UAE bsdsocket.library, and set this to Enabled

l. Put a tick in the checkmark box for CPU and set to 68020 (not the EC model)
m. Put a tick in the checkmark box for JIT Compiler and set this to Enabled
n. <optional> I also put a Put a tick in the checkmark box for Floppy Drive Speed and set this to 800% - potentially a problem for loading disks, but I have not had an issue yet.

o. Click the Custom Configuration button and add the following lines:
uae_cpu_speed = max
uae_fpu_model = 68882
uaem_write_flags = nhsparwed

This tells FS-UAE to use a math co-processor (the 68882), and to run the 68020 at the fastest speed possible by your rig. The uaem_write_flags is from the previous instructions, and here for safety, but likely unneeded as the default for FS-UAE is to have all these turned on anyway.

17. Give your new config a name and hit the save button!

18. You can tweak other settings in FS-UAE by clicking he Amiga logo icon in the top left of the FS-UAE config window, and from the drop-down, select Settings. You can set the location to search for games (folder on your Mac, zip files OK to use) using the File Database options, and download the latest Game Database.

Last edited by Craziazkowboi; 02 December 2018 at 13:07.
Craziazkowboi is offline  
Old 01 December 2018, 18:18   #2
Registered User
Join Date: Aug 2014
Location: Brindisi (Italy)
Posts: 3,908
Excellent Guide, if you want you can simplify everything in a few minutes, installing Amikit on HardFile with WinUAE and then configure hardFile on FS-UAE. I did this with Amilator, in addition to Amikit I started AfA-OS and OS4.1.

Amilator (FS-UAE boot base Linux):
[ Show youtube player ]
[ Show youtube player ]
AMIGASYSTEM is offline  

Currently Active Users Viewing This Thread: 1 (0 members and 1 guests)
Thread Tools

Similar Threads
Thread Thread Starter Forum Replies Last Post
Setting up a ClassicWB install on 8GB CF (FS-UAE/OSX) remotenemesis project.ClassicWB 2 01 July 2018 10:42
FS-UAE Ubuntu 14.10 AmiKit - Won't install with AmigaForever scunacc support.FS-UAE 4 02 December 2015 21:27
Mount CD on fs-uae OSX to install OS3.9 elowan support.FS-UAE 28 14 January 2013 17:17
FS-UAE: 50Hz mode with Mac OSX waal support.FS-UAE 6 09 July 2012 22:50
Install Workbench3.1 E-UAE Mac OS popto support.OtherUAE 6 08 August 2011 15:06

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off

Forum Jump

All times are GMT +2. The time now is 19:39.

Powered by vBulletin® Version 3.8.11
Copyright ©2000 - 2018, vBulletin Solutions Inc.
Page generated in 0.05868 seconds with 15 queries