js-dos

The simplest API to run DOS/Win 9x programs in browser or node.

js-dos is a frontend for emulators that provides nice UI and infrastructure to run DOS or Windows programs in browser.

It provides full-featured DOS player that can be easily installed and used to get your DOS program up and running in browser quickly. js-dos provides many advanced features like multiplayer, save/load, and large disk streaming. All available features are enabled for any integration and free.

The unique capabilities:

• The only browser solution with accelerated 3Dfx rendering through a WebGL-backed renderer
• Full IPX networking stack in browser, powered by WebRTC-NET, with IPX server creation, direct peer/alias connections, and shared network instances
• Windows 9x support through DOSBox-X, including prebuilt Windows 95/98 system images and support for Windows games with DirectX and 3Dfx drivers
• Sockdrive V2 for large disk images: backendless streaming drives, preload modes, and improved persistence handling
• Modern local persistence based on OPFS, with local filesystem changes, storage usage information, and fsChanges hooks for custom save storage

The key features:

• Works in worker or render thread
• Support execution in Node and Browsers
• Multiple backends: DOSBox, DOSBox-X
• Mobile support (v8 - WIP, v7 - production)
• Able to run huge games (like Diablo, etc.)
• Multiplayer support
• Save/load support with local persistence and custom storage integrations
• WebAssembly and pure JS versions
• AudioWorklet mode and experimental JSPI backend support
• Turbo controls with CPU metrics, speed, cycles, fast forward, and frame skip controls

If you want to build custom DOS player, then please use emulators packages instead.

Demo

• DOS.Zone - community portal with 1900+ dos games
• 3Dfx
• Multiplayer
• NFS
• Age Of Empries II

Documentation

• js-dos 8.xx
• js-dos 7.xx
• js-dos 6.22
• js-dos 3.xx

Support

Development

1. You need to install node dependencies and put emulators into public/emulators.

yarn
cp -rv node_modules/emulators/dist/* public/emulators

2. Run yarn run vite and open http://localhost:3000 js-dos is ready!

Community

• DOS.Zone
• Discord
• Twitter
• Telegram