Bundling Dosbox for itch.io

If you'd like to embed a playable version of your DOS game within your itch.io game page, try this.

Download this example game package. It should be playable through itch already!

Unzip it somewhere.

Test it by running a little webserver from that directory. I use Python's default webserver. Connect to whatever port it's hosting on to check it works.


Change logo/emularity_color_small.png if you want something different to show while it's downloading.

Update your c-drive.zip. It will be mounted as drive C within your dosbox environment. So create whatever folders you need and maybe a handy GO.BAT or START.BAT if you need to do multiple things.

Within your c-drive.zip there's a dosbox.conf. You can override settings here, like for memory or default cycles.

Change the Title and probably what command to run to start your comand. If you kept the standard c-drive.zip, you don't need to change the drive option.

Zip up the index file, the js directory, the c-drive.zip and logo into one big zip file. Make sure everything is in the root.

Go to your itch.io game and edit it.

You want to change the game type to HTML (don't worry, you won't lose your files)

Upload the new bundle and select "This file will be played in the browser". It helps if it is moved to the top of the list too.

Finally, you want to change your embed settings. Unless you change the defaults in dosbox.conf, it should be using a 2x scaler. So that would typically be 640x200 unless you enable aspect ratio correction.

In your game page, you may need to edit the theme to show screenshots again. Or to add a background to the embed so it doesn't look boring.