Keen 4 for AmigaOS 68k
----------------------

Commander Keen 4 v1.4 EGA for AmigaOS 68k

Build only for 68040/FPU, RTG and AHI. Tested on Pistorm, other accelerators
may work.

0.1.0: gameplay, sound, joystick and save/load work on an A1200 with
PiStorm32-Lite and CM4. No full playthrough yet tho

Reports and feedback welcome, please include your hardware and any problems
you encounter, either in the GitHub issues or on the Emu68 Hatcher Discord

https://github.com/rootrootde/keen4-amiga
https://discord.com/invite/ApTbasXJPE

Required game files
-------------------

IMPORTANT: Game data is not included in the Amiga package. Download the
Commander Keen 4 v1.4 EGA shareware archive (4keen14.zip)
(https://davidgow.net/keen/4keen14.zip) separately. This build requires that
version; the GT software version is NOT compatible.

Only these three files are needed from the ZIP:

File          Size in bytes
AUDIO.CK4     33,325
EGAGRAPH.CK4  520,581
GAMEMAPS.CK4  99,040

With the installer, select the 4keen14.zip as downloaded. It extracts these
files and checks their sizes. For a manual installation you can extract them
yourself and copy them into  the game drawer, beside omnispeak. The other
support files are already included in the Amiga package.

Install
-------

Choose either method below

Installer
---------

Requires Installer 43.3+, UnZip and IconX on the Amiga, plus about
700 kB free in T:

Installer: util/misc/Installer-43_3.lha
UnZip:     util/arc/UnZIP552.lha

1. Extract keen4.lha
2. Doubleblick Install and choose Intermediate User. Select a parent drawer;
   the installer creates Keen4 inside it.
3. Select the downloaded 4keen14.zip, without extracting it first. Unzip is
   detected automatically, or you will be asked for its location
4. Open Keen4 and double-click Start-Keen4.

Manual
------

Requires tools to extract LHA and ZIP archives, either on the Amiga or another
computer. Installer is not needed. IconX is only needed to start the game by
doubleclicking its icon

1. Extract keen4.lha into a writable drawer on your Amiga, or extract it
   elsewhere and copy the drawer over. Keep the program and its support files
   together.
2. Extract AUDIO.CK4, EGAGRAPH.CK4 and GAMEMAPS.CK4 from 4keen14.zip and copy
   them beside omnispeak.
3. Double-click Start-Keen4, or open a Shell in the game drawer and run
   Execute Start-Keen4. Use Execute Start-Keen4-NoSound to start without
   audio.

Controls
--------

Action      Keyboard    Joystick
Move        Arrow keys  Joystick
Jump        Ctrl        Button 0
Pogo        Alt         Button 1
Fire        Space       Button 2
Menu        Esc         Button 3
Status      Enter       Button 4
Quick-save  F5          Button 5
Quick-load  F9          Button 6

For two-button firing, open Main Menu > Configure > Options and set Two-Button
Firing to ON.

Joysticks and gamepads with more than two buttons have not been tested.

Sound settings
--------------

Sound uses AHI Unit 0 by default, at 22050 Hz in mono. Audio settings can be
changed in OMNISPK.CFG:

sampleRate = 22050 # sample rate in Hz
audioChannels = 1 # no. of channels (1 = mono  2 = stereo)
audioBufferSamples = 512 # buffer size

The buffer size is measured in samples. A larger buffer may reduce audio
dropouts but increases latency.

Credits
-------

Based on Omnispeak (https://github.com/sulix/omnispeak). See AUTHORS and
LICENSE for credits and licensing, and upstream/README for original
documentation.

The release archive includes engine and SDL source in source/.

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                 7686   56034  13.7% -lh5- 51aa Jan  1  2026 keen4-amiga/ACTION.CK4
[generic]                   15      15 100.0% -lh0- ef94 Jan  1  2026 keen4-amiga/AUDINFOE.CK4
[generic]                  742    1024  72.5% -lh5- 7707 Jan  1  2026 keen4-amiga/AUDIODCT.CK4
[generic]                  274     652  42.0% -lh5- 57b8 Jan  1  2026 keen4-amiga/AUDIOHHD.CK4
[generic]                  250     411  60.8% -lh5- 0981 Jan  1  2026 keen4-amiga/AUTHORS
[generic]                 6410   12867  49.8% -lh5- 960f Jan  1  2026 keen4-amiga/build.json
[generic]                  742    1024  72.5% -lh5- d582 Jan  1  2026 keen4-amiga/EGADICT.CK4
[generic]                 9839   14256  69.0% -lh5- 9f6f Jan  1  2026 keen4-amiga/EGAHEAD.CK4
[generic]                 3673   11449  32.1% -lh5- f7ba Jan  1  2026 keen4-amiga/EPISODE.CK4
[generic]                 4024   15429  26.1% -lh5- d321 Jan  1  2026 keen4-amiga/GFXCHUNK.CK4
[generic]                   47      47 100.0% -lh0- 7c6c Jan  1  2026 keen4-amiga/GFXINFOE.CK4
[generic]                 1614    5552  29.1% -lh5- a02c Jan  1  2026 keen4-amiga/Install
[generic]                 1735    8484  20.5% -lh5- 1ea1 Jan  1  2026 keen4-amiga/Install.info
[generic]                 6996   18092  38.7% -lh5- a33a Jan  1  2026 keen4-amiga/LICENSE
[generic]                 9637   26526  36.3% -lh5- e336 Jan  1  2026 keen4-amiga/licenses/LGPL-2.1.txt
[generic]                  258     424  60.8% -lh5- 4bc8 Jan  1  2026 keen4-amiga/licenses/SDL-README.txt
[generic]                 7257   21404  33.9% -lh5- 3141 Jan  1  2026 keen4-amiga/manifest.json
[generic]                   92     402  22.9% -lh5- b6e0 Jan  1  2026 keen4-amiga/MAPHEAD.CK4
[generic]               323948  721612  44.9% -lh5- 074e Jan  1  2026 keen4-amiga/omnispeak
[generic]                 1818    3647  49.8% -lh5- 5204 Jan  1  2026 keen4-amiga/README
[generic]                  250     411  60.8% -lh5- 0981 Jan  1  2026 keen4-amiga/source/AUTHORS
[generic]                 7686   56034  13.7% -lh5- 51aa Jan  1  2026 keen4-amiga/source/data/keen4/ACTION.CK4
[generic]                   15      15 100.0% -lh0- ef94 Jan  1  2026 keen4-amiga/source/data/keen4/AUDINFOE.CK4
[generic]                  742    1024  72.5% -lh5- 7707 Jan  1  2026 keen4-amiga/source/data/keen4/AUDIODCT.CK4
[generic]                  274     652  42.0% -lh5- 57b8 Jan  1  2026 keen4-amiga/source/data/keen4/AUDIOHHD.CK4
[generic]                  742    1024  72.5% -lh5- d582 Jan  1  2026 keen4-amiga/source/data/keen4/EGADICT.CK4
[generic]                 9839   14256  69.0% -lh5- 9f6f Jan  1  2026 keen4-amiga/source/data/keen4/EGAHEAD.CK4
[generic]                 3673   11449  32.1% -lh5- f7ba Jan  1  2026 keen4-amiga/source/data/keen4/EPISODE.CK4
[generic]                 4024   15429  26.1% -lh5- d321 Jan  1  2026 keen4-amiga/source/data/keen4/GFXCHUNK.CK4
[generic]                   47      47 100.0% -lh0- 7c6c Jan  1  2026 keen4-amiga/source/data/keen4/GFXINFOE.CK4
[generic]                   92     402  22.9% -lh5- b6e0 Jan  1  2026 keen4-amiga/source/data/keen4/MAPHEAD.CK4
[generic]                 2257    5824  38.8% -lh5- f255 Jan  1  2026 keen4-amiga/source/data/keen4/STRINGS.CK4
[generic]                 1635   23004   7.1% -lh5- a0b2 Jan  1  2026 keen4-amiga/source/data/keen4/TILEINFO.CK4
[generic]                 6996   18092  38.7% -lh5- a33a Jan  1  2026 keen4-amiga/source/LICENSE
[generic]                  230     726  31.7% -lh5- 2306 Jan  1  2026 keen4-amiga/source/Makefile
[generic]                  569    1012  56.2% -lh5- 50c2 Jan  1  2026 keen4-amiga/source/README-BUILD.txt
[generic]                 2192    5367  40.8% -lh5- d25b Jan  1  2026 keen4-amiga/source/scripts/build-amiga.sh
[generic]                  820    1478  55.5% -lh5- dfb5 Jan  1  2026 keen4-amiga/source/scripts/build-sdl.sh
[generic]                  659    1095  60.2% -lh5- bcc8 Jan  1  2026 keen4-amiga/source/scripts/relink-amiga.sh
[generic]                 1101    3213  34.3% -lh5- 13dc Jan  1  2026 keen4-amiga/source/src/ck4_ep.h
[generic]                 1528    4021  38.0% -lh5- 0131 Jan  1  2026 keen4-amiga/source/src/ck4_map.c
[generic]                 4917   20862  23.6% -lh5- bbf2 Jan  1  2026 keen4-amiga/source/src/ck4_misc.c
[generic]                 3539   17225  20.5% -lh5- 4a89 Jan  1  2026 keen4-amiga/source/src/ck4_obj1.c
[generic]                 4674   21577  21.7% -lh5- c983 Jan  1  2026 keen4-amiga/source/src/ck4_obj2.c
[generic]                 4720   21801  21.7% -lh5- 93e7 Jan  1  2026 keen4-amiga/source/src/ck4_obj3.c
[generic]                 1041    2772  37.6% -lh5- e98a Jan  1  2026 keen4-amiga/source/src/ck5_ep.h
[generic]                 3059    9006  34.0% -lh5- 3f05 Jan  1  2026 keen4-amiga/source/src/ck5_map.c
[generic]                 5562   20074  27.7% -lh5- efd3 Jan  1  2026 keen4-amiga/source/src/ck5_misc.c
[generic]                 1744    6157  28.3% -lh5- b90a Jan  1  2026 keen4-amiga/source/src/ck5_obj1.c
[generic]                 3647   17552  20.8% -lh5- a989 Jan  1  2026 keen4-amiga/source/src/ck5_obj2.c
[generic]                 9286   43207  21.5% -lh5- fd0b Jan  1  2026 keen4-amiga/source/src/ck5_obj3.c
[generic]                  991    2699  36.7% -lh5- babb Jan  1  2026 keen4-amiga/source/src/ck6_ep.h
[generic]                  818    1629  50.2% -lh5- a111 Jan  1  2026 keen4-amiga/source/src/ck6_map.c
[generic]                 3466   12736  27.2% -lh5- 159c Jan  1  2026 keen4-amiga/source/src/ck6_misc.c
[generic]                 4602   22236  20.7% -lh5- 57e5 Jan  1  2026 keen4-amiga/source/src/ck6_obj1.c
[generic]                 4550   21003  21.7% -lh5- 26ec Jan  1  2026 keen4-amiga/source/src/ck6_obj2.c
[generic]                 2571   11560  22.2% -lh5- d8ee Jan  1  2026 keen4-amiga/source/src/ck6_obj3.c
[generic]                 4595   20894  22.0% -lh5- 3e4a Jan  1  2026 keen4-amiga/source/src/ck_act.c
[generic]                 1307    3721  35.1% -lh5- 979a Jan  1  2026 keen4-amiga/source/src/ck_act.h
[generic]                 1404    4461  31.5% -lh5- 9301 Jan  1  2026 keen4-amiga/source/src/ck_amiga_test.c
[generic]                  131     182  72.0% -lh5- 9f10 Jan  1  2026 keen4-amiga/source/src/ck_amiga_test.h
[generic]                 1993    4783  41.7% -lh5- 370c Jan  1  2026 keen4-amiga/source/src/ck_config.h
[generic]                 1222    3419  35.7% -lh5- 8394 Jan  1  2026 keen4-amiga/source/src/ck_cross.c
[generic]                 1448    3697  39.2% -lh5- 9a29 Jan  1  2026 keen4-amiga/source/src/ck_cross.h
[generic]                 4918   12629  38.9% -lh5- 0c43 Jan  1  2026 keen4-amiga/source/src/ck_def.h
[generic]                  826    1462  56.5% -lh5- 69bb Jan  1  2026 keen4-amiga/source/src/ck_ep.h
[generic]                 8196   30838  26.6% -lh5- 78ae Jan  1  2026 keen4-amiga/source/src/ck_game.c
[generic]                  596    1021  58.4% -lh5- f0c5 Jan  1  2026 keen4-amiga/source/src/ck_game.h
[generic]                15522   46406  33.4% -lh5- 7c21 Jan  1  2026 keen4-amiga/source/src/ck_inter.c
[generic]                13087   56021  23.4% -lh5- 69be Jan  1  2026 keen4-amiga/source/src/ck_keen.c
[generic]                 9195   28317  32.5% -lh5- 922f Jan  1  2026 keen4-amiga/source/src/ck_main.c
[generic]                 5883   20284  29.0% -lh5- 9099 Jan  1  2026 keen4-amiga/source/src/ck_map.c
[generic]                 3626   12490  29.0% -lh5- 92e0 Jan  1  2026 keen4-amiga/source/src/ck_misc.c
[generic]                 4015   15227  26.4% -lh5- 2298 Jan  1  2026 keen4-amiga/source/src/ck_obj.c
[generic]                 6129   26736  22.9% -lh5- ca51 Jan  1  2026 keen4-amiga/source/src/ck_phys.c
[generic]                  932    2550  36.5% -lh5- f89c Jan  1  2026 keen4-amiga/source/src/ck_phys.h
[generic]                16958   59581  28.5% -lh5- 562f Jan  1  2026 keen4-amiga/source/src/ck_play.c
[generic]                 1007    2163  46.6% -lh5- 31b7 Jan  1  2026 keen4-amiga/source/src/ck_play.h
[generic]                 1362    2592  52.5% -lh5- 8a12 Jan  1  2026 keen4-amiga/source/src/ck_quit.c
[generic]                 5185   15970  32.5% -lh5- c180 Jan  1  2026 keen4-amiga/source/src/ck_text.c
[generic]                  534     886  60.3% -lh5- c712 Jan  1  2026 keen4-amiga/source/src/ck_text.h
[generic]                11508   45054  25.5% -lh5- 9ac3 Jan  1  2026 keen4-amiga/source/src/ck_us_2.c
[generic]                 1965   42424   4.6% -lh5- 207d Jan  1  2026 keen4-amiga/source/src/icon.c
[generic]                12100   41202  29.4% -lh5- 2a43 Jan  1  2026 keen4-amiga/source/src/id_ca.c
[generic]                 1676    4163  40.3% -lh5- 7a73 Jan  1  2026 keen4-amiga/source/src/id_ca.h
[generic]                 3075   10434  29.5% -lh5- f130 Jan  1  2026 keen4-amiga/source/src/id_cfg.c
[generic]                  739    1729  42.7% -lh5- fd14 Jan  1  2026 keen4-amiga/source/src/id_cfg.h
[generic]                 4372   15625  28.0% -lh5- 2c2a Jan  1  2026 keen4-amiga/source/src/id_fs.c
[generic]                 1377    3355  41.0% -lh5- b8da Jan  1  2026 keen4-amiga/source/src/id_fs.h
[generic]                  575    1053  54.6% -lh5- d82c Jan  1  2026 keen4-amiga/source/src/id_heads.h
[generic]                 8088   26656  30.3% -lh5- 2ce0 Jan  1  2026 keen4-amiga/source/src/id_in.c
[generic]                 3093    8363  37.0% -lh5- e143 Jan  1  2026 keen4-amiga/source/src/id_in.h
[generic]                 1549    3844  40.3% -lh5- ba54 Jan  1  2026 keen4-amiga/source/src/id_in_dos.c
[generic]                  886    1952  45.4% -lh5- 22c2 Jan  1  2026 keen4-amiga/source/src/id_in_null.c
[generic]                 4189   17641  23.7% -lh5- 3b04 Jan  1  2026 keen4-amiga/source/src/id_in_sdl.c
[generic]                 3182   11271  28.2% -lh5- e430 Jan  1  2026 keen4-amiga/source/src/id_in_sdl3.c
[generic]                 3230    9504  34.0% -lh5- ce6c Jan  1  2026 keen4-amiga/source/src/id_mm.c
[generic]                  895    1894  47.3% -lh5- 5090 Jan  1  2026 keen4-amiga/source/src/id_mm.h
[generic]                10834   42357  25.6% -lh5- d75e Jan  1  2026 keen4-amiga/source/src/id_rf.c
[generic]                 1478    3746  39.5% -lh5- 2dc8 Jan  1  2026 keen4-amiga/source/src/id_rf.h
[generic]                 5554   19110  29.1% -lh5- 0488 Jan  1  2026 keen4-amiga/source/src/id_sd.c
[generic]                 1360    3139  43.3% -lh5- d763 Jan  1  2026 keen4-amiga/source/src/id_sd.h
[generic]                 1894    4877  38.8% -lh5- 82f1 Jan  1  2026 keen4-amiga/source/src/id_sd_dos.c
[generic]                 2247    5733  39.2% -lh5- 30ba Jan  1  2026 keen4-amiga/source/src/id_sd_liboplhw.c
[generic]                 1388    2922  47.5% -lh5- 8ec9 Jan  1  2026 keen4-amiga/source/src/id_sd_null.c
[generic]                 1976    4862  40.6% -lh5- 522d Jan  1  2026 keen4-amiga/source/src/id_sd_opl2.c
[generic]                 3436   11061  31.1% -lh5- 3dec Jan  1  2026 keen4-amiga/source/src/id_sd_opl2alsa.c
[generic]                 2508    7160  35.0% -lh5- 3345 Jan  1  2026 keen4-amiga/source/src/id_sd_opl2lpt.c
[generic]                 7233   25022  28.9% -lh5- 3e43 Jan  1  2026 keen4-amiga/source/src/id_sd_sdl.c
[generic]                 5824   19772  29.5% -lh5- dd8d Jan  1  2026 keen4-amiga/source/src/id_sd_sdl3.c
[generic]                 2823    8648  32.6% -lh5- 4d61 Jan  1  2026 keen4-amiga/source/src/id_str.c
[generic]                 1239    2951  42.0% -lh5- 02ed Jan  1  2026 keen4-amiga/source/src/id_str.h
[generic]                  942    3133  30.1% -lh5- 638a Jan  1  2026 keen4-amiga/source/src/id_ti.c
[generic]                  593    1202  49.3% -lh5- b7fa Jan  1  2026 keen4-amiga/source/src/id_ti.h
[generic]                 2661    6512  40.9% -lh5- 5b42 Jan  1  2026 keen4-amiga/source/src/id_us.h
[generic]                 8016   24485  32.7% -lh5- 8c10 Jan  1  2026 keen4-amiga/source/src/id_us_1.c
[generic]                 7799   27648  28.2% -lh5- c339 Jan  1  2026 keen4-amiga/source/src/id_us_2.c
[generic]                 2497    6959  35.9% -lh5- 15c5 Jan  1  2026 keen4-amiga/source/src/id_us_textscreen.c
[generic]                 2938   12504  23.5% -lh5- ef19 Jan  1  2026 keen4-amiga/source/src/id_vh.c
[generic]                 1116    3449  32.4% -lh5- 6c9b Jan  1  2026 keen4-amiga/source/src/id_vh.h
[generic]                 6072   32471  18.7% -lh5- 71d8 Jan  1  2026 keen4-amiga/source/src/id_vl.c
[generic]                 1985    8451  23.5% -lh5- 8970 Jan  1  2026 keen4-amiga/source/src/id_vl.h
[generic]                 6898   32007  21.6% -lh5- 7c97 Jan  1  2026 keen4-amiga/source/src/id_vl_dos.c
[generic]                 1793    8066  22.2% -lh5- 8fe6 Jan  1  2026 keen4-amiga/source/src/id_vl_null.c
[generic]                 1826    4880  37.4% -lh5- 07a4 Jan  1  2026 keen4-amiga/source/src/id_vl_private.h
[generic]                 2932   13130  22.3% -lh5- b92e Jan  1  2026 keen4-amiga/source/src/id_vl_sdl12.c
[generic]                 3662   14726  24.9% -lh5- 0843 Jan  1  2026 keen4-amiga/source/src/id_vl_sdl2.c
[generic]                 7079   31164  22.7% -lh5- 8f8f Jan  1  2026 keen4-amiga/source/src/id_vl_sdl2gl.c
[generic]                16991   77365  22.0% -lh5- 406f Jan  1  2026 keen4-amiga/source/src/id_vl_sdl2vk.c
[generic]                 3784   15619  24.2% -lh5- 97b9 Jan  1  2026 keen4-amiga/source/src/id_vl_sdl3.c
[generic]                 6183   24338  25.4% -lh5- 36cd Jan  1  2026 keen4-amiga/source/src/id_vl_sdl3gpu.c
[generic]                  285     490  58.2% -lh5- a12c Jan  1  2026 keen4-amiga/source/src/id_vl_vk_shader.frag
[generic]                  242     482  50.2% -lh5- a622 Jan  1  2026 keen4-amiga/source/src/id_vl_vk_shader.vert
[generic]                 5694   17200  33.1% -lh5- ad59 Jan  1  2026 keen4-amiga/source/src/Makefile
[generic]                 1189    2436  48.8% -lh5- 9853 Jan  1  2026 keen4-amiga/source/src/Makefile.osx
[generic]                13830   48988  28.2% -lh5- e395 Jan  1  2026 keen4-amiga/source/src/opl/dbopl.c
[generic]                 2341    5763  40.6% -lh5- 86a7 Jan  1  2026 keen4-amiga/source/src/opl/dbopl.h
[generic]                 9637   26526  36.3% -lh5- e336 Jan  1  2026 keen4-amiga/source/src/opl/NUKEDOPL3-LICENSE
[generic]                15087   61169  24.7% -lh5- ec1c Jan  1  2026 keen4-amiga/source/src/opl/nuked_opl3.c
[generic]                 3663    9460  38.7% -lh5- f082 Jan  1  2026 keen4-amiga/source/src/opl/nuked_opl3.h
[generic]                 8691   74471  11.7% -lh5- 774b Jan  1  2026 keen4-amiga/source/src/opl/nuked_wf_rom.h
[generic]                  318     668  47.6% -lh5- e088 Jan  1  2026 keen4-amiga/source/src/windowsres.rc
[generic]              4333708 4336564  99.9% -lh5- a3c5 Jan  1  2026 keen4-amiga/source/third_party/SDL-1.2.16-source.tar.gz
[generic]                 2931    6305  46.5% -lh5- e656 Jan  1  2026 keen4-amiga/source/upstream/README
[generic]                   52      52 100.0% -lh0- 60a0 Jan  1  2026 keen4-amiga/Start-Keen4
[generic]                   61      61 100.0% -lh0- 5da7 Jan  1  2026 keen4-amiga/Start-Keen4-NoSound
[generic]                 1742    8466  20.6% -lh5- 9919 Jan  1  2026 keen4-amiga/Start-Keen4.info
[generic]                 2257    5824  38.8% -lh5- f255 Jan  1  2026 keen4-amiga/STRINGS.CK4
[generic]                 1635   23004   7.1% -lh5- a0b2 Jan  1  2026 keen4-amiga/TILEINFO.CK4
[generic]                 2931    6305  46.5% -lh5- e656 Jan  1  2026 keen4-amiga/upstream/README
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total       150 files 5206040 7102219  73.3%            Oct  1 00:14