Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

THS Web DOSBox

A simple user interface for JS-DOS (a port of DOSBox for browsers); made originally for showcasing Tarpeeksi Hyvae Soft's DOS programs on the web.

This app provides the following:

  1. A JavaScript API for defining a set of containerized DOS programs
  2. A URL hash interface for running one of the containerized programs in JS-DOS (e.g. http://localhost/dosbox/#quake)
  3. A styled HTML container for the JS-DOS canvas with dynamic resizing to an integer multiple

Usage

Defining the containers

The following JavaScript file defines a set of DOS program containers.

export default {
    "quake": {
        title: "Quake",
        zip: "./content/quake.zip",
        run: "quake.exe",
    },

    "big-red-racing": {
        title: "Big Red Racing",
        zip: "./content/brr.zip",
        run: "racing.exe",
    },

    undefined: {
        // This container will be loaded if no others match the request. 
    }
};

The zip property gives the name of the ZIP file containing the program's data and executables as well as a dosbox.conf file providing the DOSBox parameters (e.g. cycles count) to be used when running the program.

The title property gives a string to be shown in the browser's title bar while running this program.

The run property sets the command to be executed in DOSBox to run the program.

Running a container

With the containers as defined above and the app hosted at http://localhost/dosbox/, you can run Quake by accessing the URL http://localhost/dosbox/#quake.

The app will fetch the ./content/quake.zip file, load its contents into JS-DOS, and execute the quake.exe command inside JS-DOS.

About

No description, website, or topics provided.

Resources

License