Running Doom and Heretic


You can buy either:

  1. Doom Complete on Steam.
  2. Doom and Doom II from GOG.

The GameShell only needs the WAD files you get after installing Doom on your PC.

Also you can buy:

  1. Heretic on Steam.
  2. Heretic + Hexen Collection on Steam.

The Hexen Collection also contains Hexen II. See my post below how to get that running!


The GameShell has the following chocolates out of the box :grin::

  • chocolate-doom
  • chocolate-heretic
  • chocolate-hexen

This is for games based on a DOOM engine (including Hexen).
Hexen II however uses a modified Quake engine.

So, steps for Hexen II:

  1. Append ‘contrib’ to your main repository in /etc/apt/sources.list:
sudo sed -i -- '/^deb .*stretch main$/ s/$/ contrib/' /etc/apt/sources.list

The /etc/apt/sources.list should now look like this (assuming you have not yet set the repo to your own country):

# deb stretch main

deb stretch main contrib
deb-src stretch main

deb stretch/updates main
deb-src stretch/updates main

# stretch-updates, previously known as 'volatile'
deb stretch-updates main
deb-src stretch-updates main
  1. Install the game engine called “Hammer of Thyrion” (uHexen2):
sudo apt update && sudo apt -y install uhexen2
  1. Make a new game folder for Hexen II like this:
mkdir -p /home/cpi/games/Hexen2/data1/
  1. Copy your purchased pak0.pak and pak1.pak of Hexen II to that data1/ folder.

  2. Create a launch script like this:

cd /home/cpi/apps/launcher/Menu/GameShell/
echo 'mkdir -p ~/.hexen2' > 'Hexen'
echo 'ln -s ~/games/Hexen2/data1 ~/.hexen2/' >> 'Hexen'
echo 'hexen2 -f -width 320 -height 240' >> 'Hexen'
echo 'unlink ~/.hexen2/data1' >> 'Hexen'
  1. Reboot and set the controls in-game!

Please tell me the performance and how to get music in-game. :smiley:


Did you trie this ?
I believe the GS can run this engine and textures, but I’m not shure what version of OpenGl GS has.


As far as I know the GameShell does not support OpenGL. I haven’t tried GZDoom (or even ZDoom). Why do you believe the GS can run OpenGL?


I followed the instructions and all I get is "IWAD file ‘/home/cpi/games/Doom/doom.wad’ not found!

Same for Doom 2. I am using the latest wad files I’ve had for over 20 years.

Pretty sure the files are in the right place.


It might be pwads and not iwads. Can’t share mine due to copyright.

Did some looking around online and found this converter utility. Haven’t tried it. Let me know if this helps.


In the hidden config file of chocolate-doom where can I remap the light key? I only know they are ‘H’, ‘Y’, ‘Shift’, ‘O’ and ‘L’. I would appreciate if someone explain me.