FS-UAE & Launcher for Windows

Download the two .zip archives and extract the contained FS-UAE and FS-UAE-Launcher folders to wherever you like. You must keep these two folders stored alongside each other. A Windows installer is currently not available.

The fs-uae-launcher.exe executable is found within FS-UAE-Launcher/Windows/x86-64. You can of course make a shortcut to this to make starting it more convenient.

Plugins

The following plugins can be used to extend the functionality of FS-UAE. CAPSImg provides support for .ipf floppy images while QEMU-UAE provides PPC emulation support.

The plugins must be installed into Documents/FS-UAE/System. For example, the CAPSImg directory should be extracted as Documents/FS-UAE/System/CAPSImg.

Portable version

If you want to convert Documents/FS-UAE to a portable directory which you can move wherever you want, just follow these two simple steps:

1. Make sure FS-UAE and FS-UAE-Launcher are stored inside Documents/FS-UAE. I recommend storing them as Documents/FS-UAE/System/FS-UAE-Launcher and Documents/FS-UAE/System/FS-UAE.
2. Download the file Portable.ini and save it in Documents/FS-UAE.

You can now move Documents/FS-UAE to any location. Go to the documentation to read more about this feature.

FS-UAE Arcade

FS-UAE Arcade builds are not done for version 3.1 yet. However, arcade mode is included with FS-UAE Launcher. So you can generally run fs-uae-launcher --arcade to launch the arcade interface if you know how to run the executable directly with additional arguments.

FS-UAE & Launcher for macOS

Download the .dmg images for both FS-UAE Launcher and FS-UAE, and copy the apps within to /Applications or wherever you like. You must keep these two apps stored alongside each other. You also need to choose the correct version for your machine; The ARM64 version is for Apple Silicon (M1 Macs), and x86-64 is for Intel hardware.

If you are unsure about which version to choose, just go with x86-64 which should work on all recent macOS systems (10.13 or newer).

The ARM64 version will run faster on M1 Macs, but does not support JIT compilation. You should be able to run the x86-64 on M1 Macs (with JIT) though of course performance will be affected somewhat by emulating both 68K and x86-64 on ARM64 hardware.

If you have an older macOS version which is not supported by the main FS-UAE Launcher download, you can download a version for macOS 10.9 or newer instead. It is built with older versions of Python and PyQt5.

Plugins

The following plugins can be used to extend the functionality of FS-UAE. CAPSImg provides support for .ipf floppy images while QEMU-UAE provides PPC emulation support.

The plugins must be installed into Documents/FS-UAE/System. For example, the CAPSImg directory should be extracted as Documents/FS-UAE/System/CAPSImg.

Portable version

If you want to convert Documents/FS-UAE to a portable directory which you can move wherever you want, just follow these two simple steps:

1. Make sure FS-UAE and FS-UAE-Launcher are stored inside Documents/FS-UAE. I recommend storing them as Documents/FS-UAE/System/FS-UAE-Launcher and Documents/FS-UAE/System/FS-UAE.
2. Download the file Portable.ini and save it in Documents/FS-UAE.

You can now move Documents/FS-UAE to any location. Go to the documentation to read more about this feature.

FS-UAE Arcade

FS-UAE Arcade builds are not done for version 3.1 yet. However, arcade mode is included with FS-UAE Launcher. So you can generally run fs-uae-launcher --arcade to launch the arcade interface if you know how to run the executable directly with additional arguments.

FS-UAE & Launcher for Linux

Download the .tar.xz archives for your operating system and extract the contained FS-UAE and FS-UAE-Launcher directories to wherever you like. You must keep these directories stored alongside each other.

The fs-uae-launcher executable is found within FS-UAE-Launcher/Linux/x86-64. You can of course make a shortcut or symlink to this to make starting it more convenient.

Plugins

The following plugins can be used to extend the functionality of FS-UAE. CAPSImg provides support for .ipf floppy images while QEMU-UAE provides PPC emulation support.

The plugins must be installed into Documents/FS-UAE/System. For example, the CAPSImg directory should be extracted as Documents/FS-UAE/System/CAPSImg.

Portable version

