This page will help you compile, install and run FS-UAE, FS-UAE Arcade and FS-UAE Launcher. Please note that unless you have experience compiling software, I strongly recommend you download pre-built versions instead.

The instructions given on this page are general instructions for building FS-UAE. Also see Compiling on Windows for more specific information.

Compiling FS-UAE

The following software is needed to compile FS-UAE from the source code archive:

• A bourne-compatible shell
• GNU or BSD make
• GCC compiler suite with C/C++ support (mingw on Windows) or clang/clang++.
• pkg-config
• git – if you want to checkout the development repository), or
• tar, gzip – to untar the source tarballs
• gettext
• zip – needed to compile fs-uae.dat at the end of the compilation process

You need the following libraries (with headers / development files):

• SDL 2.0
• libpng
• zlib
• glib
• libintl (from gettext)
• OpenAL or OpenAL Soft – the latter is recommended for most systems.
• OpenGL
• freetype – strictly speaking, this library isn’t yet used, so it is possible to remove it from configure.ac.
• GLEW

If you have checkout out the git repository, you first need to run the bootstrap script (this additionally requires autoconf, automake, libtool) – skip this step if you have extracted a source tarball:

./bootstrap

Then you need to configure the source:

./configure

To compile the program simply run make:

make

The resulting program is placed in the root directory of the project, and you can run it directly without installing by running:

./fs-uae

Running fs-uae locally like this works fine – but you need to have the source root directory as the current working directory when running it like this without installation.

Installing FS-UAE

To install fs-uae, you can run make install

make install

Compiling FS-UAE Launcher

FS-UAE Launcher is written in pure Python, but depends on several Python extensions in addition to Python itself:

• Python 3.3 or newer.
• PyQt5.
• setuptools – for resource loading.
• python-lhafile – for .lha file support (optional).

I recommend extracting the source code in a directory parallel to the fs-uae source directory, i.e: src/fs-uae and src/fs-uae-launcher.

You can run FS-UAE Launcher from the source directory without installing it:

 FIXME

Installing FS-UAE Launcher

python setup.py install
make install

Additional Instructions for Windows

See Compiling FS-UAE on Windows