KEGS

KEGS is an apple IIg emulator. Yet I am using it as apple II emulator because there are too much limitation on apple2 and xapple2 packages. Follow these steps to install KEGS on Ubuntu Hardy (8.04):

1. Get source code of KEGS at sourceforge. Untar the file. I am using current version 0.91 as of Apr-2008.
   
2. KEGS requires xorg-dev package. Get the package "xorg-dev" by command: "sudo apt-get install xorg-dev".
   
3. Read the instruction on the README.compile.txt. Try to follow the instruction.
4. You may note that the Makefile of KEGS does not support amd64 architecture. Take these steps to remedy:
1. copy "vars_x86linux"  as "vars_x86linux64"
2. Edit the file var_x86linux64, Find the line CCOPTS (It should be line 5 or around), and turn it as: "CCOPTS = -O2 -Wall -fomit-frame-pointer -m64"
3. The variable file "vars" need to be relinked. Command: "rm vars; ln -s vars_x86linux64 vars"
5. The execute file "xkegs" is created.

You need the roms file to use KEGS. Get it from Asimov. There are two versions of Apple IIg rom, one is gsrom01.zip and the other is gsrom03.zip. If The file in Asimov is missing, You can also get the 01 rom or 03 rom here. Unzip the file and rename it as "ROM". Now you can start "xkegs", but to start the emulator by apple II disk images, you need to:

1. See the README.kegs.txt, You will know that you need to use "Ctrl-Command-Esc" to get the Apple IIg console
1. The "command" can be F1, Left Alt, or Scroll Lock in standard 104 keyboard. More keys may be used if you are not using 104 keyboard.
2. However, in xubuntu Xfce environment, many key combination are bind to some functions. For example, "Ctrl-Alt-Esc" means killing a window: You don't want to kill a window when configurating xkegs. Because it is issue of window manager, either you need configure the windows manager to remove the key binds, or configure the Apple IIg console under failsafe session just as I did.
2. Use "F4" to configure speed and disk. Now you can enjoy a game. For you convenience you can setup a launcher on your windows manager to run the "xkegs". 
   

I admit I do not know how to play Black Magic. This is the screenshot anyway (please click to enlarge).

xapple2

Apple2 and Xapple2 are packages maintained in Ubuntu repository so that you have no trouble to compile. You still need a set of ROM files.

(to be continued)