The emulators/fs-uae port

fs-uae-2.4.0p11 – modern Amiga emulator (source)


FS-UAE focuses on emulating Amiga games using the accurate emulation
code from WinUAE. It also has features to emulate a high-end Amiga with


$OpenBSD: README,v 1.4 2018/09/04 12:46:11 espie Exp $

| Running ${PKGSTEM} on OpenBSD

Kickstart ROM

You will need a Kickstart ROM for the system you wish to emulate.
Kickstart is the name given to the chip in a real Amiga that contains
the bootloader and other stuff. The Kickstart ROM can either be dumped
from a real Amiga using a tool like Amiga Explorer for Windows.
Alternatively you can buy the Kickstart ROM from AmigaForever. More
details here:

The Kickstart ROMs are copyrighted. You should obtain them legally.


The majority of emulator configuration, including the import of Kickstarts,
can now be done via the launcher. This is now an external package


The launcher should detect your joystick automagically, but incase it
does not, here are the instructions for configuring one manually.

Under Linux, SDL joysticks show up as named devices and ideally there
would be a config file in ${TRUEPREFIX}/share/fs-uae/input for each
Under OpenBSD however, SDL joysticks are named "joystick (n)", where n
is the uhid device number. Due to these differences, joystick setup is
slightly different. This is best shown by example.

Suppose we want to configure this device as a joystick:

uhidev0 at uhub4 port 1 configuration 1 interface 0 "WiseGroup.,Ltd MP-8888 USB Joypad" rev 1.10/3.00 addr 2
uhidev0: iclass 3/0
uhid0 at uhidev0: input=7, output=3, feature=0

First find a matching or similar device config in

In this case of our example, a close match is:

To use this joystick configuration:

 $ cp ${TRUEPREFIX}/share/fs-uae/input/wisegroup_ltd/tigergame_ps_ps2_game_controller_adapter.ini \

Now edit your config file and uncomment this line:
#joystick_port_1 = joystick (0)

Note that we "plug the controller in" to the second joystick port. This
is because on a real Amiga, port 0 (the first port) is usually occupied
by a mouse.

When you next boot fs-uae the joystick should now work.

Useful Keyboard Shortcuts

The keyboard shortcuts you absolutely need to know are:

F12:		Show menu.
Alt + Enter:	Toggle fullscreen.
Middle click:	Release mouse from FS-UAE.
F12 + g:	Release mouse from FS-UAE.
F12 + q:	Quit

If you have no real joystick configured, you can use the emulated one.
Cursor keys controls the joystick stick and right ctrl or right alt
controls the fire button.

FS-UAE is Slow?

Play with 'video_sync' and 'accuracy' in the config file.




Edd Barrett

Only for arches

aarch64 alpha amd64 arm hppa i386 mips64 mips64el powerpc sh sparc64


on alpha: error: invalid 'asm': invalid %xn code



Library dependencies

Build dependencies

Run dependencies

Reverse dependencies


File Descr
Path Name
Category Maintainer