If you want to convert Documents/FS-UAE to a portable directory which you can move wherever you want, just follow these two simple steps:

1. Make sure FS-UAE and FS-UAE-Launcher are stored inside Documents/FS-UAE. I recommend storing them as Documents/FS-UAE/System/FS-UAE-Launcher and Documents/FS-UAE/System/FS-UAE.
2. Download the file Portable.ini and save it in Documents/FS-UAE.

You can now move Documents/FS-UAE to any location. Go to the documentation to read more about this feature.

FS-UAE Arcade

FS-UAE Arcade builds are not done for version 3.1 yet. However, arcade mode is included with FS-UAE Launcher. So you can generally run fs-uae-launcher --arcade to launch the arcade interface if you know how to run the executable directly with additional arguments.

Plugins

A few plugins are available to extend the functionality of FS-UAE and/or FS-UAE Launcher. The plugins must be installed into Documents/FS-UAE/System. For example, the CAPSImg directory should be extracted as Documents/FS-UAE/System/CAPSImg.

CAPSImg plugin

The CAPSImg plugin provides support for loading .ipf floppy images.

QEMU-UAE plugin

The QEMU-UAE plugin provides support for emulating the PPC processor included on accelerator board such as the Cyberstorm PPC.

FS-UAE & Launcher for Ubuntu

Run the commands given for your distribution release in order to register the repository on your system and install FS-UAE & Launcher. You'll then get updates via your system package manager. Please note that when you upgrade to a new release of your distribution, you should come back here and register a new repository.

Alternatively, you can download the generic Linux builds. This will also allow you to set up a portable version.

Ubuntu 22.04

echo 'deb http://download.opensuse.org/repositories/home:/FrodeSolheim:/stable/xUbuntu_22.04/ /' | sudo tee /etc/apt/sources.list.d/home:FrodeSolheim:stable.list
curl -fsSL https://download.opensuse.org/repositories/home:FrodeSolheim:stable/xUbuntu_22.04/Release.key | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/home_FrodeSolheim_stable.gpg > /dev/null
sudo apt update
sudo apt install fs-uae fs-uae-launcher fs-uae-arcade

Ubuntu 21.10

echo 'deb http://download.opensuse.org/repositories/home:/FrodeSolheim:/stable/xUbuntu_21.10/ /' | sudo tee /etc/apt/sources.list.d/home:FrodeSolheim:stable.list
curl -fsSL https://download.opensuse.org/repositories/home:FrodeSolheim:stable/xUbuntu_21.10/Release.key | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/home_FrodeSolheim_stable.gpg > /dev/null
sudo apt update
sudo apt install fs-uae fs-uae-launcher fs-uae-arcade

Ubuntu 21.04

echo 'deb http://download.opensuse.org/repositories/home:/FrodeSolheim:/stable/xUbuntu_21.04/ /' | sudo tee /etc/apt/sources.list.d/home:FrodeSolheim:stable.list
curl -fsSL https://download.opensuse.org/repositories/home:FrodeSolheim:stable/xUbuntu_21.04/Release.key | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/home_FrodeSolheim_stable.gpg > /dev/null
sudo apt update
sudo apt install fs-uae fs-uae-launcher fs-uae-arcade

Ubuntu 20.10

echo 'deb http://download.opensuse.org/repositories/home:/FrodeSolheim:/stable/xUbuntu_20.10/ /' | sudo tee /etc/apt/sources.list.d/home:FrodeSolheim:stable.list
curl -fsSL https://download.opensuse.org/repositories/home:FrodeSolheim:stable/xUbuntu_20.10/Release.key | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/home_FrodeSolheim_stable.gpg > /dev/null
sudo apt update
sudo apt install fs-uae fs-uae-launcher fs-uae-arcade

Ubuntu 20.04

echo 'deb http://download.opensuse.org/repositories/home:/FrodeSolheim:/stable/xUbuntu_20.04/ /' | sudo tee /etc/apt/sources.list.d/home:FrodeSolheim:stable.list
curl -fsSL https://download.opensuse.org/repositories/home:FrodeSolheim:stable/xUbuntu_20.04/Release.key | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/home_FrodeSolheim_stable.gpg > /dev/null
sudo apt update
sudo apt install fs-uae fs-uae-launcher fs-uae-arcade

