Skip to content
Henrique Lechner edited this page Jul 8, 2019 · 4 revisions

DOSBox is an x86 PC DOS-emulator for running old DOS games or programs.

GameHub does support DOSBox.

Table of Contents

Install

To use the DOSBox on your GameHub make sure that you have the DOSBox installed on your linux distribution.

If not, here is the command to install it on Ubuntu or Arch Linux:

  • Ubuntu: sudo apt-get install dosbox
    • Make sure you have the Universe repositories enabled
  • Arch Linux: sudo pacman -S dosbox

Add a DOSBox Game to GameHub

Add the game to the List

Install the game through the store

If the game that you want is already on your game list, just right click > Install.

image

If not, see Add the game manually.

Add the game manually

You can add the game manually:

Click on the top right "+" button:

image

Name: This name will be displayed on GameHub, choose whatever name you want

Executable: Choose the game's executable file

Arguments: Left it empty

Directory: Don't worry, it will be filled after you choose a file on executable field

Then click on Add Game Button

Enable DOSBox on it

Once added, go to game properties (right click on the game > Properties): image

  • Enable the Force Compatibility Mode
  • Select the DOSBox on Compatibility layer.

That's it, you are ready to play.

Note: if DOSBox is not listed on Compatibility layer, see Troubleshooting for more details.

Troubleshooting

DOSBox not detected

Make sure DOSBox is properly installed on your system.

DOSBox is executed by dosbox command, it must be on $PATH to be detected.

Old GOG Installers

Some old DOSBox game installers from GOG (maybe not limited to GOG) had a different way to call files inside it's .conf.

The old installers call files from the same directory of it's .conf file: ..

The new installer otherwise call files from the DOSBOX folder: ...

GameHub detects when the DOSBOX directory exists and start to use it as game directory to work with the new installers.

To make the old versions working just rename the DOSBOX folder to something else or just delete it.

.conf not properly configured

Most of games packed with DOSBox already have the DOSBox .conf file, if it exists, GameHub will launch the game with this file.

If the .conf file is not properly configured the game will probably fail to start, In this case take a look in the file itself, specially on [autoexec] section where the commands to be executed will be listed.

For more details on dosbox commands please access the DOSBox wiki:

No .conf file

GameHub doesn't require a .conf, but if you need to execute specific commands maybe you want to create a .conf yourself:

Create the file:

Open the terminal, go to the game directory and run dosbox:

$ dosbox

On dosbox run the following command:

Z:\> config -wc dosbox.conf

Configure the conf file:

Open dosbox.conf file with a text editor.

The last lines will look like this:

[autoexec]
# Lines in this section will be run at startup.
# You can put your MOUNT lines here.

After these lines is important to add the mount points and the file to be executed.

The game Pizza Tycoon would have the following lines:

MOUNT C "."
C:
CALL PIZZA.BAT
EXIT