DOSee

   

If you enjoy DOSee, consider buying me a cup of coffee?

An MS-DOS emulator for the web.

DOSee is a front-end for an MS-DOS emulation ecosystem for the web. MS-DOS was the dominant personal computer platform from the 1980s until the mid-1990s, when it was superseded by Microsoft Windows. Emulating this platform allows tens of thousands of games, demos, and applications from this era to run in a web browser, both online and offline as a desktop web app.

DOSee provides only the user interface and installation process for an incredible emulation ecosystem. Many remarkable people have contributed to this ecosystem over many years. DOSee itself is a fork of The Emularity project started by the Internet Archive. EM-DOSBox, the core of this emulation, is a JavaScript port of DOSBox, the world's most popular MS-DOS emulator.

---

What's new

Updates are in CHANGES

Requirements

• A web browser that supports service workers.
  Current Chrome, Edge, Safari, or Firefox will work fine.
• A physical keyboard, as MS-DOS is a text-based operating system.
• Node.js or Docker

DOSee runs over an HTTP server, and it can not function over the file:/// browser protocol.

Instructions, download, build and serve

DOSee requires a build before it can serve to a web browser.

# clone DOSee
git clone git@github.com:bengarrett/DOSee.git
cd DOSee

# install dependencies & build
pnpm install

# serve DOSee over port 8086
pnpm run serve

Point a web browser to http://localhost:8086

Usage instructions provide detailed configuration options.

Editing the source JS or HTML

Note: DOSee is considered feature complete. For new features, consider forking the project.

If you edit the source files in src/ you will need to rebuild the application.

# change to the repo directory
cd DOSee

# re-build DOSee using your edits
pnpm run install

# serve the modified DOSee over port 8086
pnpm run serve

Point a web browser to http://localhost:8086

Due to the PWA offline feature, web browsers need to unregister the service workers to reflect any changes to the application code. There is a red Update DOSee and the service worker button on the index.html example that will do this and then reload the browser window. The eventListener code for this button can be found in the src/js/dosee-sw.js file.

License

1. DOSee is under a GPL-3.0 license.
2. Em-DOSBox located in src/emulator is under GPL-2.0 license.
3. src/disk_drives and src/dos_programs contain non-free software binaries for your convenience.

Similar projects

• js-dos The best API for running dos programs in a browser