Ubuntu 18.04

echo 'deb http://download.opensuse.org/repositories/home:/FrodeSolheim:/stable/xUbuntu_18.04/ /' | sudo tee /etc/apt/sources.list.d/home:FrodeSolheim:stable.list
curl -fsSL https://download.opensuse.org/repositories/home:FrodeSolheim:stable/xUbuntu_18.04/Release.key | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/home_FrodeSolheim_stable.gpg > /dev/null
sudo apt update
sudo apt install fs-uae fs-uae-launcher fs-uae-arcade

Plugins

If you need plugins to extend the functionality of FS-UAE, such as CAPSImg for .ipf floppy image support or QEMU-UAE for PPC emulation, then you download and install the generic Linux plugins. These are not included in the package repositories, but should work on most Linux distributions.

FS-UAE & Launcher for Debian

Run the commands given for your distribution release in order to register the repository on your system and install FS-UAE & Launcher. You'll then get updates via your system package manager. Please note that when you upgrade to a new release of your distribution, you should come back here and register a new repository.

Alternatively, you can download the generic Linux builds. This will also allow you to set up a portable version.

Debian 11

echo 'deb http://download.opensuse.org/repositories/home:/FrodeSolheim:/stable/Debian_11/ /' | sudo tee /etc/apt/sources.list.d/home:FrodeSolheim:stable.list
curl -fsSL https://download.opensuse.org/repositories/home:FrodeSolheim:stable/Debian_11/Release.key | gpg --dearmor | sudo tee
/etc/apt/trusted.gpg.d/home_FrodeSolheim_stable.gpg > /dev/null
sudo apt update
sudo apt install fs-uae fs-uae-launcher fs-uae-arcade

Debian 10

echo 'deb http://download.opensuse.org/repositories/home:/FrodeSolheim:/stable/Debian_10/ /' | sudo tee /etc/apt/sources.list.d/home:FrodeSolheim:stable.list
curl -fsSL https://download.opensuse.org/repositories/home:FrodeSolheim:stable/Debian_10/Release.key | gpg --dearmor | sudo tee
/etc/apt/trusted.gpg.d/home_FrodeSolheim_stable.gpg > /dev/null
sudo apt update
sudo apt install fs-uae fs-uae-launcher fs-uae-arcade

Debian 9

echo 'deb http://download.opensuse.org/repositories/home:/FrodeSolheim:/stable/Debian_9.0/ /' | sudo tee /etc/apt/sources.list.d/home:FrodeSolheim:stable.list
curl -fsSL https://download.opensuse.org/repositories/home:FrodeSolheim:stable/Debian_9.0/Release.key | gpg --dearmor | sudo tee
/etc/apt/trusted.gpg.d/home_FrodeSolheim_stable.gpg > /dev/null
sudo apt update
sudo apt install fs-uae fs-uae-launcher fs-uae-arcade

Plugins

If you need plugins to extend the functionality of FS-UAE, such as CAPSImg for .ipf floppy image support or QEMU-UAE for PPC emulation, then you download and install the generic Linux plugins. These are not included in the package repositories, but should work on most Linux distributions.

FS-UAE & Launcher for Fedora

Run the commands given for your distribution release in order to register the repository on your system and install FS-UAE & Launcher. You'll then get updates via your system package manager. Please note that when you upgrade to a new release of your distribution, you should come back here and register a new repository.

Alternatively, you can download the generic Linux builds. This will also allow you to set up a portable version.

Fedora 35

sudo dnf config-manager --add-repo https://download.opensuse.org/repositories/home:FrodeSolheim:stable/Fedora_35/home:FrodeSolheim:stable.repo
sudo dnf install fs-uae fs-uae-launcher fs-uae-arcade kernel-modules-extra

Fedora 34

sudo dnf config-manager --add-repo https://download.opensuse.org/repositories/home:FrodeSolheim:stable/Fedora_34/home:FrodeSolheim:stable.repo
sudo dnf install fs-uae fs-uae-launcher fs-uae-arcade kernel-modules-extra

