Compiling and running ep128emu

This page has not been written yet in full detail, but here is how to get started:

After downloading and unpacking the sources, edit 'Makefile' to set the compiler to be used, compiler flags (you may want to experiment with optimization settings to get the best performance), and select the type of sound output (dummy - no sound, ALSA - Linux only but has excellent latency and timing, SDL - for other platforms).
Compilation can be done by typing 'make', however, there is no 'make install', so you need to copy the resulting ep128emu binary to a directory that can be found in the PATH (e.g. /usr/local/bin). If you do not need direct frame buffer access (for example, because you have a fast machine), or are concerned about security, set the permissions of the executable to 'root:root 0755'. Alternatively, to have fast fullscreen video display, set the permissions to 'root:yourgroup 4750', where 'yourgroup' is a group of which no one other than you is a member (WARNING: anyone who can run the emulator when installed this way can potentially gain root access to the system).
There are also some useful utilities for manipulating tape files in the 'tapeutil' directory. It is recommended to compile and install these too (this time there is no point in installing the binaries as setuid root).
To get some information about command line options and keyboard usage, type 'ep128emu --help'.
The '.ep128rc' example configuration file included with the sources documents the available configuration options, and is a good starting point to get the emulator correctly set up. You need to either copy this file to your home directory, or specify its location using the '-cfg' command line option.

Back to ep128emu home page