https://github.com/libretro/dosbox-libretro

Port of DOSBox (upstream) to the libretro API.
https://github.com/libretro/dosbox-libretro

Last synced: about 1 year ago
JSON representation

Port of DOSBox (upstream) to the libretro API.

• Host: GitHub
• URL: https://github.com/libretro/dosbox-libretro
• Owner: libretro
• License: gpl-2.0
• Created: 2012-10-24T21:30:24.000Z (over 13 years ago)
• Default Branch: master
• Last Pushed: 2022-11-09T07:37:07.000Z (over 3 years ago)
• Last Synced: 2025-06-08T10:51:31.348Z (about 1 year ago)
• Language: C++
• Homepage:
• Size: 1.96 MB
• Stars: 62
• Watchers: 15
• Forks: 40
• Open Issues: 54
• Metadata Files:
  • Readme: README
  • Changelog: ChangeLog
  • License: COPYING

Awesome Lists containing this project

README

          
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.

* 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:

* Physical CD-ROMs, CD images are supported.

* The key mapper, key remapping does not work.

TODO:

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

Building:

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

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]

mpu401=intelligent

mididevice=mt32