Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 21 additions & 11 deletions README → README.md
Original file line number Diff line number Diff line change
@@ -1,29 +1,39 @@
libretro wrapper for DOSBox
# libretro wrapper for DOSBox

* To use you can either load an exe/com/bat file or a *.conf file.
* If loading exe/com/bat the system directory will be searched for a 'dosbox.conf' file to load. If one isn't available default values will be used. This mode is equivalent to running a DOSBox binary with the specified file as the command line argument.
This core is obsolete. Please use [DOSBox Pure](https://github.com/schellingb/dosbox-pure/) or [DOSBox-SVN](https://github.com/libretro/dosbox-svn) instead. No pull requests will be granted for this project.

<hr />

* To use you can either load an exe/com/bat file or a \*.conf file.
* If loading exe/com/bat the system directory will be searched for a *dosbox.conf* file to load. If one isn't available default values will be used. This mode is equivalent to running a DOSBox binary with the specified file as the command line argument.
* If loading a conf file DOSBox will be loaded with the options in the config file. This mode is useful if you just want to be dumped at a command prompt, but can also be used to load a game by putting commands in the autoexec section.
* To be useful the frontend will need to have keyboard+mouse support, and all keyboard shortcuts need to be remapped.

Unsupported features:
## Unsupported features:

* Physical CD-ROMs, CD images are supported.
* The key mapper, key remapping does not work.

TODO:
## TODO:

* Joysticks need more testing. Flightsticks types are not implemented yet.

Building:
## Building:

* To build for your current platform "cd */libretro-dosbox (ENTER) make (ENTER)"
* To build for your current platform:

Notes:
```
cd */libretro-dosbox
make
```

## Notes:

* There seems to be no trivial way to have the DOSBox core return periodically, so libco is used to enter/exit the emulator loop. This actually works better than one would expect.
* There is no serialization support, it's not supported by DOSBox.
* DOSBox uses 'wall time' for timing, frontend fast forward and slow motion features will have no effect.
* To use MIDI you need MT32_CONTROL.ROM and MT32_PCM.ROM in the system directory of RetroArch.Then set:
[midi]
* To use MIDI you need MT32_CONTROL.ROM and MT32_PCM.ROM in the system directory of RetroArch. Then set:

<pre>[midi]
mpu401=intelligent
mididevice=mt32
mididevice=mt32</pre>