https://www.pcgamingwiki.com/w/api.php?action=feedcontributions&user=174.93.75.115&feedformat=atomPCGamingWiki - User contributions [en]2024-03-29T13:01:19ZUser contributionsMediaWiki 1.35.7https://www.pcgamingwiki.com/w/index.php?title=DOSBox&diff=996111DOSBox2020-09-04T23:18:40Z<p>174.93.75.115: /* Essential improvements */</p>
<hr />
<div>{{Infobox non-game<br />
|cover = DOSBox logo.png<br />
|developers = <br />
{{Infobox game/row/developer|DOSBox Team}}<br />
|release dates= <br />
{{Infobox game/row/date|Windows|July 22, 2002}}<br />
{{Infobox game/row/date|Linux|July 22, 2002}}<br />
{{Infobox game/row/date|OS X|March 30, 2006}}<br />
|winehq = <br />
|wikipedia = DOSBox<br />
}}<br />
<br />
'''Key points'''<br />
{{++}} DOSBox allows DOS-based games to run properly on modern systems.<br />
{{++}} [[Digital_rights_management_(DRM)#Disc_check|CD check]] for game being emulated can be bypassed generally by coping CD contents to a folder and [https://www.dosbox.com/wiki/MOUNT mounting] said folder as a CDROM.<br />
<br />
'''General information'''<br />
{{mm}} [http://www.dosbox.com Official DOSBox site]<br />
{{mm}} [http://www.dosbox.com/wiki/Main_Page Official DOSBox wiki]<br />
<br />
==Essential improvements==<br />
===Graphical user interface===<br />
DOSBox does not use a graphical user interface. However, front ends such as [http://members.quicknet.nl/blankendaalr/dbgl/ DBGL] can be used.<br />
====[http://members.quicknet.nl/blankendaalr/dbgl/ Dos Box Game Launcher (DBGL)]====<br />
{{++}} Features a wizard to install games.<br />
{{++}} Dosbox preinstalled in version 0.74.<br />
{{++}} Can manage different Dosbox versions.<br />
{{++}} Supports Windows, Linux and MacOS.<br />
{{ii}} Requires Java Runtime Environment.<br />
====[http://dfendreloaded.sourceforge.net/ D-Fend Reloaded]====<br />
{{++}} Does not require DOSBox to be installed.<br />
{{--}} No longer maintained<br />
<br />
===Unofficial builds===<br />
{{cleanup|section|Way too many key points. Please consolidate them}}<br />
There are various unofficial builds, typically called forks, of DOSBox which provide additional functionality such as support for Glide. A full list can be found on the [http://www.dosbox.com/wiki/SVN_Builds#List_of_SVN_Builds DOSBox Wiki].<br />
<br />
A good one to start with is [https://dosbox-x.com DOSBox-X] ([https://github.com/joncampbell123/dosbox-x project on GitHub]). It streamlines the interface and adds support for features vanilla DOSBox cannot do such as Glide support.<br />
<br />
For Mac, you should try [http://boxerapp.com Boxer]. It makes running and installation of games easier by wrapping them in [https://en.wikipedia.org/wiki/Bundle_(macOS) Application Bundles], called "Game Boxes", that can be launched in Boxer by double clicking them as well as having a builtin GUI interface for configuration that more easily integrates into the Mac OS. It also has much over looked audio features; it already includes Gravis UltraSound patches and has builtin CM-32 & MT-32L emulation available through MUNT.<br />
<br />
Also, installing [http://www.freedos.org/download/ FreeDOS] (or just it's [http://www.freedos.org/software/ included utilities]) grants a more complete DOS experience.<br />
<br />
====[https://dosboxece.yesterplay.net/ DOSBox ECE (Enhanced Community Edition)]====<br />
Currently, DOSBox ECE differs from normal DOSBox in these features:<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=41&t=41853 Emulation of a 3Dfx Vooodoo card through OpenGL] (No external Glide wrapper needed!)<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=41&t=43899 4x, 5x and 6x scaling in windowed mode is possible]<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=32&t=49160 Pixel-perfect output mode] for undistorted scaling of the picture<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=41&t=49327 Improved emulation of OPL3] (a FM sound synthesis chip from Yamaha)<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=41&t=23371 Improved sound of PC speaker emulation]<br />
{{++}} [https://sourceforge.net/projects/munt/ Emulation of the Roland MT-32 midi synthesizer]<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=32&t=27831&start=20 Integration of Fluidsynth] (a software MIDI synthesizer with Soundfont support)<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=32&t=27452 Support for up to 10 joystick axis and 2 D-pads] (full use of two 360 compatible controllers)<br />
{{++}} [https://sourceforge.net/p/dosbox/patches/264/ Mouse buttons mappable to keyboard or controller buttons]<br />
{{++}} [https://sourceforge.net/p/dosbox/patches/276/ Separate sensitivity settings for the X and Y axis of the mouse]<br />
{{++}} Supports up to 384 MB of memory, required for running Windows 9x on top of DOSBox ECE<br />
{{++}} 4MB video memory, reducing sprite flickering in games using the Build engine (“Duke Nukem 3D”, “Blood”, etc.)<br />
<br />
The DOSBox ECE developer also hosts compiled versions of the latest DOSBox SVN (development builds of the official DOSBox) on his website.<br />
<br />
====[https://dosbox-x.com/ DOSBox-X]====<br />
DOSBox-X aims to be a complete DOS emulation package that is both fully-featured and easy to use. It also tries to implement more accurate emulation both to improve the general DOS emulation and to aid retro-development. By now it has an impressive list of unique features. Some examples:<br />
{{++}} GUI menu bar and configuration tool<br />
{{++}} Built-in debugger and logging options<br />
{{++}} Automatic drive mounting (Windows only)<br />
{{++}} Copy and Paste support (Windows only)<br />
{{++}} NEC PC-98 support<br />
{{++}} Support for Windows 95 and 98<br />
{{++}} Emulation of the Roland MT-32 MIDI synthesizer<br />
{{++}} FluidSynth and Timidity++ General MIDI support<br />
{{++}} Save and load states<br />
{{++}} CPU optimization and Turbo mode<br />
{{++}} Improved customization on the title bar<br />
{{++}} Better compatibility with DOS applications<br />
{{++}} Built-in external tools such as CWSDPMI, DOSIDLE and IMGMAKE<br />
{{++}} Support for more DOS commands (e.g. VOL, LABEL, PROMPT, and MOUSE)<br />
{{++}} Support for more video modes (e.g. mda, mcga, cga_rgb, cga_composite, cga_composite2, amstrad)<br />
{{++}} Support for CONFIG.SYS commands (e.g. DEVICE, BUFFERS, FCBS, LASTDRIV)<br />
{{++}} Support for more CPU types (e.g. 8086, 80186, 80286, Pentium MMX and Pentium Pro)<br />
{{++}} Support for FAT32 and Long Filenames (LFN)<br />
{{++}} Support for ROM BIOS images<br />
{{++}} Support for printer output<br />
{{++}} Support for vertical sync (V-Sync)<br />
{{++}} Support for Direct3D with pixel shaders (Windows only)<br />
{{++}} Support for OpenglHQ<br />
{{++}} Support for Innovation SSI-2001 emulation<br />
{{++}} Support for 3dfx Glide and Voodoo chip emulation<br />
{{++}} Support for NE2000 Ethernet<br />
{{++}} Support for more accurate PC Speaker emulation<br />
{{++}} Support for features such as overscan border and stereo swapping<br />
{{++}} Various patches such as font, DBCS and Ctrl-Break patch<br />
<br />
====[https://github.com/dosbox-staging/dosbox-staging dosbox-staging]====<br />
dosbox-staging attempts to modernize the DOSBox codebase by using current development practices and tools, fixing issues, and adding features that better support today's systems.<br />
<br />
===Windows installation===<br />
Windows 3.0 through 98(SE) can be installed inside regular DOSBox however this is unsupported and instability issues occur. One of the forks, DOSBox-X does support Windows, and allows even Windows ME to run to some extend.<br />
<br />
You could also, alternatively, try the [http://www.japheth.de/HX.html HX DOS Extender] (up to version 2.17) which grants a minimal Windows runtime environment. Note that it only supports Windows console apps and simple GUI ones. The latest versions (version 2.18 and later) are located on [https://github.com/Baron-von-Riedesel/HX its GitHub site]. An unofficial version 2.17+ (with support for modern sound cards) can be found [http://sound-dos.ucoz.ru/load/new_hxdos_extender_2_17/1-1-0-8 here].<br />
<br />
===Example input===<br />
DOSBox running in Windows:<br />
<br />
<pre><br />
Z:\><br />
Z:\>mount c c:\game_directory<br />
Z:\>imgmount d d:\game_disc.iso -t iso<br />
Z:\>cd d:\<br />
D:\>game_install.exe<br />
D:\>cd c:\<br />
C:\><br />
C:\>game.exe</pre><br />
<br />
Substitute the pathways with the given conventions of the host operating system.<br />
<br />
{{key|Alt|Enter}} to maximise the window; {{key|Ctrl|F4}} to switch between mounted disc images. Use double quotes, " ", when mounting folders with spaces ("c:\installation folder"); For mounting multiple disc images, -t iso is required only once at the end of the last disc image, this defines how DOSBox should emulate the volume and iso defines the type of volume.<br />
<br />
===[http://dos32a.narechk.net/index_en.html DOS/32A]===<br />
DOS/32A is a more advanced extender and open source replacement to DOS4GW. It can improve both performance and stability of many games. More info [https://www.dosbox.com/wiki/TOOLS:DOS32A here].<br />
<br />
{{ii}} If DOS/32A gives you issues with a particular game, you could alternatively try the [http://www.devoresoftware.com/freesource/cwsrc.htm Causeway extender] or [http://www.sid6581.net/pmodew/ PMODE/W]. Worst-case scenario, stick with the stock extender.<ref>https://www.gog.com/forum/m_a_x_series/changing_dos_extenders_might_be_the_solution_for_all_of_us</ref><br />
<br />
===[http://www.vogonsdrivers.com/getfile.php?fileid=346 UniVBE]===<br />
Although DOSBox will not gain the performance improvements this program promises, it will add additional video modes. Although 5.0+ were initially released as commercial software, SciTech later released them as freeware. Versions 1-4 were always freeware though. The 5.x series is generally the best to use with DOSBox. Additional (possibly useful) DOS display utilities can be found [http://www.vogons.org/viewtopic.php?t=15190 here].<br />
<br />
===Gravis MIDI/Patches===<br />
The Gravis Ultra Sound or GUS was a sound card produced by Advanced Gravis Computer Technology, who were best known for their Gravis PC Gamepad. One of the features of the GUS is its ability to use real world sound samples instead of digitally generated instruments. This allows for a richer quality of sound when playing midi sound. Unfortunately, the official patches (drivers/samples) cannot be distributed with DOSBox due to conflicting Licenses. You can however find a guide for installing them [https://www.vogons.org/viewtopic.php?f=31&t=16974 here].<br><br />
A similar thing is true for some Sound Blaster games; see [http://nerdlypleasures.blogspot.com/2013/12/sound-blaster-drivers-when-dos-games.html here].<br />
<br />
==DOSBox configuration==<br />
DOSBox stores configuration information in *.conf files. Individual conf files can be create for each piece of software used and additional parameters can be appended.<br />
<br />
To modify a configuration option within DOSBox, use the <code>config</code> command. For example, <code>config cpu cycles fixed 30000</code><br />
<br />
==Video settings==<br />
{{Video settings<br />
|wsgf link = <br />
|widescreen wsgf award = <br />
|multimonitor wsgf award = <br />
|ultrawidescreen wsgf award = <br />
|4k ultra hd wsgf award = <br />
|widescreen resolution = true<br />
|widescreen resolution notes= Requires game being emulated to support it.<br />
|multimonitor = false<br />
|multimonitor notes = <br />
|ultrawidescreen = false<br />
|ultrawidescreen notes = <br />
|4k ultra hd = false<br />
|4k ultra hd notes = <br />
|fov = false<br />
|fov notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
|windowed = true<br />
|windowed notes = Toggle with {{key|Alt|Enter}}.<br />
|borderless windowed = false<br />
|borderless windowed notes = <br />
|anisotropic = false<br />
|anisotropic notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
|antialiasing = false<br />
|antialiasing notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
|vsync = true<br />
|vsync notes = Set <code>fulldouble = true</code> in the configuration file. See [[#Unofficial builds|Unofficial builds]] for more advanced implementations.<br />
|60 fps = true<br />
|60 fps notes = <br />
|120 fps = false<br />
|120 fps notes = <br />
|hdr = false<br />
|hdr notes = <br />
|color blind = false<br />
|color blind notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
}}<br />
<br />
==Input settings==<br />
{{Input settings<br />
|key remap = true<br />
|key remap notes = See [[#Mapper|Mapper]].<br />
|acceleration option = false<br />
|acceleration option notes = <br />
|mouse sensitivity = true<br />
|mouse sensitivity notes = Adjustable in DOSBox configuration settings.<br />
|mouse menu = false<br />
|mouse menu notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
|invert mouse y-axis = n/a<br />
|invert mouse y-axis notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
|controller support = true<br />
|controller support notes = See [[#Controller support|Controller support]].<br />
|full controller = unknown<br />
|full controller notes = <br />
|controller remap = unknown<br />
|controller remap notes = <br />
|controller sensitivity = unknown<br />
|controller sensitivity notes= <br />
|invert controller y-axis = unknown<br />
|invert controller y-axis notes= <br />
|touchscreen = false<br />
|touchscreen notes = <br />
|button prompts = unknown<br />
|button prompts notes = <br />
|controller hotplug = unknown<br />
|controller hotplug notes = <br />
|haptic feedback = unknown<br />
|haptic feedback notes = <br />
|simultaneous input = true<br />
|simultaneous input notes = <br />
|steam input api = unknown<br />
|steam input api notes = <br />
|light bar support = unknown<br />
|light bar support notes = <br />
}}<br />
<br />
===[[Glossary:Remapping|Remapping]]===<br />
The [http://www.dosbox.com/wiki/Mapper DOSBox Mapper] ({{key|Ctrl|F1}}/{{key|Command|F1}}) can be used to reassign keyboard, mouse and joystick commands.<br />
<br />
===[[Controller|Controller support]]===<br />
DOSBox has several virtual joystick modes which affect what inputs are seen in-game and also what inputs can be remapped using the [[#Mapper|Mapper]]. See [http://www.dosbox.com/DOSBoxManual.html#Joystick the DOSBox manual] for details.<br />
<br />
==Network==<br />
{{Network/Multiplayer<br />
|local play = true<br />
|local play players = <br />
|local play modes = <br />
|local play notes = <br />
|lan play = true<br />
|lan play players = <br />
|lan play modes = <br />
|lan play notes = <br />
|online play = true<br />
|online play players = <br />
|online play modes = <br />
|online play notes = <br />
|asynchronous = <br />
|asynchronous notes = <br />
}}{{Network/Connections<br />
|matchmaking = <br />
|matchmaking notes = <br />
|p2p = <br />
|p2p notes = <br />
|dedicated = <br />
|dedicated notes = <br />
|self-hosting = <br />
|self-hosting notes = <br />
|direct ip = <br />
|direct ip notes = <br />
}}<br />
<br />
===Net play===<br />
DOSBox supports both IPX and Modem emulation. A guide to setting it up can be found [https://www.dosbox.com/wiki/Connectivity here].<br />
There's also a guide to adding additional protocols for networking [https://www.dosbox.com/wiki/Network_Setup here]. Several method are listed.<br />
<br />
==VR support==<br />
{{VR support<br />
|gg3d name = <br />
|native 3d gg3d award = <br />
|nvidia 3d vision gg3d award = <br />
|tridef 3d gg3d award = <br />
|iz3d gg3d award = <br />
|native 3d = <br />
|native 3d notes = <br />
|nvidia 3d vision = <br />
|nvidia 3d vision notes = <br />
|tridef 3d = <br />
|tridef 3d notes = <br />
|iz3d = <br />
|iz3d notes = <br />
|vorpx = hackable<br />
|vorpx modes = 2D<br />
|vorpx notes = Not officially supported, requires [http://ykhwong.x-y.net/ this DOSBOX version]. See also [https://www.vorpx.com/forums/topic/dosbox/#post-126136 here]. <br />
|htc vive = <br />
|htc vive notes = <br />
|oculus rift = <br />
|oculus rift notes = <br />
|osvr = <br />
|osvr notes = <br />
|windows mixed reality = <br />
|windows mixed reality notes = <br />
|keyboard-mouse = <br />
|keyboard-mouse notes = <br />
|3rd space gaming vest = <br />
|3rd space gaming vest notes = <br />
|novint falcon = <br />
|novint falcon notes = <br />
|trackir = <br />
|trackir notes = <br />
|tobii eye tracking = <br />
|tobii eye tracking notes = <br />
|play area seated = <br />
|play area seated notes = <br />
|play area standing = <br />
|play area standing notes = <br />
|play area room-scale = <br />
|play area room-scale notes = <br />
}}<br />
<br />
==Issues fixed==<br />
===Game appears stretched horizontally===<br />
{{Fixbox|description=Fix incorrect aspect ratio|ref={{cn|date=February 2017}}|fix=<br />
{{ii}} Many DOS games are designed to run at 320x200 or 640x400, but with a 4:3 aspect ratio. To set this, do the following:<br />
* Go to the <code>[render]</code> section of the DOSBox configuration file and change <code>aspect=false</code> to <code>aspect=true</code>.<br />
* If you are using Boxer, you can also use the '''View - Use 4:3 Aspect Ratio''' item in the menu.<br />
}}<br />
<br />
===Green or black screen in fullscreen mode===<br />
{{ii}} With some video cards, DOSBox's default output mode will render with a green or black screen in fullscreen mode.<br />
<br />
{{Fixbox|description=Edit DOSBox configuration file (DOSBox.com versions)|fix=<br />
# Edit the DOSBox configuration file (<code>dosbox-0.74.conf</code>, <code>dosbox.conf</code>, or similar).<br />
# Change <code>output=surface</code> to <code>output=overlay</code><br />
# Save your changes and run the game again.<br />
{{ii}} If the problem persists, edit it again and try different modes until you get one that works.<br />
}}<br />
{{Fixbox|description=Run Graphic Mode Setup (GOG.com versions)|fix=<br />
# Run the game's Graphic Mode Setup in the Start Screen/Start Menu.<br />
# Change Graphic mode to "Overlay" or "DDraw".<br />
# Choose Save Settings and run the game again.<br />
{{ii}} If the problem persists, run it again and try different modes until you get one that works.<br />
{{--}} GOG's setup utility can be rather buggy: it may crash, freeze or simply not save changed settings when exiting.<br />
}}<br />
<br />
===Character/camera/cursor constantly moves in one direction===<br />
{{Fixbox|description=Change joystick timing setting|fix=<br />
# Edit the game's DOSBox configuration file.<br />
# Change <code>timed=true</code> to <code>timed=false</code> (if it is already set to this, try <code>timed=true</code> instead).<br />
# Save your changes and run the game again.<br />
}}<br />
<br />
{{Fixbox|description=Disable joystick support|fix=<br />
{{ii}} This fix is only suitable if you don't want to use a controller with the game.<br />
# Edit the game's DOSBox configuration file.<br />
# Change the <code>joysticktype</code> value to <code>none</code><br />
# Save your changes and run the game again.<br />
}}<br />
<br />
===Can't remap keys/joystick===<br />
Some games have fixed inputs. Use the [http://www.dosbox.com/wiki/Mapper DOSBox Mapper] to remap the controls.<br />
<br />
===Unable to use D-pad/Analog stick not working (XInput controllers)===<br />
{{Fixbox|description=Change DOSBox configuration file|ref=<ref>[https://www.gog.com/forum/general/about_dosbox_and_xbox_360xinput_controllers About DOSBox and Xbox 360/XInput Controllers, page 1 - Forum - GOG.com]</ref>|fix=<br />
# Edit the game's DOSBox configuration file.<br />
# Change the <code>joysticktype</code> value to <code>fcs</code> and <code>timed</code> value to <code>false</code>.<br />
# Save your changes and run the game again.<br />
}}<br />
<br />
===Can't open Steam overlay in-game===<br />
{{ii}} The [[Steam]] overlay only works in some output modes; OpenGL seems to work the best.<ref name="Steam overlay">[https://www.gog.com/forum/general_archive/adding_dosbox_to_steam_client_and_enabling_steam_overlay Adding DOSBox to Steam Client and enabling Steam Overlay, page 1 - Forum - GOG.com]</ref><br />
<br />
{{Fixbox|description=Change output in configuration file|ref=<ref name="Steam overlay"/>|fix=<br />
# Go to the game's installation folder and edit the DOSBox configuration file (<code>.conf</code>).<br />
# Change <code>output=</code> to read <code>output=OpenGL</code><br />
# Change <code>fullresolution=</code> to read <code>fullresolution=desktop</code> for the best overlay resolution.<br />
# Save your changes. The Steam overlay should now work in-game.<br />
}}<br />
<br />
===Printer support===<br />
{{ii}} Official DOSBox builds don't support printing in games that use it.<br />
<br />
{{Fixbox|description=Enable printer support|ref=<ref>{{Refcheck|user=Garrett|date=September 27, 2017|comment=}}</ref>|fix=<br />
# Download [http://ykhwong.x-y.net/subpages/old.php DOSBox SVN Daum 20140127].<br />
# Install it over top of the game's existing DOSBox version.<br />
# Extract the [https://community.pcgamingwiki.com/files/file/952-dosbox-svn-daum-fonts/ FONTS folder] into the DOSBox SVN Daum installation folder (required for some games).<br />
# Edit the game's DOSBox configuration file and add the following lines at the bottom:<br />
<pre>[printer]<br />
printer=true<br />
dpi=360<br />
width=85<br />
height=110<br />
printoutput=printer<br />
multipage=false<br />
docpath=.<br />
timeout=0<br />
<br />
[parallel]<br />
parallel1=printer<br />
</pre><br />
<ol start="4"><br />
<li>Start the game normally.</li><br />
<li>When you are ready to print, first switch into windowed mode ({{key|Alt|Enter}}) to ensure you can see the printer dialog box.</li></ol><br />
<br />
'''Notes'''<br />
{{ii}} If DOSBox does not start printing increase the value for <code>timeout=0</code> (e.g. <code>timeout=100</code>); if a printed page is incomplete increase this to a higher value.<br />
{{ii}} If a menu bar is visible in fullscreen mode after making this change, ensure <code>output=</code> is not set to <code>OpenGL</code>.<br />
{{ii}} The printer selection window is only shown once per session; relaunch the game to change printers.<br />
{{--}} Accented characters are not printed correctly; for [[Wikipedia:Text mode|text mode]] games use [http://www.columbia.edu/~em36/wpdos/dosbox-vdos-lfn.html DOSBox SVN-lfn] to copy screen text to the clipboard.<br />
}}<br />
<br />
{{References}}<br />
<br />
[[Category:Emulation]]</div>174.93.75.115https://www.pcgamingwiki.com/w/index.php?title=DOSBox&diff=996110DOSBox2020-09-04T23:15:38Z<p>174.93.75.115: /* Windows installation */</p>
<hr />
<div>{{Infobox non-game<br />
|cover = DOSBox logo.png<br />
|developers = <br />
{{Infobox game/row/developer|DOSBox Team}}<br />
|release dates= <br />
{{Infobox game/row/date|Windows|July 22, 2002}}<br />
{{Infobox game/row/date|Linux|July 22, 2002}}<br />
{{Infobox game/row/date|OS X|March 30, 2006}}<br />
|winehq = <br />
|wikipedia = DOSBox<br />
}}<br />
<br />
'''Key points'''<br />
{{++}} DOSBox allows DOS-based games to run properly on modern systems.<br />
{{++}} [[Digital_rights_management_(DRM)#Disc_check|CD check]] for game being emulated can be bypassed generally by coping CD contents to a folder and [https://www.dosbox.com/wiki/MOUNT mounting] said folder as a CDROM.<br />
<br />
'''General information'''<br />
{{mm}} [http://www.dosbox.com Official DOSBox site]<br />
{{mm}} [http://www.dosbox.com/wiki/Main_Page Official DOSBox wiki]<br />
<br />
==Essential improvements==<br />
===Graphical user interface===<br />
DOSBox does not use a graphical user interface. However, front ends such as [http://members.quicknet.nl/blankendaalr/dbgl/ DBGL] can be used.<br />
====[http://members.quicknet.nl/blankendaalr/dbgl/ Dos Box Game Launcher (DBGL)]====<br />
{{++}} Features a wizard to install games.<br />
{{++}} Dosbox preinstalled in version 0.74.<br />
{{++}} Can manage different Dosbox versions.<br />
{{++}} Supports Windows, Linux and MacOS.<br />
{{ii}} Requires Java Runtime Environment.<br />
====[http://dfendreloaded.sourceforge.net/ D-Fend Reloaded]====<br />
{{++}} Does not require DOSBox to be installed.<br />
{{--}} No longer maintained<br />
<br />
===Unofficial builds===<br />
{{cleanup|section|Way too many key points. Please consolidate them}}<br />
There are various unofficial builds, typically called forks, of DOSBox which provide additional functionality such as support for Glide. A full list can be found on the [http://www.dosbox.com/wiki/SVN_Builds#List_of_SVN_Builds DOSBox Wiki].<br />
<br />
A good one to start with is [https://dosbox-x.com DOSBox-X] ([https://github.com/joncampbell123/dosbox-x project on GitHub]). It streamlines the interface and adds support for features vanilla DOSBox cannot do such as Glide support.<br />
<br />
For Mac, you should try [http://boxerapp.com Boxer]. It makes running and installation of games easier by wrapping them in [https://en.wikipedia.org/wiki/Bundle_(macOS) Application Bundles], called "Game Boxes", that can be launched in Boxer by double clicking them as well as having a builtin GUI interface for configuration that more easily integrates into the Mac OS. It also has much over looked audio features; it already includes Gravis UltraSound patches and has builtin CM-32 & MT-32L emulation available through MUNT.<br />
<br />
Also, installing [http://www.freedos.org/download/ FreeDOS] (or just it's [http://www.freedos.org/software/ included utilities]) grants a more complete DOS experience.<br />
<br />
====[https://dosboxece.yesterplay.net/ DOSBox ECE (Enhanced Community Edition)]====<br />
Currently, DOSBox ECE differs from normal DOSBox in these features:<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=41&t=41853 Emulation of a 3Dfx Vooodoo card through OpenGL] (No external Glide wrapper needed!)<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=41&t=43899 4x, 5x and 6x scaling in windowed mode is possible]<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=32&t=49160 Pixel-perfect output mode] for undistorted scaling of the picture<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=41&t=49327 Improved emulation of OPL3] (a FM sound synthesis chip from Yamaha)<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=41&t=23371 Improved sound of PC speaker emulation]<br />
{{++}} [https://sourceforge.net/projects/munt/ Emulation of the Roland MT-32 midi synthesizer]<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=32&t=27831&start=20 Integration of Fluidsynth] (a software MIDI synthesizer with Soundfont support)<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=32&t=27452 Support for up to 10 joystick axis and 2 D-pads] (full use of two 360 compatible controllers)<br />
{{++}} [https://sourceforge.net/p/dosbox/patches/264/ Mouse buttons mappable to keyboard or controller buttons]<br />
{{++}} [https://sourceforge.net/p/dosbox/patches/276/ Separate sensitivity settings for the X and Y axis of the mouse]<br />
{{++}} Supports up to 384 MB of memory, required for running Windows 9x on top of DOSBox ECE<br />
{{++}} 4MB video memory, reducing sprite flickering in games using the Build engine (“Duke Nukem 3D”, “Blood”, etc.)<br />
<br />
The DOSBox ECE developer also hosts compiled versions of the latest DOSBox SVN (development builds of the official DOSBox) on his website.<br />
<br />
====[https://dosbox-x.com/ DOSBox-X]====<br />
DOSBox-X aims to be a complete DOS emulation package that is both fully-featured and easy to use. It also tries to implement more accurate emulation both to improve the general DOS emulation and to aid retro-development. By now it has an impressive list of unique features. Some examples:<br />
{{++}} GUI menu bar and configuration tool<br />
{{++}} Built-in debugger and logging options<br />
{{++}} Automatic drive mounting (Windows only)<br />
{{++}} Copy and Paste support (Windows only)<br />
{{++}} NEC PC-98 support<br />
{{++}} Support for Windows 95 and 98<br />
{{++}} Emulation of the Roland MT-32 midi synthesizer<br />
{{++}} FluidSynth and Timidity++ General MIDI support<br />
{{++}} Save and load states<br />
{{++}} CPU optimization and Turbo mode<br />
{{++}} Improved customization on the title bar<br />
{{++}} Better compatibility with DOS applications<br />
{{++}} Built-in external tools such as CWSDPMI, DOSIDLE and IMGMAKE<br />
{{++}} Support for more DOS commands (e.g. VOL, LABEL, PROMPT, and MOUSE)<br />
{{++}} Support for more video modes (e.g. mda, mcga, cga_rgb, cga_composite, cga_composite2, amstrad)<br />
{{++}} Support for CONFIG.SYS commands (e.g. DEVICE, BUFFERS, FCBS, LASTDRIV)<br />
{{++}} Support for more CPU types (e.g. 8086, 80186, 80286, Pentium MMX and Pentium Pro)<br />
{{++}} Support for FAT32 and Long Filenames (LFN)<br />
{{++}} Support for ROM BIOS images<br />
{{++}} Support for printer output<br />
{{++}} Support for vertical sync (V-Sync)<br />
{{++}} Support for Direct3D with pixel shaders (Windows only)<br />
{{++}} Support for OpenglHQ<br />
{{++}} Support for Innovation SSI-2001 emulation<br />
{{++}} Support for 3dfx Glide and Voodoo chip emulation<br />
{{++}} Support for NE2000 Ethernet<br />
{{++}} Support for more accurate PC Speaker emulation<br />
{{++}} Support for features such as overscan border and stereo swapping<br />
{{++}} Various patches such as font, DBCS and Ctrl-Break patch<br />
<br />
====[https://github.com/dosbox-staging/dosbox-staging DOSBox-Staging]====<br />
dosbox-staging attempts to modernize the DOSBox codebase by using current development practices and tools, fixing issues, and adding features that better support today's systems.<br />
<br />
===Windows installation===<br />
Windows 3.0 through 98(SE) can be installed inside regular DOSBox however this is unsupported and instability issues occur. One of the forks, DOSBox-X does support Windows, and allows even Windows ME to run to some extend.<br />
<br />
You could also, alternatively, try the [http://www.japheth.de/HX.html HX DOS Extender] (up to version 2.17) which grants a minimal Windows runtime environment. Note that it only supports Windows console apps and simple GUI ones. The latest versions (version 2.18+) are located on [https://github.com/Baron-von-Riedesel/HX its GitHub site]. An unofficial version 2.17+ (with support for modern sound cards) can be found [http://sound-dos.ucoz.ru/load/new_hxdos_extender_2_17/1-1-0-8 here].<br />
<br />
===Example input===<br />
DOSBox running in Windows:<br />
<br />
<pre><br />
Z:\><br />
Z:\>mount c c:\game_directory<br />
Z:\>imgmount d d:\game_disc.iso -t iso<br />
Z:\>cd d:\<br />
D:\>game_install.exe<br />
D:\>cd c:\<br />
C:\><br />
C:\>game.exe</pre><br />
<br />
Substitute the pathways with the given conventions of the host operating system.<br />
<br />
{{key|Alt|Enter}} to maximise the window; {{key|Ctrl|F4}} to switch between mounted disc images. Use double quotes, " ", when mounting folders with spaces ("c:\installation folder"); For mounting multiple disc images, -t iso is required only once at the end of the last disc image, this defines how DOSBox should emulate the volume and iso defines the type of volume.<br />
<br />
===[http://dos32a.narechk.net/index_en.html DOS/32A]===<br />
DOS/32A is a more advanced extender and open source replacement to DOS4GW. It can improve both performance and stability of many games. More info [https://www.dosbox.com/wiki/TOOLS:DOS32A here].<br />
<br />
{{ii}} If DOS/32A gives you issues with a particular game, you could alternatively try the [http://www.devoresoftware.com/freesource/cwsrc.htm Causeway extender] or [http://www.sid6581.net/pmodew/ PMODE/W]. Worst-case scenario, stick with the stock extender.<ref>https://www.gog.com/forum/m_a_x_series/changing_dos_extenders_might_be_the_solution_for_all_of_us</ref><br />
<br />
===[http://www.vogonsdrivers.com/getfile.php?fileid=346 UniVBE]===<br />
Although DOSBox will not gain the performance improvements this program promises, it will add additional video modes. Although 5.0+ were initially released as commercial software, SciTech later released them as freeware. Versions 1-4 were always freeware though. The 5.x series is generally the best to use with DOSBox. Additional (possibly useful) DOS display utilities can be found [http://www.vogons.org/viewtopic.php?t=15190 here].<br />
<br />
===Gravis MIDI/Patches===<br />
The Gravis Ultra Sound or GUS was a sound card produced by Advanced Gravis Computer Technology, who were best known for their Gravis PC Gamepad. One of the features of the GUS is its ability to use real world sound samples instead of digitally generated instruments. This allows for a richer quality of sound when playing midi sound. Unfortunately, the official patches (drivers/samples) cannot be distributed with DOSBox due to conflicting Licenses. You can however find a guide for installing them [https://www.vogons.org/viewtopic.php?f=31&t=16974 here].<br><br />
A similar thing is true for some Sound Blaster games; see [http://nerdlypleasures.blogspot.com/2013/12/sound-blaster-drivers-when-dos-games.html here].<br />
<br />
==DOSBox configuration==<br />
DOSBox stores configuration information in *.conf files. Individual conf files can be create for each piece of software used and additional parameters can be appended.<br />
<br />
To modify a configuration option within DOSBox, use the <code>config</code> command. For example, <code>config cpu cycles fixed 30000</code><br />
<br />
==Video settings==<br />
{{Video settings<br />
|wsgf link = <br />
|widescreen wsgf award = <br />
|multimonitor wsgf award = <br />
|ultrawidescreen wsgf award = <br />
|4k ultra hd wsgf award = <br />
|widescreen resolution = true<br />
|widescreen resolution notes= Requires game being emulated to support it.<br />
|multimonitor = false<br />
|multimonitor notes = <br />
|ultrawidescreen = false<br />
|ultrawidescreen notes = <br />
|4k ultra hd = false<br />
|4k ultra hd notes = <br />
|fov = false<br />
|fov notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
|windowed = true<br />
|windowed notes = Toggle with {{key|Alt|Enter}}.<br />
|borderless windowed = false<br />
|borderless windowed notes = <br />
|anisotropic = false<br />
|anisotropic notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
|antialiasing = false<br />
|antialiasing notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
|vsync = true<br />
|vsync notes = Set <code>fulldouble = true</code> in the configuration file. See [[#Unofficial builds|Unofficial builds]] for more advanced implementations.<br />
|60 fps = true<br />
|60 fps notes = <br />
|120 fps = false<br />
|120 fps notes = <br />
|hdr = false<br />
|hdr notes = <br />
|color blind = false<br />
|color blind notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
}}<br />
<br />
==Input settings==<br />
{{Input settings<br />
|key remap = true<br />
|key remap notes = See [[#Mapper|Mapper]].<br />
|acceleration option = false<br />
|acceleration option notes = <br />
|mouse sensitivity = true<br />
|mouse sensitivity notes = Adjustable in DOSBox configuration settings.<br />
|mouse menu = false<br />
|mouse menu notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
|invert mouse y-axis = n/a<br />
|invert mouse y-axis notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
|controller support = true<br />
|controller support notes = See [[#Controller support|Controller support]].<br />
|full controller = unknown<br />
|full controller notes = <br />
|controller remap = unknown<br />
|controller remap notes = <br />
|controller sensitivity = unknown<br />
|controller sensitivity notes= <br />
|invert controller y-axis = unknown<br />
|invert controller y-axis notes= <br />
|touchscreen = false<br />
|touchscreen notes = <br />
|button prompts = unknown<br />
|button prompts notes = <br />
|controller hotplug = unknown<br />
|controller hotplug notes = <br />
|haptic feedback = unknown<br />
|haptic feedback notes = <br />
|simultaneous input = true<br />
|simultaneous input notes = <br />
|steam input api = unknown<br />
|steam input api notes = <br />
|light bar support = unknown<br />
|light bar support notes = <br />
}}<br />
<br />
===[[Glossary:Remapping|Remapping]]===<br />
The [http://www.dosbox.com/wiki/Mapper DOSBox Mapper] ({{key|Ctrl|F1}}/{{key|Command|F1}}) can be used to reassign keyboard, mouse and joystick commands.<br />
<br />
===[[Controller|Controller support]]===<br />
DOSBox has several virtual joystick modes which affect what inputs are seen in-game and also what inputs can be remapped using the [[#Mapper|Mapper]]. See [http://www.dosbox.com/DOSBoxManual.html#Joystick the DOSBox manual] for details.<br />
<br />
==Network==<br />
{{Network/Multiplayer<br />
|local play = true<br />
|local play players = <br />
|local play modes = <br />
|local play notes = <br />
|lan play = true<br />
|lan play players = <br />
|lan play modes = <br />
|lan play notes = <br />
|online play = true<br />
|online play players = <br />
|online play modes = <br />
|online play notes = <br />
|asynchronous = <br />
|asynchronous notes = <br />
}}{{Network/Connections<br />
|matchmaking = <br />
|matchmaking notes = <br />
|p2p = <br />
|p2p notes = <br />
|dedicated = <br />
|dedicated notes = <br />
|self-hosting = <br />
|self-hosting notes = <br />
|direct ip = <br />
|direct ip notes = <br />
}}<br />
<br />
===Net play===<br />
DOSBox supports both IPX and Modem emulation. A guide to setting it up can be found [https://www.dosbox.com/wiki/Connectivity here].<br />
There's also a guide to adding additional protocols for networking [https://www.dosbox.com/wiki/Network_Setup here]. Several method are listed.<br />
<br />
==VR support==<br />
{{VR support<br />
|gg3d name = <br />
|native 3d gg3d award = <br />
|nvidia 3d vision gg3d award = <br />
|tridef 3d gg3d award = <br />
|iz3d gg3d award = <br />
|native 3d = <br />
|native 3d notes = <br />
|nvidia 3d vision = <br />
|nvidia 3d vision notes = <br />
|tridef 3d = <br />
|tridef 3d notes = <br />
|iz3d = <br />
|iz3d notes = <br />
|vorpx = hackable<br />
|vorpx modes = 2D<br />
|vorpx notes = Not officially supported, requires [http://ykhwong.x-y.net/ this DOSBOX version]. See also [https://www.vorpx.com/forums/topic/dosbox/#post-126136 here]. <br />
|htc vive = <br />
|htc vive notes = <br />
|oculus rift = <br />
|oculus rift notes = <br />
|osvr = <br />
|osvr notes = <br />
|windows mixed reality = <br />
|windows mixed reality notes = <br />
|keyboard-mouse = <br />
|keyboard-mouse notes = <br />
|3rd space gaming vest = <br />
|3rd space gaming vest notes = <br />
|novint falcon = <br />
|novint falcon notes = <br />
|trackir = <br />
|trackir notes = <br />
|tobii eye tracking = <br />
|tobii eye tracking notes = <br />
|play area seated = <br />
|play area seated notes = <br />
|play area standing = <br />
|play area standing notes = <br />
|play area room-scale = <br />
|play area room-scale notes = <br />
}}<br />
<br />
==Issues fixed==<br />
===Game appears stretched horizontally===<br />
{{Fixbox|description=Fix incorrect aspect ratio|ref={{cn|date=February 2017}}|fix=<br />
{{ii}} Many DOS games are designed to run at 320x200 or 640x400, but with a 4:3 aspect ratio. To set this, do the following:<br />
* Go to the <code>[render]</code> section of the DOSBox configuration file and change <code>aspect=false</code> to <code>aspect=true</code>.<br />
* If you are using Boxer, you can also use the '''View - Use 4:3 Aspect Ratio''' item in the menu.<br />
}}<br />
<br />
===Green or black screen in fullscreen mode===<br />
{{ii}} With some video cards, DOSBox's default output mode will render with a green or black screen in fullscreen mode.<br />
<br />
{{Fixbox|description=Edit DOSBox configuration file (DOSBox.com versions)|fix=<br />
# Edit the DOSBox configuration file (<code>dosbox-0.74.conf</code>, <code>dosbox.conf</code>, or similar).<br />
# Change <code>output=surface</code> to <code>output=overlay</code><br />
# Save your changes and run the game again.<br />
{{ii}} If the problem persists, edit it again and try different modes until you get one that works.<br />
}}<br />
{{Fixbox|description=Run Graphic Mode Setup (GOG.com versions)|fix=<br />
# Run the game's Graphic Mode Setup in the Start Screen/Start Menu.<br />
# Change Graphic mode to "Overlay" or "DDraw".<br />
# Choose Save Settings and run the game again.<br />
{{ii}} If the problem persists, run it again and try different modes until you get one that works.<br />
{{--}} GOG's setup utility can be rather buggy: it may crash, freeze or simply not save changed settings when exiting.<br />
}}<br />
<br />
===Character/camera/cursor constantly moves in one direction===<br />
{{Fixbox|description=Change joystick timing setting|fix=<br />
# Edit the game's DOSBox configuration file.<br />
# Change <code>timed=true</code> to <code>timed=false</code> (if it is already set to this, try <code>timed=true</code> instead).<br />
# Save your changes and run the game again.<br />
}}<br />
<br />
{{Fixbox|description=Disable joystick support|fix=<br />
{{ii}} This fix is only suitable if you don't want to use a controller with the game.<br />
# Edit the game's DOSBox configuration file.<br />
# Change the <code>joysticktype</code> value to <code>none</code><br />
# Save your changes and run the game again.<br />
}}<br />
<br />
===Can't remap keys/joystick===<br />
Some games have fixed inputs. Use the [http://www.dosbox.com/wiki/Mapper DOSBox Mapper] to remap the controls.<br />
<br />
===Unable to use D-pad/Analog stick not working (XInput controllers)===<br />
{{Fixbox|description=Change DOSBox configuration file|ref=<ref>[https://www.gog.com/forum/general/about_dosbox_and_xbox_360xinput_controllers About DOSBox and Xbox 360/XInput Controllers, page 1 - Forum - GOG.com]</ref>|fix=<br />
# Edit the game's DOSBox configuration file.<br />
# Change the <code>joysticktype</code> value to <code>fcs</code> and <code>timed</code> value to <code>false</code>.<br />
# Save your changes and run the game again.<br />
}}<br />
<br />
===Can't open Steam overlay in-game===<br />
{{ii}} The [[Steam]] overlay only works in some output modes; OpenGL seems to work the best.<ref name="Steam overlay">[https://www.gog.com/forum/general_archive/adding_dosbox_to_steam_client_and_enabling_steam_overlay Adding DOSBox to Steam Client and enabling Steam Overlay, page 1 - Forum - GOG.com]</ref><br />
<br />
{{Fixbox|description=Change output in configuration file|ref=<ref name="Steam overlay"/>|fix=<br />
# Go to the game's installation folder and edit the DOSBox configuration file (<code>.conf</code>).<br />
# Change <code>output=</code> to read <code>output=OpenGL</code><br />
# Change <code>fullresolution=</code> to read <code>fullresolution=desktop</code> for the best overlay resolution.<br />
# Save your changes. The Steam overlay should now work in-game.<br />
}}<br />
<br />
===Printer support===<br />
{{ii}} Official DOSBox builds don't support printing in games that use it.<br />
<br />
{{Fixbox|description=Enable printer support|ref=<ref>{{Refcheck|user=Garrett|date=September 27, 2017|comment=}}</ref>|fix=<br />
# Download [http://ykhwong.x-y.net/subpages/old.php DOSBox SVN Daum 20140127].<br />
# Install it over top of the game's existing DOSBox version.<br />
# Extract the [https://community.pcgamingwiki.com/files/file/952-dosbox-svn-daum-fonts/ FONTS folder] into the DOSBox SVN Daum installation folder (required for some games).<br />
# Edit the game's DOSBox configuration file and add the following lines at the bottom:<br />
<pre>[printer]<br />
printer=true<br />
dpi=360<br />
width=85<br />
height=110<br />
printoutput=printer<br />
multipage=false<br />
docpath=.<br />
timeout=0<br />
<br />
[parallel]<br />
parallel1=printer<br />
</pre><br />
<ol start="4"><br />
<li>Start the game normally.</li><br />
<li>When you are ready to print, first switch into windowed mode ({{key|Alt|Enter}}) to ensure you can see the printer dialog box.</li></ol><br />
<br />
'''Notes'''<br />
{{ii}} If DOSBox does not start printing increase the value for <code>timeout=0</code> (e.g. <code>timeout=100</code>); if a printed page is incomplete increase this to a higher value.<br />
{{ii}} If a menu bar is visible in fullscreen mode after making this change, ensure <code>output=</code> is not set to <code>OpenGL</code>.<br />
{{ii}} The printer selection window is only shown once per session; relaunch the game to change printers.<br />
{{--}} Accented characters are not printed correctly; for [[Wikipedia:Text mode|text mode]] games use [http://www.columbia.edu/~em36/wpdos/dosbox-vdos-lfn.html DOSBox SVN-lfn] to copy screen text to the clipboard.<br />
}}<br />
<br />
{{References}}<br />
<br />
[[Category:Emulation]]</div>174.93.75.115https://www.pcgamingwiki.com/w/index.php?title=DOSBox&diff=996107DOSBox2020-09-04T23:08:52Z<p>174.93.75.115: /* Windows installation */</p>
<hr />
<div>{{Infobox non-game<br />
|cover = DOSBox logo.png<br />
|developers = <br />
{{Infobox game/row/developer|DOSBox Team}}<br />
|release dates= <br />
{{Infobox game/row/date|Windows|July 22, 2002}}<br />
{{Infobox game/row/date|Linux|July 22, 2002}}<br />
{{Infobox game/row/date|OS X|March 30, 2006}}<br />
|winehq = <br />
|wikipedia = DOSBox<br />
}}<br />
<br />
'''Key points'''<br />
{{++}} DOSBox allows DOS-based games to run properly on modern systems.<br />
{{++}} [[Digital_rights_management_(DRM)#Disc_check|CD check]] for game being emulated can be bypassed generally by coping CD contents to a folder and [https://www.dosbox.com/wiki/MOUNT mounting] said folder as a CDROM.<br />
<br />
'''General information'''<br />
{{mm}} [http://www.dosbox.com Official DOSBox site]<br />
{{mm}} [http://www.dosbox.com/wiki/Main_Page Official DOSBox wiki]<br />
<br />
==Essential improvements==<br />
===Graphical user interface===<br />
DOSBox does not use a graphical user interface. However, front ends such as [http://members.quicknet.nl/blankendaalr/dbgl/ DBGL] can be used.<br />
====[http://members.quicknet.nl/blankendaalr/dbgl/ Dos Box Game Launcher (DBGL)]====<br />
{{++}} Features a wizard to install games.<br />
{{++}} Dosbox preinstalled in version 0.74.<br />
{{++}} Can manage different Dosbox versions.<br />
{{++}} Supports Windows, Linux and MacOS.<br />
{{ii}} Requires Java Runtime Environment.<br />
====[http://dfendreloaded.sourceforge.net/ D-Fend Reloaded]====<br />
{{++}} Does not require DOSBox to be installed.<br />
{{--}} No longer maintained<br />
<br />
===Unofficial builds===<br />
{{cleanup|section|Way too many key points. Please consolidate them}}<br />
There are various unofficial builds, typically called forks, of DOSBox which provide additional functionality such as support for Glide. A full list can be found on the [http://www.dosbox.com/wiki/SVN_Builds#List_of_SVN_Builds DOSBox Wiki].<br />
<br />
A good one to start with is [https://dosbox-x.com DOSBox-X] ([https://github.com/joncampbell123/dosbox-x project on GitHub]). It streamlines the interface and adds support for features vanilla DOSBox cannot do such as Glide support.<br />
<br />
For Mac, you should try [http://boxerapp.com Boxer]. It makes running and installation of games easier by wrapping them in [https://en.wikipedia.org/wiki/Bundle_(macOS) Application Bundles], called "Game Boxes", that can be launched in Boxer by double clicking them as well as having a builtin GUI interface for configuration that more easily integrates into the Mac OS. It also has much over looked audio features; it already includes Gravis UltraSound patches and has builtin CM-32 & MT-32L emulation available through MUNT.<br />
<br />
Also, installing [http://www.freedos.org/download/ FreeDOS] (or just it's [http://www.freedos.org/software/ included utilities]) grants a more complete DOS experience.<br />
<br />
====[https://dosboxece.yesterplay.net/ DOSBox ECE (Enhanced Community Edition)]====<br />
Currently, DOSBox ECE differs from normal DOSBox in these features:<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=41&t=41853 Emulation of a 3Dfx Vooodoo card through OpenGL] (No external Glide wrapper needed!)<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=41&t=43899 4x, 5x and 6x scaling in windowed mode is possible]<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=32&t=49160 Pixel-perfect output mode] for undistorted scaling of the picture<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=41&t=49327 Improved emulation of OPL3] (a FM sound synthesis chip from Yamaha)<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=41&t=23371 Improved sound of PC speaker emulation]<br />
{{++}} [https://sourceforge.net/projects/munt/ Emulation of the Roland MT-32 midi synthesizer]<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=32&t=27831&start=20 Integration of Fluidsynth] (a software MIDI synthesizer with Soundfont support)<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=32&t=27452 Support for up to 10 joystick axis and 2 D-pads] (full use of two 360 compatible controllers)<br />
{{++}} [https://sourceforge.net/p/dosbox/patches/264/ Mouse buttons mappable to keyboard or controller buttons]<br />
{{++}} [https://sourceforge.net/p/dosbox/patches/276/ Separate sensitivity settings for the X and Y axis of the mouse]<br />
{{++}} Supports up to 384 MB of memory, required for running Windows 9x on top of DOSBox ECE<br />
{{++}} 4MB video memory, reducing sprite flickering in games using the Build engine (“Duke Nukem 3D”, “Blood”, etc.)<br />
<br />
The DOSBox ECE developer also hosts compiled versions of the latest DOSBox SVN (development builds of the official DOSBox) on his website.<br />
<br />
====[https://dosbox-x.com/ DOSBox-X]====<br />
DOSBox-X aims to be a complete DOS emulation package that is both fully-featured and easy to use. It also tries to implement more accurate emulation both to improve the general DOS emulation and to aid retro-development. By now it has an impressive list of unique features. Some examples:<br />
{{++}} GUI menu bar and configuration tool<br />
{{++}} Built-in debugger and logging options<br />
{{++}} Automatic drive mounting (Windows only)<br />
{{++}} Copy and Paste support (Windows only)<br />
{{++}} NEC PC-98 support<br />
{{++}} Support for Windows 95 and 98<br />
{{++}} Emulation of the Roland MT-32 midi synthesizer<br />
{{++}} FluidSynth and Timidity++ General MIDI support<br />
{{++}} Save and load states<br />
{{++}} CPU optimization and Turbo mode<br />
{{++}} Improved customization on the title bar<br />
{{++}} Better compatibility with DOS applications<br />
{{++}} Built-in external tools such as CWSDPMI, DOSIDLE and IMGMAKE<br />
{{++}} Support for more DOS commands (e.g. VOL, LABEL, PROMPT, and MOUSE)<br />
{{++}} Support for more video modes (e.g. mda, mcga, cga_rgb, cga_composite, cga_composite2, amstrad)<br />
{{++}} Support for CONFIG.SYS commands (e.g. DEVICE, BUFFERS, FCBS, LASTDRIV)<br />
{{++}} Support for more CPU types (e.g. 8086, 80186, 80286, Pentium MMX and Pentium Pro)<br />
{{++}} Support for FAT32 and Long Filenames (LFN)<br />
{{++}} Support for ROM BIOS images<br />
{{++}} Support for printer output<br />
{{++}} Support for vertical sync (V-Sync)<br />
{{++}} Support for Direct3D with pixel shaders (Windows only)<br />
{{++}} Support for OpenglHQ<br />
{{++}} Support for Innovation SSI-2001 emulation<br />
{{++}} Support for 3dfx Glide and Voodoo chip emulation<br />
{{++}} Support for NE2000 Ethernet<br />
{{++}} Support for more accurate PC Speaker emulation<br />
{{++}} Support for features such as overscan border and stereo swapping<br />
{{++}} Various patches such as font, DBCS and Ctrl-Break patch<br />
<br />
====[https://github.com/dosbox-staging/dosbox-staging DOSBox-Staging]====<br />
dosbox-staging attempts to modernize the DOSBox codebase by using current development practices and tools, fixing issues, and adding features that better support today's systems.<br />
<br />
===Windows installation===<br />
Windows 3.0 through 98(SE) can be installed inside regular DOSBox however this is unsupported and instability issues occur. One of the forks, DOSBox-X does support Windows, and allows even Windows ME to run to some extend.<br />
<br />
You could also, alternatively, try [https://web.archive.org/web/20141013114801/http://www.japheth.de/HX.html The HX DOS Extender] which grants a minimal Windows runtime environment. Note that it only supports Windows console apps and simple GUI ones. The current version is located on [https://github.com/Baron-von-Riedesel/HX its GitHub site]. An unofficial fork of the project called HX+ can be found [http://sound-dos.ucoz.ru/load/new_hxdos_extender_2_17/1-1-0-8 here].<br />
<br />
===Example input===<br />
DOSBox running in Windows:<br />
<br />
<pre><br />
Z:\><br />
Z:\>mount c c:\game_directory<br />
Z:\>imgmount d d:\game_disc.iso -t iso<br />
Z:\>cd d:\<br />
D:\>game_install.exe<br />
D:\>cd c:\<br />
C:\><br />
C:\>game.exe</pre><br />
<br />
Substitute the pathways with the given conventions of the host operating system.<br />
<br />
{{key|Alt|Enter}} to maximise the window; {{key|Ctrl|F4}} to switch between mounted disc images. Use double quotes, " ", when mounting folders with spaces ("c:\installation folder"); For mounting multiple disc images, -t iso is required only once at the end of the last disc image, this defines how DOSBox should emulate the volume and iso defines the type of volume.<br />
<br />
===[http://dos32a.narechk.net/index_en.html DOS/32A]===<br />
DOS/32A is a more advanced extender and open source replacement to DOS4GW. It can improve both performance and stability of many games. More info [https://www.dosbox.com/wiki/TOOLS:DOS32A here].<br />
<br />
{{ii}} If DOS/32A gives you issues with a particular game, you could alternatively try the [http://www.devoresoftware.com/freesource/cwsrc.htm Causeway extender] or [http://www.sid6581.net/pmodew/ PMODE/W]. Worst-case scenario, stick with the stock extender.<ref>https://www.gog.com/forum/m_a_x_series/changing_dos_extenders_might_be_the_solution_for_all_of_us</ref><br />
<br />
===[http://www.vogonsdrivers.com/getfile.php?fileid=346 UniVBE]===<br />
Although DOSBox will not gain the performance improvements this program promises, it will add additional video modes. Although 5.0+ were initially released as commercial software, SciTech later released them as freeware. Versions 1-4 were always freeware though. The 5.x series is generally the best to use with DOSBox. Additional (possibly useful) DOS display utilities can be found [http://www.vogons.org/viewtopic.php?t=15190 here].<br />
<br />
===Gravis MIDI/Patches===<br />
The Gravis Ultra Sound or GUS was a sound card produced by Advanced Gravis Computer Technology, who were best known for their Gravis PC Gamepad. One of the features of the GUS is its ability to use real world sound samples instead of digitally generated instruments. This allows for a richer quality of sound when playing midi sound. Unfortunately, the official patches (drivers/samples) cannot be distributed with DOSBox due to conflicting Licenses. You can however find a guide for installing them [https://www.vogons.org/viewtopic.php?f=31&t=16974 here].<br><br />
A similar thing is true for some Sound Blaster games; see [http://nerdlypleasures.blogspot.com/2013/12/sound-blaster-drivers-when-dos-games.html here].<br />
<br />
==DOSBox configuration==<br />
DOSBox stores configuration information in *.conf files. Individual conf files can be create for each piece of software used and additional parameters can be appended.<br />
<br />
To modify a configuration option within DOSBox, use the <code>config</code> command. For example, <code>config cpu cycles fixed 30000</code><br />
<br />
==Video settings==<br />
{{Video settings<br />
|wsgf link = <br />
|widescreen wsgf award = <br />
|multimonitor wsgf award = <br />
|ultrawidescreen wsgf award = <br />
|4k ultra hd wsgf award = <br />
|widescreen resolution = true<br />
|widescreen resolution notes= Requires game being emulated to support it.<br />
|multimonitor = false<br />
|multimonitor notes = <br />
|ultrawidescreen = false<br />
|ultrawidescreen notes = <br />
|4k ultra hd = false<br />
|4k ultra hd notes = <br />
|fov = false<br />
|fov notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
|windowed = true<br />
|windowed notes = Toggle with {{key|Alt|Enter}}.<br />
|borderless windowed = false<br />
|borderless windowed notes = <br />
|anisotropic = false<br />
|anisotropic notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
|antialiasing = false<br />
|antialiasing notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
|vsync = true<br />
|vsync notes = Set <code>fulldouble = true</code> in the configuration file. See [[#Unofficial builds|Unofficial builds]] for more advanced implementations.<br />
|60 fps = true<br />
|60 fps notes = <br />
|120 fps = false<br />
|120 fps notes = <br />
|hdr = false<br />
|hdr notes = <br />
|color blind = false<br />
|color blind notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
}}<br />
<br />
==Input settings==<br />
{{Input settings<br />
|key remap = true<br />
|key remap notes = See [[#Mapper|Mapper]].<br />
|acceleration option = false<br />
|acceleration option notes = <br />
|mouse sensitivity = true<br />
|mouse sensitivity notes = Adjustable in DOSBox configuration settings.<br />
|mouse menu = false<br />
|mouse menu notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
|invert mouse y-axis = n/a<br />
|invert mouse y-axis notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
|controller support = true<br />
|controller support notes = See [[#Controller support|Controller support]].<br />
|full controller = unknown<br />
|full controller notes = <br />
|controller remap = unknown<br />
|controller remap notes = <br />
|controller sensitivity = unknown<br />
|controller sensitivity notes= <br />
|invert controller y-axis = unknown<br />
|invert controller y-axis notes= <br />
|touchscreen = false<br />
|touchscreen notes = <br />
|button prompts = unknown<br />
|button prompts notes = <br />
|controller hotplug = unknown<br />
|controller hotplug notes = <br />
|haptic feedback = unknown<br />
|haptic feedback notes = <br />
|simultaneous input = true<br />
|simultaneous input notes = <br />
|steam input api = unknown<br />
|steam input api notes = <br />
|light bar support = unknown<br />
|light bar support notes = <br />
}}<br />
<br />
===[[Glossary:Remapping|Remapping]]===<br />
The [http://www.dosbox.com/wiki/Mapper DOSBox Mapper] ({{key|Ctrl|F1}}/{{key|Command|F1}}) can be used to reassign keyboard, mouse and joystick commands.<br />
<br />
===[[Controller|Controller support]]===<br />
DOSBox has several virtual joystick modes which affect what inputs are seen in-game and also what inputs can be remapped using the [[#Mapper|Mapper]]. See [http://www.dosbox.com/DOSBoxManual.html#Joystick the DOSBox manual] for details.<br />
<br />
==Network==<br />
{{Network/Multiplayer<br />
|local play = true<br />
|local play players = <br />
|local play modes = <br />
|local play notes = <br />
|lan play = true<br />
|lan play players = <br />
|lan play modes = <br />
|lan play notes = <br />
|online play = true<br />
|online play players = <br />
|online play modes = <br />
|online play notes = <br />
|asynchronous = <br />
|asynchronous notes = <br />
}}{{Network/Connections<br />
|matchmaking = <br />
|matchmaking notes = <br />
|p2p = <br />
|p2p notes = <br />
|dedicated = <br />
|dedicated notes = <br />
|self-hosting = <br />
|self-hosting notes = <br />
|direct ip = <br />
|direct ip notes = <br />
}}<br />
<br />
===Net play===<br />
DOSBox supports both IPX and Modem emulation. A guide to setting it up can be found [https://www.dosbox.com/wiki/Connectivity here].<br />
There's also a guide to adding additional protocols for networking [https://www.dosbox.com/wiki/Network_Setup here]. Several method are listed.<br />
<br />
==VR support==<br />
{{VR support<br />
|gg3d name = <br />
|native 3d gg3d award = <br />
|nvidia 3d vision gg3d award = <br />
|tridef 3d gg3d award = <br />
|iz3d gg3d award = <br />
|native 3d = <br />
|native 3d notes = <br />
|nvidia 3d vision = <br />
|nvidia 3d vision notes = <br />
|tridef 3d = <br />
|tridef 3d notes = <br />
|iz3d = <br />
|iz3d notes = <br />
|vorpx = hackable<br />
|vorpx modes = 2D<br />
|vorpx notes = Not officially supported, requires [http://ykhwong.x-y.net/ this DOSBOX version]. See also [https://www.vorpx.com/forums/topic/dosbox/#post-126136 here]. <br />
|htc vive = <br />
|htc vive notes = <br />
|oculus rift = <br />
|oculus rift notes = <br />
|osvr = <br />
|osvr notes = <br />
|windows mixed reality = <br />
|windows mixed reality notes = <br />
|keyboard-mouse = <br />
|keyboard-mouse notes = <br />
|3rd space gaming vest = <br />
|3rd space gaming vest notes = <br />
|novint falcon = <br />
|novint falcon notes = <br />
|trackir = <br />
|trackir notes = <br />
|tobii eye tracking = <br />
|tobii eye tracking notes = <br />
|play area seated = <br />
|play area seated notes = <br />
|play area standing = <br />
|play area standing notes = <br />
|play area room-scale = <br />
|play area room-scale notes = <br />
}}<br />
<br />
==Issues fixed==<br />
===Game appears stretched horizontally===<br />
{{Fixbox|description=Fix incorrect aspect ratio|ref={{cn|date=February 2017}}|fix=<br />
{{ii}} Many DOS games are designed to run at 320x200 or 640x400, but with a 4:3 aspect ratio. To set this, do the following:<br />
* Go to the <code>[render]</code> section of the DOSBox configuration file and change <code>aspect=false</code> to <code>aspect=true</code>.<br />
* If you are using Boxer, you can also use the '''View - Use 4:3 Aspect Ratio''' item in the menu.<br />
}}<br />
<br />
===Green or black screen in fullscreen mode===<br />
{{ii}} With some video cards, DOSBox's default output mode will render with a green or black screen in fullscreen mode.<br />
<br />
{{Fixbox|description=Edit DOSBox configuration file (DOSBox.com versions)|fix=<br />
# Edit the DOSBox configuration file (<code>dosbox-0.74.conf</code>, <code>dosbox.conf</code>, or similar).<br />
# Change <code>output=surface</code> to <code>output=overlay</code><br />
# Save your changes and run the game again.<br />
{{ii}} If the problem persists, edit it again and try different modes until you get one that works.<br />
}}<br />
{{Fixbox|description=Run Graphic Mode Setup (GOG.com versions)|fix=<br />
# Run the game's Graphic Mode Setup in the Start Screen/Start Menu.<br />
# Change Graphic mode to "Overlay" or "DDraw".<br />
# Choose Save Settings and run the game again.<br />
{{ii}} If the problem persists, run it again and try different modes until you get one that works.<br />
{{--}} GOG's setup utility can be rather buggy: it may crash, freeze or simply not save changed settings when exiting.<br />
}}<br />
<br />
===Character/camera/cursor constantly moves in one direction===<br />
{{Fixbox|description=Change joystick timing setting|fix=<br />
# Edit the game's DOSBox configuration file.<br />
# Change <code>timed=true</code> to <code>timed=false</code> (if it is already set to this, try <code>timed=true</code> instead).<br />
# Save your changes and run the game again.<br />
}}<br />
<br />
{{Fixbox|description=Disable joystick support|fix=<br />
{{ii}} This fix is only suitable if you don't want to use a controller with the game.<br />
# Edit the game's DOSBox configuration file.<br />
# Change the <code>joysticktype</code> value to <code>none</code><br />
# Save your changes and run the game again.<br />
}}<br />
<br />
===Can't remap keys/joystick===<br />
Some games have fixed inputs. Use the [http://www.dosbox.com/wiki/Mapper DOSBox Mapper] to remap the controls.<br />
<br />
===Unable to use D-pad/Analog stick not working (XInput controllers)===<br />
{{Fixbox|description=Change DOSBox configuration file|ref=<ref>[https://www.gog.com/forum/general/about_dosbox_and_xbox_360xinput_controllers About DOSBox and Xbox 360/XInput Controllers, page 1 - Forum - GOG.com]</ref>|fix=<br />
# Edit the game's DOSBox configuration file.<br />
# Change the <code>joysticktype</code> value to <code>fcs</code> and <code>timed</code> value to <code>false</code>.<br />
# Save your changes and run the game again.<br />
}}<br />
<br />
===Can't open Steam overlay in-game===<br />
{{ii}} The [[Steam]] overlay only works in some output modes; OpenGL seems to work the best.<ref name="Steam overlay">[https://www.gog.com/forum/general_archive/adding_dosbox_to_steam_client_and_enabling_steam_overlay Adding DOSBox to Steam Client and enabling Steam Overlay, page 1 - Forum - GOG.com]</ref><br />
<br />
{{Fixbox|description=Change output in configuration file|ref=<ref name="Steam overlay"/>|fix=<br />
# Go to the game's installation folder and edit the DOSBox configuration file (<code>.conf</code>).<br />
# Change <code>output=</code> to read <code>output=OpenGL</code><br />
# Change <code>fullresolution=</code> to read <code>fullresolution=desktop</code> for the best overlay resolution.<br />
# Save your changes. The Steam overlay should now work in-game.<br />
}}<br />
<br />
===Printer support===<br />
{{ii}} Official DOSBox builds don't support printing in games that use it.<br />
<br />
{{Fixbox|description=Enable printer support|ref=<ref>{{Refcheck|user=Garrett|date=September 27, 2017|comment=}}</ref>|fix=<br />
# Download [http://ykhwong.x-y.net/subpages/old.php DOSBox SVN Daum 20140127].<br />
# Install it over top of the game's existing DOSBox version.<br />
# Extract the [https://community.pcgamingwiki.com/files/file/952-dosbox-svn-daum-fonts/ FONTS folder] into the DOSBox SVN Daum installation folder (required for some games).<br />
# Edit the game's DOSBox configuration file and add the following lines at the bottom:<br />
<pre>[printer]<br />
printer=true<br />
dpi=360<br />
width=85<br />
height=110<br />
printoutput=printer<br />
multipage=false<br />
docpath=.<br />
timeout=0<br />
<br />
[parallel]<br />
parallel1=printer<br />
</pre><br />
<ol start="4"><br />
<li>Start the game normally.</li><br />
<li>When you are ready to print, first switch into windowed mode ({{key|Alt|Enter}}) to ensure you can see the printer dialog box.</li></ol><br />
<br />
'''Notes'''<br />
{{ii}} If DOSBox does not start printing increase the value for <code>timeout=0</code> (e.g. <code>timeout=100</code>); if a printed page is incomplete increase this to a higher value.<br />
{{ii}} If a menu bar is visible in fullscreen mode after making this change, ensure <code>output=</code> is not set to <code>OpenGL</code>.<br />
{{ii}} The printer selection window is only shown once per session; relaunch the game to change printers.<br />
{{--}} Accented characters are not printed correctly; for [[Wikipedia:Text mode|text mode]] games use [http://www.columbia.edu/~em36/wpdos/dosbox-vdos-lfn.html DOSBox SVN-lfn] to copy screen text to the clipboard.<br />
}}<br />
<br />
{{References}}<br />
<br />
[[Category:Emulation]]</div>174.93.75.115https://www.pcgamingwiki.com/w/index.php?title=DOSBox&diff=996033DOSBox2020-09-04T19:10:51Z<p>174.93.75.115: /* DOSBox-X */</p>
<hr />
<div>{{Infobox non-game<br />
|cover = DOSBox logo.png<br />
|developers = <br />
{{Infobox game/row/developer|DOSBox Team}}<br />
|release dates= <br />
{{Infobox game/row/date|Windows|July 22, 2002}}<br />
{{Infobox game/row/date|Linux|July 22, 2002}}<br />
{{Infobox game/row/date|OS X|March 30, 2006}}<br />
|winehq = <br />
|wikipedia = DOSBox<br />
}}<br />
<br />
'''Key points'''<br />
{{++}} DOSBox allows DOS-based games to run properly on modern systems.<br />
{{++}} [[Digital_rights_management_(DRM)#Disc_check|CD check]] for game being emulated can be bypassed generally by coping CD contents to a folder and [https://www.dosbox.com/wiki/MOUNT mounting] said folder as a CDROM.<br />
<br />
'''General information'''<br />
{{mm}} [http://www.dosbox.com Official DOSBox site]<br />
{{mm}} [http://www.dosbox.com/wiki/Main_Page Official DOSBox wiki]<br />
<br />
==Essential improvements==<br />
===Graphical user interface===<br />
DOSBox does not use a graphical user interface. However, front ends such as [http://members.quicknet.nl/blankendaalr/dbgl/ DBGL] can be used.<br />
====[http://members.quicknet.nl/blankendaalr/dbgl/ Dos Box Game Launcher (DBGL)]====<br />
{{++}} Features a wizard to install games.<br />
{{++}} Dosbox preinstalled in version 0.74.<br />
{{++}} Can manage different Dosbox versions.<br />
{{++}} Supports Windows, Linux and MacOS.<br />
{{ii}} Requires Java Runtime Environment.<br />
====[http://dfendreloaded.sourceforge.net/ D-Fend Reloaded]====<br />
{{++}} Does not require DOSBox to be installed.<br />
{{--}} No longer maintained<br />
<br />
===Unofficial builds===<br />
{{cleanup|section|Way too many key points. Please consolidate them}}<br />
There are various unofficial builds, typically called forks, of DOSBox which provide additional functionality such as support for Glide. A full list can be found on the [http://www.dosbox.com/wiki/SVN_Builds#List_of_SVN_Builds DOSBox Wiki].<br />
<br />
A good one to start with is [https://dosbox-x.com DOSBox-X] ([https://github.com/joncampbell123/dosbox-x project on GitHub]). It streamlines the interface and adds support for features vanilla DOSBox cannot do such as Glide support.<br />
<br />
For Mac, you should try [http://boxerapp.com Boxer]. It makes running and installation of games easier by wrapping them in [https://en.wikipedia.org/wiki/Bundle_(macOS) Application Bundles], called "Game Boxes", that can be launched in Boxer by double clicking them as well as having a builtin GUI interface for configuration that more easily integrates into the Mac OS. It also has much over looked audio features; it already includes Gravis UltraSound patches and has builtin CM-32 & MT-32L emulation available through MUNT.<br />
<br />
Also, installing [http://www.freedos.org/download/ FreeDOS] (or just it's [http://www.freedos.org/software/ included utilities]) grants a more complete DOS experience.<br />
<br />
====[https://dosboxece.yesterplay.net/ DOSBox ECE (Enhanced Community Edition)]====<br />
Currently, DOSBox ECE differs from normal DOSBox in these features:<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=41&t=41853 Emulation of a 3Dfx Vooodoo card through OpenGL] (No external Glide wrapper needed!)<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=41&t=43899 4x, 5x and 6x scaling in windowed mode is possible]<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=32&t=49160 Pixel-perfect output mode] for undistorted scaling of the picture<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=41&t=49327 Improved emulation of OPL3] (a FM sound synthesis chip from Yamaha)<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=41&t=23371 Improved sound of PC speaker emulation]<br />
{{++}} [https://sourceforge.net/projects/munt/ Emulation of the Roland MT-32 midi synthesizer]<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=32&t=27831&start=20 Integration of Fluidsynth] (a software MIDI synthesizer with Soundfont support)<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=32&t=27452 Support for up to 10 joystick axis and 2 D-pads] (full use of two 360 compatible controllers)<br />
{{++}} [https://sourceforge.net/p/dosbox/patches/264/ Mouse buttons mappable to keyboard or controller buttons]<br />
{{++}} [https://sourceforge.net/p/dosbox/patches/276/ Separate sensitivity settings for the X and Y axis of the mouse]<br />
{{++}} Supports up to 384 MB of memory, required for running Windows 9x on top of DOSBox ECE<br />
{{++}} 4MB video memory, reducing sprite flickering in games using the Build engine (“Duke Nukem 3D”, “Blood”, etc.)<br />
<br />
The DOSBox ECE developer also hosts compiled versions of the latest DOSBox SVN (development builds of the official DOSBox) on his website.<br />
<br />
====[https://dosbox-x.com/ DOSBox-X]====<br />
DOSBox-X aims to be a complete DOS emulation package that is both fully-featured and easy to use. It also tries to implement more accurate emulation both to improve the general DOS emulation and to aid retro-development. By now it has an impressive list of unique features. Some examples:<br />
{{++}} GUI menu bar and configuration tool<br />
{{++}} Built-in debugger and logging options<br />
{{++}} Automatic drive mounting (Windows only)<br />
{{++}} Copy and Paste support (Windows only)<br />
{{++}} NEC PC-98 support<br />
{{++}} Support for Windows 95 and 98<br />
{{++}} Emulation of the Roland MT-32 midi synthesizer<br />
{{++}} FluidSynth and Timidity++ General MIDI support<br />
{{++}} Save and load states<br />
{{++}} CPU optimization and Turbo mode<br />
{{++}} Improved customization on the title bar<br />
{{++}} Better compatibility with DOS applications<br />
{{++}} Built-in external tools such as CWSDPMI, DOSIDLE and IMGMAKE<br />
{{++}} Support for more DOS commands (e.g. VOL, LABEL, PROMPT, and MOUSE)<br />
{{++}} Support for more video modes (e.g. mda, mcga, cga_rgb, cga_composite, cga_composite2, amstrad)<br />
{{++}} Support for CONFIG.SYS commands (e.g. DEVICE, BUFFERS, FCBS, LASTDRIV)<br />
{{++}} Support for more CPU types (e.g. 8086, 80186, 80286, Pentium MMX and Pentium Pro)<br />
{{++}} Support for FAT32 and Long Filenames (LFN)<br />
{{++}} Support for ROM BIOS images<br />
{{++}} Support for printer output<br />
{{++}} Support for vertical sync (V-Sync)<br />
{{++}} Support for Direct3D with pixel shaders (Windows only)<br />
{{++}} Support for OpenglHQ<br />
{{++}} Support for Innovation SSI-2001 emulation<br />
{{++}} Support for 3dfx Glide and Voodoo chip emulation<br />
{{++}} Support for NE2000 Ethernet<br />
{{++}} Support for more accurate PC Speaker emulation<br />
{{++}} Support for features such as overscan border and stereo swapping<br />
{{++}} Various patches such as font, DBCS and Ctrl-Break patch<br />
<br />
====[https://github.com/dosbox-staging/dosbox-staging DOSBox-Staging]====<br />
dosbox-staging attempts to modernize the DOSBox codebase by using current development practices and tools, fixing issues, and adding features that better support today's systems.<br />
<br />
===Windows installation===<br />
Windows 3.0 through 98(SE) can be installed inside regular DOSBox however this is unsupported and instability issues occur. One of the forks, DOSBox-X does support Windows, and allows even Windows ME to run to some extend.<br />
<br />
You could also, alternatively, try [https://web.archive.org/web/20141013114801/http://www.japheth.de/HX.html The HX DOS Extender] which grants a minimal Windows runtime environment. Note that it only supports Windows console apps and simple GUI ones. An unofficial continuation of the project called HX+ can be found [http://sound-dos.ucoz.ru/load/new_hxdos_extender_2_17/1-1-0-8 here].<br />
<br />
===Example input===<br />
DOSBox running in Windows:<br />
<br />
<pre><br />
Z:\><br />
Z:\>mount c c:\game_directory<br />
Z:\>imgmount d d:\game_disc.iso -t iso<br />
Z:\>cd d:\<br />
D:\>game_install.exe<br />
D:\>cd c:\<br />
C:\><br />
C:\>game.exe</pre><br />
<br />
Substitute the pathways with the given conventions of the host operating system.<br />
<br />
{{key|Alt|Enter}} to maximise the window; {{key|Ctrl|F4}} to switch between mounted disc images. Use double quotes, " ", when mounting folders with spaces ("c:\installation folder"); For mounting multiple disc images, -t iso is required only once at the end of the last disc image, this defines how DOSBox should emulate the volume and iso defines the type of volume.<br />
<br />
===[http://dos32a.narechk.net/index_en.html DOS/32A]===<br />
DOS/32A is a more advanced extender and open source replacement to DOS4GW. It can improve both performance and stability of many games. More info [https://www.dosbox.com/wiki/TOOLS:DOS32A here].<br />
<br />
{{ii}} If DOS/32A gives you issues with a particular game, you could alternatively try the [http://www.devoresoftware.com/freesource/cwsrc.htm Causeway extender] or [http://www.sid6581.net/pmodew/ PMODE/W]. Worst-case scenario, stick with the stock extender.<ref>https://www.gog.com/forum/m_a_x_series/changing_dos_extenders_might_be_the_solution_for_all_of_us</ref><br />
<br />
===[http://www.vogonsdrivers.com/getfile.php?fileid=346 UniVBE]===<br />
Although DOSBox will not gain the performance improvements this program promises, it will add additional video modes. Although 5.0+ were initially released as commercial software, SciTech later released them as freeware. Versions 1-4 were always freeware though. The 5.x series is generally the best to use with DOSBox. Additional (possibly useful) DOS display utilities can be found [http://www.vogons.org/viewtopic.php?t=15190 here].<br />
<br />
===Gravis MIDI/Patches===<br />
The Gravis Ultra Sound or GUS was a sound card produced by Advanced Gravis Computer Technology, who were best known for their Gravis PC Gamepad. One of the features of the GUS is its ability to use real world sound samples instead of digitally generated instruments. This allows for a richer quality of sound when playing midi sound. Unfortunately, the official patches (drivers/samples) cannot be distributed with DOSBox due to conflicting Licenses. You can however find a guide for installing them [https://www.vogons.org/viewtopic.php?f=31&t=16974 here].<br><br />
A similar thing is true for some Sound Blaster games; see [http://nerdlypleasures.blogspot.com/2013/12/sound-blaster-drivers-when-dos-games.html here].<br />
<br />
==DOSBox configuration==<br />
DOSBox stores configuration information in *.conf files. Individual conf files can be create for each piece of software used and additional parameters can be appended.<br />
<br />
To modify a configuration option within DOSBox, use the <code>config</code> command. For example, <code>config cpu cycles fixed 30000</code><br />
<br />
==Video settings==<br />
{{Video settings<br />
|wsgf link = <br />
|widescreen wsgf award = <br />
|multimonitor wsgf award = <br />
|ultrawidescreen wsgf award = <br />
|4k ultra hd wsgf award = <br />
|widescreen resolution = true<br />
|widescreen resolution notes= Requires game being emulated to support it.<br />
|multimonitor = false<br />
|multimonitor notes = <br />
|ultrawidescreen = false<br />
|ultrawidescreen notes = <br />
|4k ultra hd = false<br />
|4k ultra hd notes = <br />
|fov = false<br />
|fov notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
|windowed = true<br />
|windowed notes = Toggle with {{key|Alt|Enter}}.<br />
|borderless windowed = false<br />
|borderless windowed notes = <br />
|anisotropic = false<br />
|anisotropic notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
|antialiasing = false<br />
|antialiasing notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
|vsync = true<br />
|vsync notes = Set <code>fulldouble = true</code> in the configuration file. See [[#Unofficial builds|Unofficial builds]] for more advanced implementations.<br />
|60 fps = true<br />
|60 fps notes = <br />
|120 fps = false<br />
|120 fps notes = <br />
|hdr = false<br />
|hdr notes = <br />
|color blind = false<br />
|color blind notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
}}<br />
<br />
==Input settings==<br />
{{Input settings<br />
|key remap = true<br />
|key remap notes = See [[#Mapper|Mapper]].<br />
|acceleration option = false<br />
|acceleration option notes = <br />
|mouse sensitivity = true<br />
|mouse sensitivity notes = Adjustable in DOSBox configuration settings.<br />
|mouse menu = false<br />
|mouse menu notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
|invert mouse y-axis = n/a<br />
|invert mouse y-axis notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
|controller support = true<br />
|controller support notes = See [[#Controller support|Controller support]].<br />
|full controller = unknown<br />
|full controller notes = <br />
|controller remap = unknown<br />
|controller remap notes = <br />
|controller sensitivity = unknown<br />
|controller sensitivity notes= <br />
|invert controller y-axis = unknown<br />
|invert controller y-axis notes= <br />
|touchscreen = false<br />
|touchscreen notes = <br />
|button prompts = unknown<br />
|button prompts notes = <br />
|controller hotplug = unknown<br />
|controller hotplug notes = <br />
|haptic feedback = unknown<br />
|haptic feedback notes = <br />
|simultaneous input = true<br />
|simultaneous input notes = <br />
|steam input api = unknown<br />
|steam input api notes = <br />
|light bar support = unknown<br />
|light bar support notes = <br />
}}<br />
<br />
===[[Glossary:Remapping|Remapping]]===<br />
The [http://www.dosbox.com/wiki/Mapper DOSBox Mapper] ({{key|Ctrl|F1}}/{{key|Command|F1}}) can be used to reassign keyboard, mouse and joystick commands.<br />
<br />
===[[Controller|Controller support]]===<br />
DOSBox has several virtual joystick modes which affect what inputs are seen in-game and also what inputs can be remapped using the [[#Mapper|Mapper]]. See [http://www.dosbox.com/DOSBoxManual.html#Joystick the DOSBox manual] for details.<br />
<br />
==Network==<br />
{{Network/Multiplayer<br />
|local play = true<br />
|local play players = <br />
|local play modes = <br />
|local play notes = <br />
|lan play = true<br />
|lan play players = <br />
|lan play modes = <br />
|lan play notes = <br />
|online play = true<br />
|online play players = <br />
|online play modes = <br />
|online play notes = <br />
|asynchronous = <br />
|asynchronous notes = <br />
}}{{Network/Connections<br />
|matchmaking = <br />
|matchmaking notes = <br />
|p2p = <br />
|p2p notes = <br />
|dedicated = <br />
|dedicated notes = <br />
|self-hosting = <br />
|self-hosting notes = <br />
|direct ip = <br />
|direct ip notes = <br />
}}<br />
<br />
===Net play===<br />
DOSBox supports both IPX and Modem emulation. A guide to setting it up can be found [https://www.dosbox.com/wiki/Connectivity here].<br />
There's also a guide to adding additional protocols for networking [https://www.dosbox.com/wiki/Network_Setup here]. Several method are listed.<br />
<br />
==VR support==<br />
{{VR support<br />
|gg3d name = <br />
|native 3d gg3d award = <br />
|nvidia 3d vision gg3d award = <br />
|tridef 3d gg3d award = <br />
|iz3d gg3d award = <br />
|native 3d = <br />
|native 3d notes = <br />
|nvidia 3d vision = <br />
|nvidia 3d vision notes = <br />
|tridef 3d = <br />
|tridef 3d notes = <br />
|iz3d = <br />
|iz3d notes = <br />
|vorpx = hackable<br />
|vorpx modes = 2D<br />
|vorpx notes = Not officially supported, requires [http://ykhwong.x-y.net/ this DOSBOX version]. See also [https://www.vorpx.com/forums/topic/dosbox/#post-126136 here]. <br />
|htc vive = <br />
|htc vive notes = <br />
|oculus rift = <br />
|oculus rift notes = <br />
|osvr = <br />
|osvr notes = <br />
|windows mixed reality = <br />
|windows mixed reality notes = <br />
|keyboard-mouse = <br />
|keyboard-mouse notes = <br />
|3rd space gaming vest = <br />
|3rd space gaming vest notes = <br />
|novint falcon = <br />
|novint falcon notes = <br />
|trackir = <br />
|trackir notes = <br />
|tobii eye tracking = <br />
|tobii eye tracking notes = <br />
|play area seated = <br />
|play area seated notes = <br />
|play area standing = <br />
|play area standing notes = <br />
|play area room-scale = <br />
|play area room-scale notes = <br />
}}<br />
<br />
==Issues fixed==<br />
===Game appears stretched horizontally===<br />
{{Fixbox|description=Fix incorrect aspect ratio|ref={{cn|date=February 2017}}|fix=<br />
{{ii}} Many DOS games are designed to run at 320x200 or 640x400, but with a 4:3 aspect ratio. To set this, do the following:<br />
* Go to the <code>[render]</code> section of the DOSBox configuration file and change <code>aspect=false</code> to <code>aspect=true</code>.<br />
* If you are using Boxer, you can also use the '''View - Use 4:3 Aspect Ratio''' item in the menu.<br />
}}<br />
<br />
===Green or black screen in fullscreen mode===<br />
{{ii}} With some video cards, DOSBox's default output mode will render with a green or black screen in fullscreen mode.<br />
<br />
{{Fixbox|description=Edit DOSBox configuration file (DOSBox.com versions)|fix=<br />
# Edit the DOSBox configuration file (<code>dosbox-0.74.conf</code>, <code>dosbox.conf</code>, or similar).<br />
# Change <code>output=surface</code> to <code>output=overlay</code><br />
# Save your changes and run the game again.<br />
{{ii}} If the problem persists, edit it again and try different modes until you get one that works.<br />
}}<br />
{{Fixbox|description=Run Graphic Mode Setup (GOG.com versions)|fix=<br />
# Run the game's Graphic Mode Setup in the Start Screen/Start Menu.<br />
# Change Graphic mode to "Overlay" or "DDraw".<br />
# Choose Save Settings and run the game again.<br />
{{ii}} If the problem persists, run it again and try different modes until you get one that works.<br />
{{--}} GOG's setup utility can be rather buggy: it may crash, freeze or simply not save changed settings when exiting.<br />
}}<br />
<br />
===Character/camera/cursor constantly moves in one direction===<br />
{{Fixbox|description=Change joystick timing setting|fix=<br />
# Edit the game's DOSBox configuration file.<br />
# Change <code>timed=true</code> to <code>timed=false</code> (if it is already set to this, try <code>timed=true</code> instead).<br />
# Save your changes and run the game again.<br />
}}<br />
<br />
{{Fixbox|description=Disable joystick support|fix=<br />
{{ii}} This fix is only suitable if you don't want to use a controller with the game.<br />
# Edit the game's DOSBox configuration file.<br />
# Change the <code>joysticktype</code> value to <code>none</code><br />
# Save your changes and run the game again.<br />
}}<br />
<br />
===Can't remap keys/joystick===<br />
Some games have fixed inputs. Use the [http://www.dosbox.com/wiki/Mapper DOSBox Mapper] to remap the controls.<br />
<br />
===Unable to use D-pad/Analog stick not working (XInput controllers)===<br />
{{Fixbox|description=Change DOSBox configuration file|ref=<ref>[https://www.gog.com/forum/general/about_dosbox_and_xbox_360xinput_controllers About DOSBox and Xbox 360/XInput Controllers, page 1 - Forum - GOG.com]</ref>|fix=<br />
# Edit the game's DOSBox configuration file.<br />
# Change the <code>joysticktype</code> value to <code>fcs</code> and <code>timed</code> value to <code>false</code>.<br />
# Save your changes and run the game again.<br />
}}<br />
<br />
===Can't open Steam overlay in-game===<br />
{{ii}} The [[Steam]] overlay only works in some output modes; OpenGL seems to work the best.<ref name="Steam overlay">[https://www.gog.com/forum/general_archive/adding_dosbox_to_steam_client_and_enabling_steam_overlay Adding DOSBox to Steam Client and enabling Steam Overlay, page 1 - Forum - GOG.com]</ref><br />
<br />
{{Fixbox|description=Change output in configuration file|ref=<ref name="Steam overlay"/>|fix=<br />
# Go to the game's installation folder and edit the DOSBox configuration file (<code>.conf</code>).<br />
# Change <code>output=</code> to read <code>output=OpenGL</code><br />
# Change <code>fullresolution=</code> to read <code>fullresolution=desktop</code> for the best overlay resolution.<br />
# Save your changes. The Steam overlay should now work in-game.<br />
}}<br />
<br />
===Printer support===<br />
{{ii}} Official DOSBox builds don't support printing in games that use it.<br />
<br />
{{Fixbox|description=Enable printer support|ref=<ref>{{Refcheck|user=Garrett|date=September 27, 2017|comment=}}</ref>|fix=<br />
# Download [http://ykhwong.x-y.net/subpages/old.php DOSBox SVN Daum 20140127].<br />
# Install it over top of the game's existing DOSBox version.<br />
# Extract the [https://community.pcgamingwiki.com/files/file/952-dosbox-svn-daum-fonts/ FONTS folder] into the DOSBox SVN Daum installation folder (required for some games).<br />
# Edit the game's DOSBox configuration file and add the following lines at the bottom:<br />
<pre>[printer]<br />
printer=true<br />
dpi=360<br />
width=85<br />
height=110<br />
printoutput=printer<br />
multipage=false<br />
docpath=.<br />
timeout=0<br />
<br />
[parallel]<br />
parallel1=printer<br />
</pre><br />
<ol start="4"><br />
<li>Start the game normally.</li><br />
<li>When you are ready to print, first switch into windowed mode ({{key|Alt|Enter}}) to ensure you can see the printer dialog box.</li></ol><br />
<br />
'''Notes'''<br />
{{ii}} If DOSBox does not start printing increase the value for <code>timeout=0</code> (e.g. <code>timeout=100</code>); if a printed page is incomplete increase this to a higher value.<br />
{{ii}} If a menu bar is visible in fullscreen mode after making this change, ensure <code>output=</code> is not set to <code>OpenGL</code>.<br />
{{ii}} The printer selection window is only shown once per session; relaunch the game to change printers.<br />
{{--}} Accented characters are not printed correctly; for [[Wikipedia:Text mode|text mode]] games use [http://www.columbia.edu/~em36/wpdos/dosbox-vdos-lfn.html DOSBox SVN-lfn] to copy screen text to the clipboard.<br />
}}<br />
<br />
{{References}}<br />
<br />
[[Category:Emulation]]</div>174.93.75.115https://www.pcgamingwiki.com/w/index.php?title=DOSBox&diff=996026DOSBox2020-09-04T19:04:02Z<p>174.93.75.115: /* Unofficial builds */</p>
<hr />
<div>{{Infobox non-game<br />
|cover = DOSBox logo.png<br />
|developers = <br />
{{Infobox game/row/developer|DOSBox Team}}<br />
|release dates= <br />
{{Infobox game/row/date|Windows|July 22, 2002}}<br />
{{Infobox game/row/date|Linux|July 22, 2002}}<br />
{{Infobox game/row/date|OS X|March 30, 2006}}<br />
|winehq = <br />
|wikipedia = DOSBox<br />
}}<br />
<br />
'''Key points'''<br />
{{++}} DOSBox allows DOS-based games to run properly on modern systems.<br />
{{++}} [[Digital_rights_management_(DRM)#Disc_check|CD check]] for game being emulated can be bypassed generally by coping CD contents to a folder and [https://www.dosbox.com/wiki/MOUNT mounting] said folder as a CDROM.<br />
<br />
'''General information'''<br />
{{mm}} [http://www.dosbox.com Official DOSBox site]<br />
{{mm}} [http://www.dosbox.com/wiki/Main_Page Official DOSBox wiki]<br />
<br />
==Essential improvements==<br />
===Graphical user interface===<br />
DOSBox does not use a graphical user interface. However, front ends such as [http://members.quicknet.nl/blankendaalr/dbgl/ DBGL] can be used.<br />
====[http://members.quicknet.nl/blankendaalr/dbgl/ Dos Box Game Launcher (DBGL)]====<br />
{{++}} Features a wizard to install games.<br />
{{++}} Dosbox preinstalled in version 0.74.<br />
{{++}} Can manage different Dosbox versions.<br />
{{++}} Supports Windows, Linux and MacOS.<br />
{{ii}} Requires Java Runtime Environment.<br />
====[http://dfendreloaded.sourceforge.net/ D-Fend Reloaded]====<br />
{{++}} Does not require DOSBox to be installed.<br />
{{--}} No longer maintained<br />
<br />
===Unofficial builds===<br />
{{cleanup|section|Way too many key points. Please consolidate them}}<br />
There are various unofficial builds, typically called forks, of DOSBox which provide additional functionality such as support for Glide. A full list can be found on the [http://www.dosbox.com/wiki/SVN_Builds#List_of_SVN_Builds DOSBox Wiki].<br />
<br />
A good one to start with is [https://dosbox-x.com DOSBox-X] ([https://github.com/joncampbell123/dosbox-x project on GitHub]). It streamlines the interface and adds support for features vanilla DOSBox cannot do such as Glide support.<br />
<br />
For Mac, you should try [http://boxerapp.com Boxer]. It makes running and installation of games easier by wrapping them in [https://en.wikipedia.org/wiki/Bundle_(macOS) Application Bundles], called "Game Boxes", that can be launched in Boxer by double clicking them as well as having a builtin GUI interface for configuration that more easily integrates into the Mac OS. It also has much over looked audio features; it already includes Gravis UltraSound patches and has builtin CM-32 & MT-32L emulation available through MUNT.<br />
<br />
Also, installing [http://www.freedos.org/download/ FreeDOS] (or just it's [http://www.freedos.org/software/ included utilities]) grants a more complete DOS experience.<br />
<br />
====[https://dosboxece.yesterplay.net/ DOSBox ECE (Enhanced Community Edition)]====<br />
Currently, DOSBox ECE differs from normal DOSBox in these features:<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=41&t=41853 Emulation of a 3Dfx Vooodoo card through OpenGL] (No external Glide wrapper needed!)<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=41&t=43899 4x, 5x and 6x scaling in windowed mode is possible]<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=32&t=49160 Pixel-perfect output mode] for undistorted scaling of the picture<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=41&t=49327 Improved emulation of OPL3] (a FM sound synthesis chip from Yamaha)<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=41&t=23371 Improved sound of PC speaker emulation]<br />
{{++}} [https://sourceforge.net/projects/munt/ Emulation of the Roland MT-32 midi synthesizer]<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=32&t=27831&start=20 Integration of Fluidsynth] (a software MIDI synthesizer with Soundfont support)<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=32&t=27452 Support for up to 10 joystick axis and 2 D-pads] (full use of two 360 compatible controllers)<br />
{{++}} [https://sourceforge.net/p/dosbox/patches/264/ Mouse buttons mappable to keyboard or controller buttons]<br />
{{++}} [https://sourceforge.net/p/dosbox/patches/276/ Separate sensitivity settings for the X and Y axis of the mouse]<br />
{{++}} Supports up to 384 MB of memory, required for running Windows 9x on top of DOSBox ECE<br />
{{++}} 4MB video memory, reducing sprite flickering in games using the Build engine (“Duke Nukem 3D”, “Blood”, etc.)<br />
<br />
The DOSBox ECE developer also hosts compiled versions of the latest DOSBox SVN (development builds of the official DOSBox) on his website.<br />
<br />
====[https://dosbox-x.com/ DOSBox-X]====<br />
DOSBox-X aims to be a complete DOS emulation package that is both fully-featured and easy to use. By now it has an impressive list of unique features. Some examples:<br />
{{++}} GUI menu bar and configuration tool<br />
{{++}} Built-in debugger and logging options<br />
{{++}} Automatic drive mounting (Windows only)<br />
{{++}} Copy and Paste support (Windows only)<br />
{{++}} NEC PC-98 support<br />
{{++}} Support for Windows 95 and 98<br />
{{++}} Emulation of the Roland MT-32 midi synthesizer<br />
{{++}} FluidSynth and Timidity++ General MIDI support<br />
{{++}} Save and load states<br />
{{++}} CPU optimization and Turbo mode<br />
{{++}} Improved customization on the title bar<br />
{{++}} Better compatibility with DOS applications<br />
{{++}} Built-in external tools such as CWSDPMI, DOSIDLE and IMGMAKE<br />
{{++}} Support for more DOS commands (e.g. VOL, LABEL, PROMPT, and MOUSE)<br />
{{++}} Support for more video modes (e.g. mda, mcga, cga_rgb, cga_composite, cga_composite2, amstrad)<br />
{{++}} Support for CONFIG.SYS commands (e.g. DEVICE, BUFFERS, FCBS, LASTDRIV)<br />
{{++}} Support for more CPU types (e.g. 8086, 80186, 80286, Pentium MMX and Pentium Pro)<br />
{{++}} Support for FAT32 and Long Filenames (LFN)<br />
{{++}} Support for ROM BIOS images<br />
{{++}} Support for printer output<br />
{{++}} Support for vertical sync (V-Sync)<br />
{{++}} Support for Direct3D with pixel shaders (Windows only)<br />
{{++}} Support for OpenglHQ<br />
{{++}} Support for Innovation SSI-2001 emulation<br />
{{++}} Support for 3dfx Glide and Voodoo chip emulation<br />
{{++}} Support for NE2000 Ethernet<br />
{{++}} Support for more accurate PC Speaker emulation<br />
{{++}} Support for features such as overscan border and stereo swapping<br />
{{++}} Various patches such as font, DBCS and Ctrl-Break patch<br />
<br />
====[https://github.com/dosbox-staging/dosbox-staging DOSBox-Staging]====<br />
dosbox-staging attempts to modernize the DOSBox codebase by using current development practices and tools, fixing issues, and adding features that better support today's systems.<br />
<br />
===Windows installation===<br />
Windows 3.0 through 98(SE) can be installed inside regular DOSBox however this is unsupported and instability issues occur. One of the forks, DOSBox-X does support Windows, and allows even Windows ME to run to some extend.<br />
<br />
You could also, alternatively, try [https://web.archive.org/web/20141013114801/http://www.japheth.de/HX.html The HX DOS Extender] which grants a minimal Windows runtime environment. Note that it only supports Windows console apps and simple GUI ones. An unofficial continuation of the project called HX+ can be found [http://sound-dos.ucoz.ru/load/new_hxdos_extender_2_17/1-1-0-8 here].<br />
<br />
===Example input===<br />
DOSBox running in Windows:<br />
<br />
<pre><br />
Z:\><br />
Z:\>mount c c:\game_directory<br />
Z:\>imgmount d d:\game_disc.iso -t iso<br />
Z:\>cd d:\<br />
D:\>game_install.exe<br />
D:\>cd c:\<br />
C:\><br />
C:\>game.exe</pre><br />
<br />
Substitute the pathways with the given conventions of the host operating system.<br />
<br />
{{key|Alt|Enter}} to maximise the window; {{key|Ctrl|F4}} to switch between mounted disc images. Use double quotes, " ", when mounting folders with spaces ("c:\installation folder"); For mounting multiple disc images, -t iso is required only once at the end of the last disc image, this defines how DOSBox should emulate the volume and iso defines the type of volume.<br />
<br />
===[http://dos32a.narechk.net/index_en.html DOS/32A]===<br />
DOS/32A is a more advanced extender and open source replacement to DOS4GW. It can improve both performance and stability of many games. More info [https://www.dosbox.com/wiki/TOOLS:DOS32A here].<br />
<br />
{{ii}} If DOS/32A gives you issues with a particular game, you could alternatively try the [http://www.devoresoftware.com/freesource/cwsrc.htm Causeway extender] or [http://www.sid6581.net/pmodew/ PMODE/W]. Worst-case scenario, stick with the stock extender.<ref>https://www.gog.com/forum/m_a_x_series/changing_dos_extenders_might_be_the_solution_for_all_of_us</ref><br />
<br />
===[http://www.vogonsdrivers.com/getfile.php?fileid=346 UniVBE]===<br />
Although DOSBox will not gain the performance improvements this program promises, it will add additional video modes. Although 5.0+ were initially released as commercial software, SciTech later released them as freeware. Versions 1-4 were always freeware though. The 5.x series is generally the best to use with DOSBox. Additional (possibly useful) DOS display utilities can be found [http://www.vogons.org/viewtopic.php?t=15190 here].<br />
<br />
===Gravis MIDI/Patches===<br />
The Gravis Ultra Sound or GUS was a sound card produced by Advanced Gravis Computer Technology, who were best known for their Gravis PC Gamepad. One of the features of the GUS is its ability to use real world sound samples instead of digitally generated instruments. This allows for a richer quality of sound when playing midi sound. Unfortunately, the official patches (drivers/samples) cannot be distributed with DOSBox due to conflicting Licenses. You can however find a guide for installing them [https://www.vogons.org/viewtopic.php?f=31&t=16974 here].<br><br />
A similar thing is true for some Sound Blaster games; see [http://nerdlypleasures.blogspot.com/2013/12/sound-blaster-drivers-when-dos-games.html here].<br />
<br />
==DOSBox configuration==<br />
DOSBox stores configuration information in *.conf files. Individual conf files can be create for each piece of software used and additional parameters can be appended.<br />
<br />
To modify a configuration option within DOSBox, use the <code>config</code> command. For example, <code>config cpu cycles fixed 30000</code><br />
<br />
==Video settings==<br />
{{Video settings<br />
|wsgf link = <br />
|widescreen wsgf award = <br />
|multimonitor wsgf award = <br />
|ultrawidescreen wsgf award = <br />
|4k ultra hd wsgf award = <br />
|widescreen resolution = true<br />
|widescreen resolution notes= Requires game being emulated to support it.<br />
|multimonitor = false<br />
|multimonitor notes = <br />
|ultrawidescreen = false<br />
|ultrawidescreen notes = <br />
|4k ultra hd = false<br />
|4k ultra hd notes = <br />
|fov = false<br />
|fov notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
|windowed = true<br />
|windowed notes = Toggle with {{key|Alt|Enter}}.<br />
|borderless windowed = false<br />
|borderless windowed notes = <br />
|anisotropic = false<br />
|anisotropic notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
|antialiasing = false<br />
|antialiasing notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
|vsync = true<br />
|vsync notes = Set <code>fulldouble = true</code> in the configuration file. See [[#Unofficial builds|Unofficial builds]] for more advanced implementations.<br />
|60 fps = true<br />
|60 fps notes = <br />
|120 fps = false<br />
|120 fps notes = <br />
|hdr = false<br />
|hdr notes = <br />
|color blind = false<br />
|color blind notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
}}<br />
<br />
==Input settings==<br />
{{Input settings<br />
|key remap = true<br />
|key remap notes = See [[#Mapper|Mapper]].<br />
|acceleration option = false<br />
|acceleration option notes = <br />
|mouse sensitivity = true<br />
|mouse sensitivity notes = Adjustable in DOSBox configuration settings.<br />
|mouse menu = false<br />
|mouse menu notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
|invert mouse y-axis = n/a<br />
|invert mouse y-axis notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
|controller support = true<br />
|controller support notes = See [[#Controller support|Controller support]].<br />
|full controller = unknown<br />
|full controller notes = <br />
|controller remap = unknown<br />
|controller remap notes = <br />
|controller sensitivity = unknown<br />
|controller sensitivity notes= <br />
|invert controller y-axis = unknown<br />
|invert controller y-axis notes= <br />
|touchscreen = false<br />
|touchscreen notes = <br />
|button prompts = unknown<br />
|button prompts notes = <br />
|controller hotplug = unknown<br />
|controller hotplug notes = <br />
|haptic feedback = unknown<br />
|haptic feedback notes = <br />
|simultaneous input = true<br />
|simultaneous input notes = <br />
|steam input api = unknown<br />
|steam input api notes = <br />
|light bar support = unknown<br />
|light bar support notes = <br />
}}<br />
<br />
===[[Glossary:Remapping|Remapping]]===<br />
The [http://www.dosbox.com/wiki/Mapper DOSBox Mapper] ({{key|Ctrl|F1}}/{{key|Command|F1}}) can be used to reassign keyboard, mouse and joystick commands.<br />
<br />
===[[Controller|Controller support]]===<br />
DOSBox has several virtual joystick modes which affect what inputs are seen in-game and also what inputs can be remapped using the [[#Mapper|Mapper]]. See [http://www.dosbox.com/DOSBoxManual.html#Joystick the DOSBox manual] for details.<br />
<br />
==Network==<br />
{{Network/Multiplayer<br />
|local play = true<br />
|local play players = <br />
|local play modes = <br />
|local play notes = <br />
|lan play = true<br />
|lan play players = <br />
|lan play modes = <br />
|lan play notes = <br />
|online play = true<br />
|online play players = <br />
|online play modes = <br />
|online play notes = <br />
|asynchronous = <br />
|asynchronous notes = <br />
}}{{Network/Connections<br />
|matchmaking = <br />
|matchmaking notes = <br />
|p2p = <br />
|p2p notes = <br />
|dedicated = <br />
|dedicated notes = <br />
|self-hosting = <br />
|self-hosting notes = <br />
|direct ip = <br />
|direct ip notes = <br />
}}<br />
<br />
===Net play===<br />
DOSBox supports both IPX and Modem emulation. A guide to setting it up can be found [https://www.dosbox.com/wiki/Connectivity here].<br />
There's also a guide to adding additional protocols for networking [https://www.dosbox.com/wiki/Network_Setup here]. Several method are listed.<br />
<br />
==VR support==<br />
{{VR support<br />
|gg3d name = <br />
|native 3d gg3d award = <br />
|nvidia 3d vision gg3d award = <br />
|tridef 3d gg3d award = <br />
|iz3d gg3d award = <br />
|native 3d = <br />
|native 3d notes = <br />
|nvidia 3d vision = <br />
|nvidia 3d vision notes = <br />
|tridef 3d = <br />
|tridef 3d notes = <br />
|iz3d = <br />
|iz3d notes = <br />
|vorpx = hackable<br />
|vorpx modes = 2D<br />
|vorpx notes = Not officially supported, requires [http://ykhwong.x-y.net/ this DOSBOX version]. See also [https://www.vorpx.com/forums/topic/dosbox/#post-126136 here]. <br />
|htc vive = <br />
|htc vive notes = <br />
|oculus rift = <br />
|oculus rift notes = <br />
|osvr = <br />
|osvr notes = <br />
|windows mixed reality = <br />
|windows mixed reality notes = <br />
|keyboard-mouse = <br />
|keyboard-mouse notes = <br />
|3rd space gaming vest = <br />
|3rd space gaming vest notes = <br />
|novint falcon = <br />
|novint falcon notes = <br />
|trackir = <br />
|trackir notes = <br />
|tobii eye tracking = <br />
|tobii eye tracking notes = <br />
|play area seated = <br />
|play area seated notes = <br />
|play area standing = <br />
|play area standing notes = <br />
|play area room-scale = <br />
|play area room-scale notes = <br />
}}<br />
<br />
==Issues fixed==<br />
===Game appears stretched horizontally===<br />
{{Fixbox|description=Fix incorrect aspect ratio|ref={{cn|date=February 2017}}|fix=<br />
{{ii}} Many DOS games are designed to run at 320x200 or 640x400, but with a 4:3 aspect ratio. To set this, do the following:<br />
* Go to the <code>[render]</code> section of the DOSBox configuration file and change <code>aspect=false</code> to <code>aspect=true</code>.<br />
* If you are using Boxer, you can also use the '''View - Use 4:3 Aspect Ratio''' item in the menu.<br />
}}<br />
<br />
===Green or black screen in fullscreen mode===<br />
{{ii}} With some video cards, DOSBox's default output mode will render with a green or black screen in fullscreen mode.<br />
<br />
{{Fixbox|description=Edit DOSBox configuration file (DOSBox.com versions)|fix=<br />
# Edit the DOSBox configuration file (<code>dosbox-0.74.conf</code>, <code>dosbox.conf</code>, or similar).<br />
# Change <code>output=surface</code> to <code>output=overlay</code><br />
# Save your changes and run the game again.<br />
{{ii}} If the problem persists, edit it again and try different modes until you get one that works.<br />
}}<br />
{{Fixbox|description=Run Graphic Mode Setup (GOG.com versions)|fix=<br />
# Run the game's Graphic Mode Setup in the Start Screen/Start Menu.<br />
# Change Graphic mode to "Overlay" or "DDraw".<br />
# Choose Save Settings and run the game again.<br />
{{ii}} If the problem persists, run it again and try different modes until you get one that works.<br />
{{--}} GOG's setup utility can be rather buggy: it may crash, freeze or simply not save changed settings when exiting.<br />
}}<br />
<br />
===Character/camera/cursor constantly moves in one direction===<br />
{{Fixbox|description=Change joystick timing setting|fix=<br />
# Edit the game's DOSBox configuration file.<br />
# Change <code>timed=true</code> to <code>timed=false</code> (if it is already set to this, try <code>timed=true</code> instead).<br />
# Save your changes and run the game again.<br />
}}<br />
<br />
{{Fixbox|description=Disable joystick support|fix=<br />
{{ii}} This fix is only suitable if you don't want to use a controller with the game.<br />
# Edit the game's DOSBox configuration file.<br />
# Change the <code>joysticktype</code> value to <code>none</code><br />
# Save your changes and run the game again.<br />
}}<br />
<br />
===Can't remap keys/joystick===<br />
Some games have fixed inputs. Use the [http://www.dosbox.com/wiki/Mapper DOSBox Mapper] to remap the controls.<br />
<br />
===Unable to use D-pad/Analog stick not working (XInput controllers)===<br />
{{Fixbox|description=Change DOSBox configuration file|ref=<ref>[https://www.gog.com/forum/general/about_dosbox_and_xbox_360xinput_controllers About DOSBox and Xbox 360/XInput Controllers, page 1 - Forum - GOG.com]</ref>|fix=<br />
# Edit the game's DOSBox configuration file.<br />
# Change the <code>joysticktype</code> value to <code>fcs</code> and <code>timed</code> value to <code>false</code>.<br />
# Save your changes and run the game again.<br />
}}<br />
<br />
===Can't open Steam overlay in-game===<br />
{{ii}} The [[Steam]] overlay only works in some output modes; OpenGL seems to work the best.<ref name="Steam overlay">[https://www.gog.com/forum/general_archive/adding_dosbox_to_steam_client_and_enabling_steam_overlay Adding DOSBox to Steam Client and enabling Steam Overlay, page 1 - Forum - GOG.com]</ref><br />
<br />
{{Fixbox|description=Change output in configuration file|ref=<ref name="Steam overlay"/>|fix=<br />
# Go to the game's installation folder and edit the DOSBox configuration file (<code>.conf</code>).<br />
# Change <code>output=</code> to read <code>output=OpenGL</code><br />
# Change <code>fullresolution=</code> to read <code>fullresolution=desktop</code> for the best overlay resolution.<br />
# Save your changes. The Steam overlay should now work in-game.<br />
}}<br />
<br />
===Printer support===<br />
{{ii}} Official DOSBox builds don't support printing in games that use it.<br />
<br />
{{Fixbox|description=Enable printer support|ref=<ref>{{Refcheck|user=Garrett|date=September 27, 2017|comment=}}</ref>|fix=<br />
# Download [http://ykhwong.x-y.net/subpages/old.php DOSBox SVN Daum 20140127].<br />
# Install it over top of the game's existing DOSBox version.<br />
# Extract the [https://community.pcgamingwiki.com/files/file/952-dosbox-svn-daum-fonts/ FONTS folder] into the DOSBox SVN Daum installation folder (required for some games).<br />
# Edit the game's DOSBox configuration file and add the following lines at the bottom:<br />
<pre>[printer]<br />
printer=true<br />
dpi=360<br />
width=85<br />
height=110<br />
printoutput=printer<br />
multipage=false<br />
docpath=.<br />
timeout=0<br />
<br />
[parallel]<br />
parallel1=printer<br />
</pre><br />
<ol start="4"><br />
<li>Start the game normally.</li><br />
<li>When you are ready to print, first switch into windowed mode ({{key|Alt|Enter}}) to ensure you can see the printer dialog box.</li></ol><br />
<br />
'''Notes'''<br />
{{ii}} If DOSBox does not start printing increase the value for <code>timeout=0</code> (e.g. <code>timeout=100</code>); if a printed page is incomplete increase this to a higher value.<br />
{{ii}} If a menu bar is visible in fullscreen mode after making this change, ensure <code>output=</code> is not set to <code>OpenGL</code>.<br />
{{ii}} The printer selection window is only shown once per session; relaunch the game to change printers.<br />
{{--}} Accented characters are not printed correctly; for [[Wikipedia:Text mode|text mode]] games use [http://www.columbia.edu/~em36/wpdos/dosbox-vdos-lfn.html DOSBox SVN-lfn] to copy screen text to the clipboard.<br />
}}<br />
<br />
{{References}}<br />
<br />
[[Category:Emulation]]</div>174.93.75.115https://www.pcgamingwiki.com/w/index.php?title=DOSBox&diff=996023DOSBox2020-09-04T19:01:02Z<p>174.93.75.115: /* Unofficial builds */ DOSBox-X homepage</p>
<hr />
<div>{{Infobox non-game<br />
|cover = DOSBox logo.png<br />
|developers = <br />
{{Infobox game/row/developer|DOSBox Team}}<br />
|release dates= <br />
{{Infobox game/row/date|Windows|July 22, 2002}}<br />
{{Infobox game/row/date|Linux|July 22, 2002}}<br />
{{Infobox game/row/date|OS X|March 30, 2006}}<br />
|winehq = <br />
|wikipedia = DOSBox<br />
}}<br />
<br />
'''Key points'''<br />
{{++}} DOSBox allows DOS-based games to run properly on modern systems.<br />
{{++}} [[Digital_rights_management_(DRM)#Disc_check|CD check]] for game being emulated can be bypassed generally by coping CD contents to a folder and [https://www.dosbox.com/wiki/MOUNT mounting] said folder as a CDROM.<br />
<br />
'''General information'''<br />
{{mm}} [http://www.dosbox.com Official DOSBox site]<br />
{{mm}} [http://www.dosbox.com/wiki/Main_Page Official DOSBox wiki]<br />
<br />
==Essential improvements==<br />
===Graphical user interface===<br />
DOSBox does not use a graphical user interface. However, front ends such as [http://members.quicknet.nl/blankendaalr/dbgl/ DBGL] can be used.<br />
====[http://members.quicknet.nl/blankendaalr/dbgl/ Dos Box Game Launcher (DBGL)]====<br />
{{++}} Features a wizard to install games.<br />
{{++}} Dosbox preinstalled in version 0.74.<br />
{{++}} Can manage different Dosbox versions.<br />
{{++}} Supports Windows, Linux and MacOS.<br />
{{ii}} Requires Java Runtime Environment.<br />
====[http://dfendreloaded.sourceforge.net/ D-Fend Reloaded]====<br />
{{++}} Does not require DOSBox to be installed.<br />
{{--}} No longer maintained<br />
<br />
===Unofficial builds===<br />
{{cleanup|section|Way too many key points. Please consolidate them}}<br />
There are various unofficial builds, typically called forks, of DOSBox which provide additional functionality such as support for Glide. A full list can be found on the [http://www.dosbox.com/wiki/SVN_Builds#List_of_SVN_Builds DOSBox Wiki].<br />
<br />
A good one to start with is [https://dosbox-x.com DOSBox-X] ([https://github.com/joncampbell123/dosbox-x project on GitHub]). It streamlines the interface and adds support for features vanilla DOSBox cannot do such as Glide support.<br />
<br />
For Mac, you should try [http://boxerapp.com Boxer]. It makes running and installation of games easier by wrapping them in [https://en.wikipedia.org/wiki/Bundle_(macOS) Application Bundles], called "Game Boxes", that can be launched in Boxer by double clicking them as well as having a builtin GUI interface for configuration that more easily integrates into the Mac OS. It also has much over looked audio features; it already includes Gravis UltraSound patches and has builtin CM-32 & MT-32L emulation available through MUNT.<br />
<br />
Also, installing [http://www.freedos.org/download/ FreeDOS] (or just it's [http://www.freedos.org/software/ included utilities]) grants a more complete DOS experience.<br />
<br />
====[https://dosboxece.yesterplay.net/ DOSBox ECE (Enhanced Community Edition)]====<br />
Currently, DOSBox ECE differs from normal DOSBox in these features:<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=41&t=41853 Emulation of a 3Dfx Vooodoo card through OpenGL] (No external Glide wrapper needed!)<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=41&t=43899 4x, 5x and 6x scaling in windowed mode is possible]<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=32&t=49160 Pixel-perfect output mode] for undistorted scaling of the picture<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=41&t=49327 Improved emulation of OPL3] (a FM sound synthesis chip from Yamaha)<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=41&t=23371 Improved sound of PC speaker emulation]<br />
{{++}} [https://sourceforge.net/projects/munt/ Emulation of the Roland MT-32 midi synthesizer]<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=32&t=27831&start=20 Integration of Fluidsynth] (a software MIDI synthesizer with Soundfont support)<br />
{{++}} [http://www.vogons.org/viewtopic.php?f=32&t=27452 Support for up to 10 joystick axis and 2 D-pads] (full use of two 360 compatible controllers)<br />
{{++}} [https://sourceforge.net/p/dosbox/patches/264/ Mouse buttons mappable to keyboard or controller buttons]<br />
{{++}} [https://sourceforge.net/p/dosbox/patches/276/ Separate sensitivity settings for the X and Y axis of the mouse]<br />
{{++}} Supports up to 384 MB of memory, required for running Windows 9x on top of DOSBox ECE<br />
{{++}} 4MB video memory, reducing sprite flickering in games using the Build engine (“Duke Nukem 3D”, “Blood”, etc.)<br />
<br />
The DOSBox ECE developer also hosts compiled versions of the latest DOSBox SVN (development builds of the official DOSBox) on his website.<br />
<br />
====[https://dosbox-x.com/ DOSBox-X]====<br />
The focus of DOSBox-X lies on accuracy and historical preservation. As such it may not be the fastest option available. Regardless however, it has an impressive list of unique features. Some examples:<br />
{{++}} GUI menu bar and configuration tool<br />
{{++}} Built-in debugger and logging options<br />
{{++}} Automatic drive mounting (Windows only)<br />
{{++}} Copy and Paste support (Windows only)<br />
{{++}} NEC PC-98 support<br />
{{++}} Support for Windows 95 and 98<br />
{{++}} Emulation of the Roland MT-32 midi synthesizer<br />
{{++}} FluidSynth and Timidity++ General MIDI support<br />
{{++}} Save and load states<br />
{{++}} CPU optimization and Turbo mode<br />
{{++}} Improved customization on the title bar<br />
{{++}} Better compatibility with DOS applications<br />
{{++}} Built-in external tools such as CWSDPMI, DOSIDLE and IMGMAKE<br />
{{++}} Support for more DOS commands (e.g. VOL, LABEL, PROMPT, and MOUSE)<br />
{{++}} Support for more video modes (e.g. mda, mcga, cga_rgb, cga_composite, cga_composite2, amstrad)<br />
{{++}} Support for CONFIG.SYS commands (e.g. DEVICE, BUFFERS, FCBS, LASTDRIV)<br />
{{++}} Support for more CPU types (e.g. 8086, 80186, 80286, Pentium MMX and Pentium Pro)<br />
{{++}} Support for FAT32 and Long Filenames (LFN)<br />
{{++}} Support for ROM BIOS images<br />
{{++}} Support for printer output<br />
{{++}} Support for vertical sync (V-Sync)<br />
{{++}} Support for Direct3D with pixel shaders (Windows only)<br />
{{++}} Support for OpenglHQ<br />
{{++}} Support for Innovation SSI-2001 emulation<br />
{{++}} Support for 3dfx Glide and Voodoo chip emulation<br />
{{++}} Support for NE2000 Ethernet<br />
{{++}} Support for more accurate PC Speaker emulation<br />
{{++}} Support for features such as overscan border and stereo swapping<br />
{{++}} Various patches such as font, DBCS and Ctrl-Break patch<br />
<br />
====[https://github.com/dosbox-staging/dosbox-staging DOSBox-Staging]====<br />
dosbox-staging attempts to modernize the DOSBox codebase by using current development practices and tools, fixing issues, and adding features that better support today's systems.<br />
<br />
===Windows installation===<br />
Windows 3.0 through 98(SE) can be installed inside regular DOSBox however this is unsupported and instability issues occur. One of the forks, DOSBox-X does support Windows, and allows even Windows ME to run to some extend.<br />
<br />
You could also, alternatively, try [https://web.archive.org/web/20141013114801/http://www.japheth.de/HX.html The HX DOS Extender] which grants a minimal Windows runtime environment. Note that it only supports Windows console apps and simple GUI ones. An unofficial continuation of the project called HX+ can be found [http://sound-dos.ucoz.ru/load/new_hxdos_extender_2_17/1-1-0-8 here].<br />
<br />
===Example input===<br />
DOSBox running in Windows:<br />
<br />
<pre><br />
Z:\><br />
Z:\>mount c c:\game_directory<br />
Z:\>imgmount d d:\game_disc.iso -t iso<br />
Z:\>cd d:\<br />
D:\>game_install.exe<br />
D:\>cd c:\<br />
C:\><br />
C:\>game.exe</pre><br />
<br />
Substitute the pathways with the given conventions of the host operating system.<br />
<br />
{{key|Alt|Enter}} to maximise the window; {{key|Ctrl|F4}} to switch between mounted disc images. Use double quotes, " ", when mounting folders with spaces ("c:\installation folder"); For mounting multiple disc images, -t iso is required only once at the end of the last disc image, this defines how DOSBox should emulate the volume and iso defines the type of volume.<br />
<br />
===[http://dos32a.narechk.net/index_en.html DOS/32A]===<br />
DOS/32A is a more advanced extender and open source replacement to DOS4GW. It can improve both performance and stability of many games. More info [https://www.dosbox.com/wiki/TOOLS:DOS32A here].<br />
<br />
{{ii}} If DOS/32A gives you issues with a particular game, you could alternatively try the [http://www.devoresoftware.com/freesource/cwsrc.htm Causeway extender] or [http://www.sid6581.net/pmodew/ PMODE/W]. Worst-case scenario, stick with the stock extender.<ref>https://www.gog.com/forum/m_a_x_series/changing_dos_extenders_might_be_the_solution_for_all_of_us</ref><br />
<br />
===[http://www.vogonsdrivers.com/getfile.php?fileid=346 UniVBE]===<br />
Although DOSBox will not gain the performance improvements this program promises, it will add additional video modes. Although 5.0+ were initially released as commercial software, SciTech later released them as freeware. Versions 1-4 were always freeware though. The 5.x series is generally the best to use with DOSBox. Additional (possibly useful) DOS display utilities can be found [http://www.vogons.org/viewtopic.php?t=15190 here].<br />
<br />
===Gravis MIDI/Patches===<br />
The Gravis Ultra Sound or GUS was a sound card produced by Advanced Gravis Computer Technology, who were best known for their Gravis PC Gamepad. One of the features of the GUS is its ability to use real world sound samples instead of digitally generated instruments. This allows for a richer quality of sound when playing midi sound. Unfortunately, the official patches (drivers/samples) cannot be distributed with DOSBox due to conflicting Licenses. You can however find a guide for installing them [https://www.vogons.org/viewtopic.php?f=31&t=16974 here].<br><br />
A similar thing is true for some Sound Blaster games; see [http://nerdlypleasures.blogspot.com/2013/12/sound-blaster-drivers-when-dos-games.html here].<br />
<br />
==DOSBox configuration==<br />
DOSBox stores configuration information in *.conf files. Individual conf files can be create for each piece of software used and additional parameters can be appended.<br />
<br />
To modify a configuration option within DOSBox, use the <code>config</code> command. For example, <code>config cpu cycles fixed 30000</code><br />
<br />
==Video settings==<br />
{{Video settings<br />
|wsgf link = <br />
|widescreen wsgf award = <br />
|multimonitor wsgf award = <br />
|ultrawidescreen wsgf award = <br />
|4k ultra hd wsgf award = <br />
|widescreen resolution = true<br />
|widescreen resolution notes= Requires game being emulated to support it.<br />
|multimonitor = false<br />
|multimonitor notes = <br />
|ultrawidescreen = false<br />
|ultrawidescreen notes = <br />
|4k ultra hd = false<br />
|4k ultra hd notes = <br />
|fov = false<br />
|fov notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
|windowed = true<br />
|windowed notes = Toggle with {{key|Alt|Enter}}.<br />
|borderless windowed = false<br />
|borderless windowed notes = <br />
|anisotropic = false<br />
|anisotropic notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
|antialiasing = false<br />
|antialiasing notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
|vsync = true<br />
|vsync notes = Set <code>fulldouble = true</code> in the configuration file. See [[#Unofficial builds|Unofficial builds]] for more advanced implementations.<br />
|60 fps = true<br />
|60 fps notes = <br />
|120 fps = false<br />
|120 fps notes = <br />
|hdr = false<br />
|hdr notes = <br />
|color blind = false<br />
|color blind notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
}}<br />
<br />
==Input settings==<br />
{{Input settings<br />
|key remap = true<br />
|key remap notes = See [[#Mapper|Mapper]].<br />
|acceleration option = false<br />
|acceleration option notes = <br />
|mouse sensitivity = true<br />
|mouse sensitivity notes = Adjustable in DOSBox configuration settings.<br />
|mouse menu = false<br />
|mouse menu notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
|invert mouse y-axis = n/a<br />
|invert mouse y-axis notes = Depends on game being emulated (not implemented by DOSBox itself).<br />
|controller support = true<br />
|controller support notes = See [[#Controller support|Controller support]].<br />
|full controller = unknown<br />
|full controller notes = <br />
|controller remap = unknown<br />
|controller remap notes = <br />
|controller sensitivity = unknown<br />
|controller sensitivity notes= <br />
|invert controller y-axis = unknown<br />
|invert controller y-axis notes= <br />
|touchscreen = false<br />
|touchscreen notes = <br />
|button prompts = unknown<br />
|button prompts notes = <br />
|controller hotplug = unknown<br />
|controller hotplug notes = <br />
|haptic feedback = unknown<br />
|haptic feedback notes = <br />
|simultaneous input = true<br />
|simultaneous input notes = <br />
|steam input api = unknown<br />
|steam input api notes = <br />
|light bar support = unknown<br />
|light bar support notes = <br />
}}<br />
<br />
===[[Glossary:Remapping|Remapping]]===<br />
The [http://www.dosbox.com/wiki/Mapper DOSBox Mapper] ({{key|Ctrl|F1}}/{{key|Command|F1}}) can be used to reassign keyboard, mouse and joystick commands.<br />
<br />
===[[Controller|Controller support]]===<br />
DOSBox has several virtual joystick modes which affect what inputs are seen in-game and also what inputs can be remapped using the [[#Mapper|Mapper]]. See [http://www.dosbox.com/DOSBoxManual.html#Joystick the DOSBox manual] for details.<br />
<br />
==Network==<br />
{{Network/Multiplayer<br />
|local play = true<br />
|local play players = <br />
|local play modes = <br />
|local play notes = <br />
|lan play = true<br />
|lan play players = <br />
|lan play modes = <br />
|lan play notes = <br />
|online play = true<br />
|online play players = <br />
|online play modes = <br />
|online play notes = <br />
|asynchronous = <br />
|asynchronous notes = <br />
}}{{Network/Connections<br />
|matchmaking = <br />
|matchmaking notes = <br />
|p2p = <br />
|p2p notes = <br />
|dedicated = <br />
|dedicated notes = <br />
|self-hosting = <br />
|self-hosting notes = <br />
|direct ip = <br />
|direct ip notes = <br />
}}<br />
<br />
===Net play===<br />
DOSBox supports both IPX and Modem emulation. A guide to setting it up can be found [https://www.dosbox.com/wiki/Connectivity here].<br />
There's also a guide to adding additional protocols for networking [https://www.dosbox.com/wiki/Network_Setup here]. Several method are listed.<br />
<br />
==VR support==<br />
{{VR support<br />
|gg3d name = <br />
|native 3d gg3d award = <br />
|nvidia 3d vision gg3d award = <br />
|tridef 3d gg3d award = <br />
|iz3d gg3d award = <br />
|native 3d = <br />
|native 3d notes = <br />
|nvidia 3d vision = <br />
|nvidia 3d vision notes = <br />
|tridef 3d = <br />
|tridef 3d notes = <br />
|iz3d = <br />
|iz3d notes = <br />
|vorpx = hackable<br />
|vorpx modes = 2D<br />
|vorpx notes = Not officially supported, requires [http://ykhwong.x-y.net/ this DOSBOX version]. See also [https://www.vorpx.com/forums/topic/dosbox/#post-126136 here]. <br />
|htc vive = <br />
|htc vive notes = <br />
|oculus rift = <br />
|oculus rift notes = <br />
|osvr = <br />
|osvr notes = <br />
|windows mixed reality = <br />
|windows mixed reality notes = <br />
|keyboard-mouse = <br />
|keyboard-mouse notes = <br />
|3rd space gaming vest = <br />
|3rd space gaming vest notes = <br />
|novint falcon = <br />
|novint falcon notes = <br />
|trackir = <br />
|trackir notes = <br />
|tobii eye tracking = <br />
|tobii eye tracking notes = <br />
|play area seated = <br />
|play area seated notes = <br />
|play area standing = <br />
|play area standing notes = <br />
|play area room-scale = <br />
|play area room-scale notes = <br />
}}<br />
<br />
==Issues fixed==<br />
===Game appears stretched horizontally===<br />
{{Fixbox|description=Fix incorrect aspect ratio|ref={{cn|date=February 2017}}|fix=<br />
{{ii}} Many DOS games are designed to run at 320x200 or 640x400, but with a 4:3 aspect ratio. To set this, do the following:<br />
* Go to the <code>[render]</code> section of the DOSBox configuration file and change <code>aspect=false</code> to <code>aspect=true</code>.<br />
* If you are using Boxer, you can also use the '''View - Use 4:3 Aspect Ratio''' item in the menu.<br />
}}<br />
<br />
===Green or black screen in fullscreen mode===<br />
{{ii}} With some video cards, DOSBox's default output mode will render with a green or black screen in fullscreen mode.<br />
<br />
{{Fixbox|description=Edit DOSBox configuration file (DOSBox.com versions)|fix=<br />
# Edit the DOSBox configuration file (<code>dosbox-0.74.conf</code>, <code>dosbox.conf</code>, or similar).<br />
# Change <code>output=surface</code> to <code>output=overlay</code><br />
# Save your changes and run the game again.<br />
{{ii}} If the problem persists, edit it again and try different modes until you get one that works.<br />
}}<br />
{{Fixbox|description=Run Graphic Mode Setup (GOG.com versions)|fix=<br />
# Run the game's Graphic Mode Setup in the Start Screen/Start Menu.<br />
# Change Graphic mode to "Overlay" or "DDraw".<br />
# Choose Save Settings and run the game again.<br />
{{ii}} If the problem persists, run it again and try different modes until you get one that works.<br />
{{--}} GOG's setup utility can be rather buggy: it may crash, freeze or simply not save changed settings when exiting.<br />
}}<br />
<br />
===Character/camera/cursor constantly moves in one direction===<br />
{{Fixbox|description=Change joystick timing setting|fix=<br />
# Edit the game's DOSBox configuration file.<br />
# Change <code>timed=true</code> to <code>timed=false</code> (if it is already set to this, try <code>timed=true</code> instead).<br />
# Save your changes and run the game again.<br />
}}<br />
<br />
{{Fixbox|description=Disable joystick support|fix=<br />
{{ii}} This fix is only suitable if you don't want to use a controller with the game.<br />
# Edit the game's DOSBox configuration file.<br />
# Change the <code>joysticktype</code> value to <code>none</code><br />
# Save your changes and run the game again.<br />
}}<br />
<br />
===Can't remap keys/joystick===<br />
Some games have fixed inputs. Use the [http://www.dosbox.com/wiki/Mapper DOSBox Mapper] to remap the controls.<br />
<br />
===Unable to use D-pad/Analog stick not working (XInput controllers)===<br />
{{Fixbox|description=Change DOSBox configuration file|ref=<ref>[https://www.gog.com/forum/general/about_dosbox_and_xbox_360xinput_controllers About DOSBox and Xbox 360/XInput Controllers, page 1 - Forum - GOG.com]</ref>|fix=<br />
# Edit the game's DOSBox configuration file.<br />
# Change the <code>joysticktype</code> value to <code>fcs</code> and <code>timed</code> value to <code>false</code>.<br />
# Save your changes and run the game again.<br />
}}<br />
<br />
===Can't open Steam overlay in-game===<br />
{{ii}} The [[Steam]] overlay only works in some output modes; OpenGL seems to work the best.<ref name="Steam overlay">[https://www.gog.com/forum/general_archive/adding_dosbox_to_steam_client_and_enabling_steam_overlay Adding DOSBox to Steam Client and enabling Steam Overlay, page 1 - Forum - GOG.com]</ref><br />
<br />
{{Fixbox|description=Change output in configuration file|ref=<ref name="Steam overlay"/>|fix=<br />
# Go to the game's installation folder and edit the DOSBox configuration file (<code>.conf</code>).<br />
# Change <code>output=</code> to read <code>output=OpenGL</code><br />
# Change <code>fullresolution=</code> to read <code>fullresolution=desktop</code> for the best overlay resolution.<br />
# Save your changes. The Steam overlay should now work in-game.<br />
}}<br />
<br />
===Printer support===<br />
{{ii}} Official DOSBox builds don't support printing in games that use it.<br />
<br />
{{Fixbox|description=Enable printer support|ref=<ref>{{Refcheck|user=Garrett|date=September 27, 2017|comment=}}</ref>|fix=<br />
# Download [http://ykhwong.x-y.net/subpages/old.php DOSBox SVN Daum 20140127].<br />
# Install it over top of the game's existing DOSBox version.<br />
# Extract the [https://community.pcgamingwiki.com/files/file/952-dosbox-svn-daum-fonts/ FONTS folder] into the DOSBox SVN Daum installation folder (required for some games).<br />
# Edit the game's DOSBox configuration file and add the following lines at the bottom:<br />
<pre>[printer]<br />
printer=true<br />
dpi=360<br />
width=85<br />
height=110<br />
printoutput=printer<br />
multipage=false<br />
docpath=.<br />
timeout=0<br />
<br />
[parallel]<br />
parallel1=printer<br />
</pre><br />
<ol start="4"><br />
<li>Start the game normally.</li><br />
<li>When you are ready to print, first switch into windowed mode ({{key|Alt|Enter}}) to ensure you can see the printer dialog box.</li></ol><br />
<br />
'''Notes'''<br />
{{ii}} If DOSBox does not start printing increase the value for <code>timeout=0</code> (e.g. <code>timeout=100</code>); if a printed page is incomplete increase this to a higher value.<br />
{{ii}} If a menu bar is visible in fullscreen mode after making this change, ensure <code>output=</code> is not set to <code>OpenGL</code>.<br />
{{ii}} The printer selection window is only shown once per session; relaunch the game to change printers.<br />
{{--}} Accented characters are not printed correctly; for [[Wikipedia:Text mode|text mode]] games use [http://www.columbia.edu/~em36/wpdos/dosbox-vdos-lfn.html DOSBox SVN-lfn] to copy screen text to the clipboard.<br />
}}<br />
<br />
{{References}}<br />
<br />
[[Category:Emulation]]</div>174.93.75.115