plus4emu installation

Linux

On Linux and other POSIX platforms, the emulator is installed from the source code, available at the SourceForge download page, or the most recent state of the code can be downloaded from SVN with the following command:

svn co http://plus4emu.svn.sourceforge.net/svnroot/plus4emu/plus4emu

In addition to the standard development tools (a recent version of the GNU C/C++ compiler, binutils, etc.), you need the following packages:

SCons
Python interpreter for running SCons
FLTK 1.1.x
NOTES:
- this library should be compiled with the --enable-threads 'configure' option - many Linux distributions include binaries of the FLTK library built without --enable-threads, so you may need to compile it from sources
- on MacOS X, FLTK 1.1.7 needs to be patched with the included fltk-1.1.7-MacOSX.patch file
PortAudio, version 18 and 19 are supported, but v19 is recommended
libsndfile
dotconf (optional, but recommended as it is used for reading ASCII format configuration files)
SDL 1.2 for joystick input (optional)
NOTE: on Linux, version 1.2.10 and newer do not work, so using 1.2.9 is recommended
Lua for scripting in the debugger (optional)

Once these are installed, you can edit the file 'SConstruct' in the top level source directory for setting compiler flags etc., and run the command 'scons' for building the emulator. The resulting executable files (plus4emu and tapconv) can be copied to any directory that is in the PATH; on MacOS X, an .app package is created in 'plus4emu.app'.
When installing the first time, you also need to set up configuration files and ROM images:

copy all .rom files from the roms directory to ~/.plus4emu/roms/ (or, in the case of MacOS X, ~/Library/Application Support/plus4emu/roms/)
after installing the ROM images, run 'plus4emu', and click OK to any windows that pop up asking for the base directory of configuration and data files, and if configuration files should be installed

It is possible to reinstall configuration files later by running the 'makecfg' utility.

Windows

A binary package with an installer is available at the SourceForge download page. To install, just run the executable, and follow the instructions. When asked if configuration files should be reinstalled, click 'OK' when installing the first time, but this step can be skipped in later installations to preserve the configuration.

Back to main page