Fedora 33

sudo dnf config-manager --add-repo https://download.opensuse.org/repositories/home:FrodeSolheim:stable/Fedora_33/home:FrodeSolheim:stable.repo
sudo dnf install fs-uae fs-uae-launcher fs-uae-arcade kernel-modules-extra

Fedora 32

sudo dnf config-manager --add-repo https://download.opensuse.org/repositories/home:FrodeSolheim:stable/Fedora_32/home:FrodeSolheim:stable.repo
sudo dnf install fs-uae fs-uae-launcher fs-uae-arcade kernel-modules-extra

Fedora 31

sudo dnf config-manager --add-repo https://download.opensuse.org/repositories/home:FrodeSolheim:stable/Fedora_31/home:FrodeSolheim:stable.repo
sudo dnf install fs-uae fs-uae-launcher fs-uae-arcade kernel-modules-extra

Plugins

If you need plugins to extend the functionality of FS-UAE, such as CAPSImg for .ipf floppy image support or QEMU-UAE for PPC emulation, then you download and install the generic Linux plugins. These are not included in the package repositories, but should work on most Linux distributions.

FS-UAE & Launcher for openSUSE

Run the commands given for your distribution release in order to register the repository on your system and install FS-UAE & Launcher. You'll then get updates via your system package manager. Please note that when you upgrade to a new release of your distribution, you should come back here and register a new repository.

Alternatively, you can download the generic Linux builds. This will also allow you to set up a portable version.

openSUSE Tumbleweed

sudo zypper addrepo https://download.opensuse.org/repositories/home:FrodeSolheim:stable/openSUSE_Tumbleweed/home:FrodeSolheim:stable.repo
sudo zypper refresh
sudo zypper install fs-uae fs-uae-launcher fs-uae-arcade

openSUSE Leap 15.4

sudo zypper addrepo https://download.opensuse.org/repositories/home:FrodeSolheim:stable/15.4/home:FrodeSolheim:stable.repo
sudo zypper refresh
sudo zypper install fs-uae fs-uae-launcher fs-uae-arcade

openSUSE Leap 15.3

sudo zypper addrepo https://download.opensuse.org/repositories/home:FrodeSolheim:stable/15.3/home:FrodeSolheim:stable.repo
sudo zypper refresh
sudo zypper install fs-uae fs-uae-launcher fs-uae-arcade

openSUSE Leap 15.2

sudo zypper addrepo https://download.opensuse.org/repositories/home:FrodeSolheim:stable/openSUSE_Leap_15.2/home:FrodeSolheim:stable.repo
sudo zypper refresh
sudo zypper install fs-uae fs-uae-launcher fs-uae-arcade

Plugins

If you need plugins to extend the functionality of FS-UAE, such as CAPSImg for .ipf floppy image support or QEMU-UAE for PPC emulation, then you download and install the generic Linux plugins. These are not included in the package repositories, but should work on most Linux distributions.

FS-UAE & Launcher for FreeBSD

Please note that FreeBSD is not officially supported by FS-UAE, and these instructions might be outdated.

The source code should compile and FS-UAE should run on FreeBSD, but note that FS-UAE will run poorly without hardware-accelerated OpenGL drivers.

FS-UAE is also available in the ports tree. To install, run the following as root:

pkg install fs-uae fs-uae-launcher

Or compile the ports yourself:

cd /usr/ports/emulators/fs-uae
make install clean
cd /usr/ports/emulators/fs-uae-launcher
make install clean

FS-UAE & Launcher for OpenBSD

Please note that OpenBSD is not officially supported by FS-UAE, and these instructions might be outdated.

The source code should compile and FS-UAE should run on FreeBSD, but note that FS-UAE will run poorly without hardware-accelerated OpenGL drivers.

FS-UAE is also available in the ports tree as emulators/fs-uae and emulators/fs-uae-launcher.

Source code

Related GitHub projects

https://github.com/FrodeSolheim/fs-uae
https://github.com/FrodeSolheim/fs-uae-launcher
https://github.com/FrodeSolheim/capsimg
https://github.com/FrodeSolheim/qemu-uae