vscode-DOSBox
Offer an Interface for running DOSBox and its variants in your platform.
- JSDos: all platform including web
- DOSBox: binaries packaged for windows system, need to install manually for other OS
- DOSBox-x: binaries packaged for windows system, need to install manually for other OS
- MSDos-player: only runs in windows system and binaries packaged
Features
- offer commands for open supported platform
- offer API for other extensions: see api.ts
- (TODO) use this extension for DOS game playing
Dependency Installation
for Windows
All binary files for windows system haven been packaged in the extension,
Install DOSBox and DOSBox-x for macOS via homebrew (recommend)
brew install dosbox
brew install dosbox-x
Install DOSBox for macOS via packages
- download DMG file from dosbox's website
- click to open the dmg file
- drag the application to
/Applications
folder
- set the following settings in your VSCode's setting
"vscode-dosbox.command.dosbox":"open -a dosbox --args",
Install DOSBox-x for macOS via packages
- download ZIP file for macOS from dosbox-x's website
- Unzip the file and drag your
.app
file to /Applications
folder
- follow this macOS's doc to set up security settings
- Go to Security & Privacy
- Click the Open Anyway button in the General pane to confirm your intent to open or install the app
- set the following setting in your VSCode's settings
"vscode-dosbox.command.dosboxX":"open -a dosbox-x --args",
Install DOSBox for Linux
for example,
sudo apt install dosbox
For more, see DOSBox's website
Install DOSBox-x for Linux
according to dosbox-x's instructions,
we can use flatpak to install DOSBox-X.
# install flatpak
sudo apt install flatpak
# use flatpak to install DOSBox-X
flatpak install flathub com.dosbox_x.DOSBox-X
then set the following setting in your VSCode's settings
"vscode-dosbox.command.dosboxX":"flatpak run com.dosbox_x.DOSBox-X",
you may need to change output of SDL for better screen effect
"vscode-dosbox.dosbox.config": {
"SDL.output":"overlay",
}
Extension Settings
This extension contributes the following settings:
vscode-dosbox.command.dosbox
: customize your command to open dosbox
vscode-dosbox.command.dosboxX
: customize your command to open dosbox-x
Report
report bugs in github issues
Known Issues
Calling out known issues can help limit users opening duplicate issues against your extension.
Release Notes