https://www.dosbox.com/wiki/api.php?action=feedcontributions&user=Beresford&feedformat=atomDOSBoxWiki - User contributions [en]2024-03-29T14:04:37ZUser contributionsMediaWiki 1.34.1https://www.dosbox.com/wiki/index.php?title=SVN_Builds&diff=134650SVN Builds2015-11-16T03:09:26Z<p>Beresford: /* Plain/vanilla/clean SVN builds */ added in DOSBox-U</p>
<hr />
<div>This article is a discussion of the general purpose of DOSBox SVN builds, and a list of which known public ones exist and where to get them. The first part is a FAQ covering various questions regarding DOSBox SVN builds; it is followed by a listing, description of and links to known SVN builds, as well as a selection of useful related links. <br />
<br />
==SVN Builds FAQ==<br />
<br />
===What are SVN builds?===<br />
SVN builds are versions of DOSBox that people have built from the latest version of the DOSBox source code, which is stored on [http://www.sourceforge.net/ sourceforge.net] in something called an SVN repository. SVN builds contain changes that have been made by the DOSBox developers since the latest official release. Some enhanced SVN builds also contain unofficial features and fixes that have been created by enthusiasts in the DOSBox development community.<br />
<br />
===Why should I use an SVN build?===<br />
Every so often a new official version of DOSBox is released. Active development continues between releases, however, with new features and fixes continuously added to DOSBox's SVN repository that eventually result in the next release. At the time of this writing, the last official release is several years old, and is therefore missing a significant amount of work performed by the developers. If you're having trouble running a game with the current DOSBox release, it's worth trying an SVN build to see if the problem has been addressed since then. You may also want access to the new features or optimizations if you are having compatibility or performance issues.<br />
<br />
===Which one should I use?===<br />
That's up to you. Consult the list below to see which features the different builds contain and decide which one you want to try first. If you are interested in trying an SVN build in hopes that it will fix a problem you're having in the latest release version, you should probably start with a "plain" (no-enhancements) SVN build. Also, see replies to this post from the maintainers for additional info on their builds.<br />
<br />
===How do I use it?===<br />
Some SVN builds come packaged as a fully-functional DOSBox distribution, so you can simply unpack the archive into an empty folder and run it. Other builds contain only a custom dosbox executable binary (e.g. dosbox.exe) and possibly some supporting libraries, and require that you first install the latest official release of DOSBox and then unpack the SVN build over the top of it - replacing the release versions of the files with the SVN versions. Some developers also recommend regenerating your dosbox.conf configuration file so that you will see any new config options that have been added. Consult [http://www.vogons.org/viewtopic.php?p=68701#68701 this forum thread] for info on how to regenerate a config file.<br />
<br />
===What do I do if I find bugs in an SVN build?===<br />
First, search the DOSBox community forums to see if it's already been reported. If it hasn't, post as much information as possible (see the [http://www.vogons.org/viewtopic.php?t=2949 help request guidelines]). ''Update:'' Note that bugs in plain SVN builds are probably the only ones of interest to the DOSBox developers. Problem reports for the other builds should be addressed to their respective maintainers, as problems could be caused by experimental patches that aren't part of the official SVN source code.<br />
<br />
===Where can I go to talk about SVN builds? (forum thread)===<br />
Please feel free to discuss SVN build-related topics in the [http://www.vogons.org/viewtopic.php?t=9306 forum thread] where this article originally started.<br />
<br />
==List of SVN Builds==<br />
<br />
===Plain/vanilla/clean SVN builds===<br />
The following SVN builds are based directly off of the official DOSBox SVN source code. Use these builds to test the latest official SVN changes:<br />
<br />
* '''EmuCR''' for Windows<br />
** URL: http://www.emucr.com/search/label/DOSBox<br />
** Notes: Updated daily, although there are reports that it may lag behind if multiple changes are checked in by the DOSBox developers on the same day followed by no changes for some time after.<br />
** Compiled '''without''' screenshot, video recording and IPX support.<br />
<br />
* '''Dominus''' for OS X 10.4 - 10.7 (ppc/intel)<br />
** URL: http://dl.dropbox.com/u/7737184/Dosbox/Dosbox-Snapshot.dmg<br />
** Notes: Automatically updated on changes to SVN.<br />
<br />
* '''DOSBox-U''' for Windows<br />
** URL: https://github.com/BeresfordHare/DOSBox-U/releases<br />
<br />
===Enhanced SVN builds===<br />
The following SVN builds contain additional fixes and/or features that are not officially part of DOSBox. Many people prefer them due to the included extra features that are not included in in the SVN. Note that if you have problems with these builds, it may be due to the unofficial changes that have been made by their maintainers and not the official DOSBox code itself that is to blame:<br />
<br />
* '''DOSBox with Long File Name (LFN) and mouse copy/paste support''' by Wengier<br />
** Last updated: 2014-12-25<br />
** SVN base version: r3876<br />
** URL: http://www.vogons.org/viewtopic.php?t=40610 (discussion + source + Windows binary)<br />
** URL: http://www.vogons.org/viewtopic.php?t=41179 (discussion + source + Windows binary)<br />
** URL: http://bit.ly/12jANWF (latest Windows binary + required DLLs, zipped)<br />
** Description: This is a build of DOSBox based on its SVN version that adds Long File Name (LFN) and mouse copy/past support. With this both the DOSBox shell commands and many native LFN-aware DOS programs should now be able to use LFN in DOSBox, and users can also use the right mouse button to select, copy and paste text from and to DOSBox (when the mouse is not locked). Windows binaries are provided, but sources should work on other platforms too (pdcurses is required for the cross-platform clipboard copy/paste feature).<br />
<br />
* '''DOSBox SVN Daum''' by ykhwong for Windows, OSX, and Linux<br />
** Last updated: 2015-01-25<br />
** SVN base version: r3894<br />
** URL: http://ykhwong.x-y.net/ (Windows binary, Linux x86 source)<br />
** URL: http://cafe.daum.net/dosbox<br />
** Description: The Windows build incorporates Direct3D with pixelshaders, OpenglHQ, Innovation, Glide, zip/7z mount, Beep, NE2000 Ethernet, Graphis user interface (menu), Save/Load states, Vertical sync, CPU flags optimization, Various DOS commands (PROMPT, VOL, LABEL, MOUSE, etc) and CONFIG.SYS commands (DEVICE, BUFFERS, FILES, etc), Continuous turbo key, Core-switch key, Show details (from menu bar), Nice DOSBox icon, Font patch (cp437), MAKEIMG command, INTRO, Ctrl-break patch, DBCS support patch, Automatic mount, Printer output, MT-32 emulation (MUNT), MP3CUE, Overscan border, Stereo-swap, SDL_Resize, MemSize128, Internal 3dfx voodoo chip emulation, etc. Recent versions include DOSBox-X branch changes as well.<br />
<br />
* '''dosbox-patched''' for Ubuntu Linux (Oneiric and newer)<br />
** Last updated: 2014-01-12<br />
** SVN base version: ?<br />
** URL: https://code.launchpad.net/~i30817/+archive/dosbox-patched<br />
** Description: "Daily build of dosbox trunk with mt32 patch (roms go into ~/.dosbox)". Automatically-built PPA packages built from DOSBox SVN trunk with Munt MT-32 emulation patch.<br />
<br />
* '''DOSBox-X''' by TheGreatCodeholio<br />
** Last updated: It is constantly updated<br />
** URL: http://www.vogons.org/viewtopic.php?t=31881 (discussion + links)<br />
** URL: https://github.com/joncampbell123/dosbox-x/releases<br />
** Description: "This is a branch of DOSBox 0.74 that I have been working on and off for the past 8 months. I've been modifying a lot in the source to make the emulation more accurate, to fix other parts of the emulation, and to widen the kind of hardware DOSBox emulates. I call it "DOSBox-x" for lack of a better name."<br />
<br />
===Obsolete SVN/CVS builds===<br />
These builds appear to be no longer maintained, and are listed here for historical reference.<br />
<br />
* '''"Mega Build" series (by H-A-L-9000)'''<br />
** Last updated: 2010-11-18<br />
** SVN base version: r3661<br />
** URL: http://home.arcor.de/h-a-l-9000/ (Windows binary, Linux source, Intel Mac OS X port by thedoctor45)<br />
** URL: http://www.vogons.org/viewtopic.php?t=26170 to discuss the Mac port<br />
** Description: Builds of DOSBox focused on serial/networking support. Contains the NE2000 patch, parallel port passthrough and file forwarding, virtual printer, SVGA enhacements, OPL passthrough, and others. The Windows installer contains the debug-enabled build as option.<br />
<br />
* '''"UBER BUILD" (by Virusek)'''<br />
** Last Updated: 2010-07-23<br />
** SVN base version: r3623<br />
** URL: http://www.vogons.org/viewtopic.php?p=193022#193022 (Windows binary, source)<br />
** Description: All patches from gulikoza's build (coreswitch, direct3d, glide, mt32, openglhq, physfs, NE2000, printer and oplpassthrough). Updated Glide patch by gulikoza to 24.11.2009. SDL_sound support. Some other small fixes (mostly VS2010 compatibility fixes).<br />
<br />
* '''Zirias'''<br />
** Last Updated: 2010-05-12<br />
** URL: http://www.vogons.org/viewtopic.php?p=186679#186679 (Debian i386 + amd64 binary & source packages)<br />
** Description: Debian Linux APT packaged version of DOSBox with Glide support.<br />
<br />
* '''Tharos (by XTale)'''<br />
** Last updated: 2010-03-28<br />
** <s>URL: http://builds.tharos-online.de/index.php?dir=&sort=date&order=desc</s><br />
** Notes: '''Daily builds seem to have stopped as of 3/28/10.'''<br />
<br />
* '''gulikoza'''<br />
** Last Updated: 2009-07-09<br />
** URL: http://www.si-gamer.net/gulikoza/ (Windows binary, source)<br />
** Description: Build of DOSBox focused on GLIDE support.<br />
<br />
* '''DOSBox for Mac OSX (by rhoenie/Marcus Herbert)'''<br />
** Last updated: 2008-08-09<br />
** URL: http://www.spam-filter.de/bastelstunde#dosbox<br />
** Description: DosBox 0.72 for G3 & DosBox CVS for OSX (G4/G5/i386)<br />
<br />
* '''DOSBox CVS for Linux (by Moe)'''<br />
** Last updated: 2006-12-15<br />
** <s>URL: http://garni.ch/dosbox/</s><br />
** Description: Recently Moe has decided to provide a DOSBox Linux (x86, 32-bit, Athlon64-optimized) binary including some useful patches. It is built against latest CVS and includes at least these patches: addkey, adlib optimize, Innovation SSI-2001, Self-Modifying-Code optimizations, SVGA chipsets, CD-Image cycling, Glide emulation, Printer emulation.<br />
** Notes: Moe is also the creator of OPENGL-HQ. OPENGL-HQ is another scaler that is implemented in SDL.dll. Unfortunately it may be some time (or never), until OPENGL-HQ is implemented in the official SDL so until then you'll have to download it from here (or compile it yourself). Neat thing about this is that you can use this SDL.DLL with any SDL program (e.g. DOSBox, SCUMMVM...).<br />
<br />
* '''DOSBox with MT-32 emulation (by Canadacow)'''<br />
** Last updated: 2004-10-15<br />
** <s>URL: http://www.artworxinn.com/alex/downloads.htm</s><br />
** Description: ''This build is no longer useful''; it was made before DOSBox 0.63 came out and contains MT-32 emulation code that is much older than the current Munt releases. Note that more current MT-32 emulation is also included as an unofficial feature of some of the newer SVN builds.<br />
<br />
==Useful Links==<br />
<br />
===SVN changelog===<br />
The following links list the latest changes to the official DOSBox source code on its sourceforge.net SVN repository:<br />
* http://source.dosbox.com/dosboxsvn.txt (auto-generated changelog provided by Qbix)<br />
* http://sourceforge.net/p/dosbox/code-0/3852/log/?path=/dosbox (sourceforge.net SVN log) - '''fixed on 2014-01-01'''<br />
<br />
===SVN build news===<br />
The following link(s) provide news related to DOSBox SVN builds:<br />
* http://www.emucr.com/search/label/DOSBox (EmuCR posts with DOSBox tag, which includes news regarding DOSBox SVN builds, frontends and other DOSBox ports)<br />
<br />
===Debugger-enabled builds===<br />
Qbix has a thread on the DOSBox forum containing links to some special DOSBox builds that have a built-in debugger:<br />
* http://www.vogons.org/viewtopic.php?t=7323<br />
<br />
===Making your own SVN build===<br />
The following DOSBoxWiki article discusses the process of making your own SVN build from the official DOSBox SVN source code:<br />
* [[BuildingDOSBox]]<br />
<br />
===Snapshot of latest DOSBox SVN source code===<br />
Snapshots of the latest SVN versions of the DOSBox source code are available at the following URL(s) :<br />
* http://source.dosbox.com/dosboxsvn.tgz (auto-generated tarball provided by Qbix)<br />
* http://dosbox.svn.sourceforge.net/viewvc/dosbox/dosbox/trunk/?view=tar (auto-generated tarball created by sourceforge.net)<br />
* http://sourceforge.net/scm/?type=svn&group_id=52551 (sourceforge.net instructions for accessing official DOSBox SVN repository)<br />
* http://dosbox.svn.sourceforge.net/viewvc/dosbox/dosbox/trunk/ (sourceforge.net SVN browser for official DOSBox SVN repository)<br />
<br />
==Unofficial ports==<br />
These builds are for other Operating Systems and hardware platforms and are not in any way supported by the DOSBox team.<br />
<br />
===Android===<br />
* '''AnDOSBox''' (ver. 0.74, v1.2.8, 2012-10-18)<br />
** URL: http://sites.google.com/site/andosbox/<br />
<br />
* '''DosBox Turbo''' (ver. 0.74 SVN, v2.1.20, 2015-02-25)<br />
** URL: http://sites.google.com/site/dosboxturbo/<br />
<br />
* '''Magic Dosbox''' (ver. 0.74, v1.0.29, 2015-06-30)<br />
** URL: http://magicbox.imejl.sk<br />
<br />
* '''aDOSBox''' (ver. 0.73, v0.2.5, 2011-05-16)<br />
** URL: http://play.google.com/store/apps/details?id=org.hystudio.android.dosbox<br />
<br />
===iOS===<br />
* '''DOSPad''' (ver. 0.74, v1.96, 2011-01)<br />
** URL: http://www.litchie.com/?page_id=123<br />
<br />
===PSP===<br />
* '''DOSBox PSP''' (ver. 0.71, 2008-08-03)<br />
** <s>URL: http://www.qj.net/tag/crazyc-gaming-news.html</s><br />
** URL: http://www.pspdosbox.co.uk<br />
** <s>URL: http://forums.ps2dev.org/viewtopic.php?t=9564</s><br />
<br />
===Symbian===<br />
* '''Symbian DOSBox''' (ver. 0.73, 2009-12-07)<br />
** URL: http://sourceforge.net/projects/s60dosbox/<br />
<br />
===Pocket PC / Windows Mobile===<br />
* '''DosBox PPC''' (ver. 0.73, 2009-07-06)<br />
** URL: http://n0p.8bit.fm<br />
<br />
===Wii===<br />
* '''DOSBox for Wii''' (ver. 0.74, v1.7, 2012-06-30)<br />
** URL: http://code.google.com/p/dosbox-wii/<br />
<br />
===Dreamcast===<br />
* '''DOSBox for Dreamcast''' (ver. 0.60, 2005?)<br />
** URL: http://gpf.dcemu.co.uk/dcdoxbox.shtml<br />
<br />
===GP2x===<br />
* '''DOSBox for GP2x''' (ver. 0.72, 2009-01-03)<br />
** URL: http://dl.openhandhelds.org/cgi-bin/gp2x.cgi?0,0,0,0,72,2534<br />
** <s>URL: http://wiki.gp2x.org/wiki/DosBox</s><br />
<br />
* '''DOSBox for GP2x Wiz''' (ver. 0.72, 2009-08-27)<br />
** URL: http://dl.openhandhelds.org/cgi-bin/wiz.cgi?0,0,0,0,72,198<br />
<br />
* '''DOSBox for GP2x Caanoo''' (ver. 0.74, 2012-01-14)<br />
** URL: http://dl.openhandhelds.org/cgi-bin/caanoo.cgi?0,0,0,0,72,826<br />
<br />
===Dingoo A320===<br />
* '''DOSBox for Dingoo A320''' (ver. 0.74, 2013-03-11)<br />
** URL: http://www.slaanesh.net/2013/03/dosbox-074-open-dingux.html<br />
<br />
===OS/2===<br />
* '''DOSBox/2''' (ver. 0.74 SVN, 2015-06-05)<br />
** URL: http://www.joschs-robotics.de/dosbox/<br />
** URL: http://wiki.netlabs.org/index.php/DOSBox_Port<br />
<br />
===AmigaOS 4.0===<br />
* '''DOSBox for AmigaOS 4.0''' (ver. 0.72, 2009-06-14)<br />
** URL: http://www.os4depot.net/share/emulation/computer/dosbox.lha<br />
** URL: http://www.os4depot.net/index.php?function=browse&cat=emulation/computer<br />
<br />
===Java===<br />
* '''jDosbox''' (ver. v0.74, v0.74.28, 2013-02-27)<br />
** URL: http://jdosbox.sourceforge.net<br />
<br />
===JavaScript===<br />
* '''JsDOSBox''' (ver. 0.74, v3.2, 2015-02-14)<br />
** URL: http://sourceforge.net/projects/jsdosbox/<br />
<br />
===IRIX===<br />
* '''DOSBox for IRIX''' (ver. 0.71, 2007?)<br />
** URL: http://www.spam-filter.de/dosbox/dosbox_on_irix<br />
** <s>URL: http://www.enosnusnu.de/index.php?/archives/98-DOSBox-on-IRIX.html</s><br />
** Notes: Original enosnusnu.de link seems to now redirect to spam-filter.de. I added a link to a DOSBox on IRIX page on the latter site, but it appears that it may only offer a source code tarball and no binary.<br />
<br />
===PXA270===<br />
* '''DOSBox "Optimized" for PXA270 (by wellswang & kkazakov)''' (ver. 0.70, 2007-03-19)<br />
** <s>URL: http://www.oesf.org/forum/index.php?showtopic=18415&st=270&p=156742&#entry156742</s><br />
** URL: http://wells.osall.com/files/download.php?id=1727<br />
** URL: http://www.oesf.org/forums/index.php?s=1dec7dd003587d385fbec45efb1ffbaa&showtopic=18415&st=270&p=156742&#entry156742</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Building_DOSBox_with_MinGW&diff=134647Building DOSBox with MinGW2015-11-03T21:35:48Z<p>Beresford: /* Adding support for compressed audio on diskimages (Optional) */ updated libvorbis version</p>
<hr />
<div>== Building your own version of DOSBox ==<br />
<br />
MinGW is the development environment that this page will show you how to use, an alternative is to use [[Building_DOSBox_with_Visual_C_2008_Express|Microsoft Visual Studio]]<br />
<br />
This page will guide you through setting up MinGW to compile a current (SVN/CVS) version of DOSBox. Because of updates to compilers and libraries, this guide will not work with the 0.74 (the last official release, which is currently over 4 years old) source files.<br />
<br />
== Installing MinGW ==<br />
* Download mingw-get-setup.exe from http://sourceforge.net/projects/mingw/<br />
* Run the installer, choosing the defaults<br />
* Once the '''MinGW Installation Manager''' application starts, select<br />
** mingw-developer-toolkit (msys-base should be automatically added)<br />
** mingw32-base<br />
** mingw32-gcc-g++<br />
* On the installation menu, apply changes, and confirm that you want to apply the changes<br />
<br />
The installation manager is going to download a bunch of files, and at the end, start installing them. Once this is done, you can close the dialog box as well as the installation manager.<br />
<br />
Well done, MinGW is now installed! Let's start it up.<br />
<br />
* Browse to '''C:\MinGW\msys\1.0'''<br />
* Run '''MSYS.BAT'''<br />
<br />
This will start up a DOS prompt like screen, lets mount the base path<br />
mount 'c:\MinGW' /mingw<br />
<br />
You have now completed this section, lets move on to adding the SDL libraries to MinGW.<br />
<br />
== Adding the SDL libraries to MinGW ==<br />
* Download the pre compiled SDL development libraries from here http://www.libsdl.org/release/SDL-devel-1.2.15-mingw32.tar.gz<br />
* Copy the downloaded file to your MSYS home folder, it's going to be something like '''C:\MinGW\msys\1.0\home\Administrator'''<br />
* Switch back to the MSYS command prompt we started earlier<br />
* Lets extract the downloaded files<br />
tar xvf SDL-devel-1.2.15-mingw32.tar.gz<br />
* And now add the files to MinGW<br />
cd SDL-1.2.15<br />
make install-sdl prefix=/mingw<br />
cd ..<br />
<br />
Cool, the SDL libraries have been added to MinGW, onto the next section.<br />
<br />
== Adding Direct Draw support to DOSBox (Optional) ==<br />
If you want to give DOSBox the option to use the DDRAW output option, then we need to add a couple of extra libraries to MinGW<br />
* Download the following file, http://www.libsdl.org/extras/win32/common/directx-devel.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the files (the -C parameter, tells tar where to extract the files to)<br />
tar xvf directx-devel.tar.gz -C /mingw<br />
<br />
== Adding networking support to DOSBox (Optional) ==<br />
These steps show you how to add the SDL_net libraries to MinGW, which enable networking and modem for DOSBox. If you aren't going to be using DOSBox for multi player games, then you can probably skip this step.<br />
* Download the SDL_net source files from https://www.libsdl.org/projects/SDL_net/release/SDL_net-1.2.8.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file<br />
tar xvf SDL_net-1.2.8.tar.gz<br />
* Lets configure the libraries<br />
cd SDL_net-1.2.8<br />
./configure --prefix=/mingw<br />
* And now compile them<br />
make<br />
* And then install them (copy the files)<br />
make install<br />
cd ..<br />
<br />
== Adding screenshot support (Optional) ==<br />
This one is a bit tricky because it relies on two libraries, zlib (libpng needs these libraries), and libpng. We are also going to be compiling the libraries statically to keep external DLL's to a minimum.<br />
* Download zlib from here http://sourceforge.net/projects/libpng/files/zlib/1.2.8/zlib-1.2.8.tar.xz/download<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file<br />
tar xvf zlib-1.2.8.tar.xz<br />
* Lets build the static library<br />
cd zlib-1.2.8<br />
make -f win32/Makefile.gcc<br />
* And now copy the files to /mingw<br />
cp libz.a /mingw/lib/<br />
cp zlib.h zconf.h /mingw/include/<br />
cd ..<br />
Cool, that wasn't too hard, onto libpng<br />
* Download libpng from here http://sourceforge.net/projects/libpng/files/libpng16/1.6.18/libpng-1.6.18.tar.gz/download<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file <br />
tar xvf libpng-1.6.18.tar.gz<br />
* Configure the library<br />
cd libpng-1.6.18<br />
./configure --disable-shared --prefix=/mingw<br />
* And now to compile and install the files<br />
make<br />
make install<br />
cd ..<br />
<br />
== Adding support for compressed audio on diskimages (Optional) ==<br />
This is for cue/bin cdrom images with compressed (ogg) audio tracks. We will be adding the libvorbis, libogg, and sdl_sound libraries. <br />
* Download libogg from here http://downloads.xiph.org/releases/ogg/libogg-1.3.2.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file <br />
tar xvf libogg-1.3.2.tar.gz<br />
* Configure the library, disabling shared library files<br />
cd libogg-1.3.2<br />
./configure --disable-shared --prefix=/mingw<br />
* Compile and install the library files<br />
make<br />
make install<br />
cd ..<br />
<br />
* Download libvorbis from here http://downloads.xiph.org/releases/vorbis/libvorbis-1.3.5.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file <br />
tar xvf libvorbis-1.3.5.tar.gz<br />
* Configure the library, disabling shared library files<br />
cd libvorbis-1.3.5<br />
./configure --disable-shared --prefix=/mingw<br />
* Compile and install the library files<br />
make<br />
make install<br />
cd ..<br />
<br />
* Download sdl_sound from here https://www.icculus.org/SDL_sound/downloads/SDL_sound-1.0.3.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file <br />
tar xvf SDL_sound-1.0.3<br />
* Unfortunately sdl_sound isn't going to compile on MinGW so we are going to have to edit some of the source files.<br />
* Using something like Notepad++ (or Wordpad in a pinch), open up '''SDL_sound-1.0.3\decoders\mpglib\mpg123_sdlsound.h'''<br />
* Replace line 8<br />
#include <math.h><br />
* With the following<br />
# define M_PI 3.14159265358979323846<br />
# define M_SQRT2 1.41421356237309504880<br />
# define REAL_IS_FLOAT<br />
# define NEW_DCT9<br />
<br />
# define random rand<br />
# define srandom srand<br />
<br />
* Using something like Notepad++ (or Wordpad in a pinch), open up '''SDL_sound-1.0.3\decoders\timidity\tables.h'''<br />
* Comment out line 23 with two //<br />
//#include <math.h><br />
* The hard part is done, lets configure and compile<br />
cd SDL_sound-1.0.3<br />
./configure --disable-shared --prefix=/mingw LIBS="-lvorbisfile -lvorbis -logg"<br />
make<br />
make install<br />
cd ..<br />
<br />
== Enabling the debugger (You probably don't want this) ==<br />
The debugger is mainly for developers of DOSBox, so they can find out why a game isn't working.<br />
* Download the PDCurses source files from http://sourceforge.net/projects/pdcurses/files/pdcurses/3.4/PDCurses-3.4.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file<br />
tar xvf PDCurses-3.4.tar.gz<br />
* Compile the library<br />
cd PDCurses-3.4/win32<br />
make -f gccwin32.mak DLL=N<br />
* And now copy the files to your /mingw folders<br />
cp pdcurses.a /mingw/lib/libpdcurses.a<br />
cd ..<br />
cp curses.h panel.h /mingw/include/<br />
cd ..<br />
<br />
== Compiling DOSBox ==<br />
* Download the latest official DOSBox SVN source files from here: http://source.dosbox.com/dosboxsvn.tgz<br />
(There are also enhanced SVN versions containing additional fixes and/or features that are not officially part of DOSBox, see [[SVN Builds]] for more details)<br />
* Copy the file to your MSYS home folder<br />
* Extract the file<br />
tar xvf dosboxsvn.tgz<br />
* Let's configure DOSBox, and tell it to use the static C library (-static-libgcc) and C++ library (-static-libstdc++) and stripping the final EXE of debug information (-s)<br />
cd dosbox<br />
./autogen.sh<br />
./configure --enable-core-inline LDFLAGS="-static-libgcc -static-libstdc++ -s"<br />
* For SDL_sound support, you have to extra some extra parameters so that the configure command knows where to find the audio library files (LIBS="-lvorbisfile.....)<br />
./configure --enable-core-inline LDFLAGS="-static-libgcc -static-libstdc++ -s" LIBS="-lvorbisfile -lvorbis -logg"<br />
* If you want to enable debugging (you probably don't)<br />
./configure --enable-core-inline LDFLAGS="-static-libgcc -static-libstdc++ -s" LIBS="-lvorbisfile -lvorbis -logg" --enable-debug<br />
* And now for compiling DOSBox<br />
make<br />
* The last step is to gather all the files together in a folder<br />
** Create a folder with a name of your choosing<br />
** Copy the dosbox.exe file located under the '''dosbox\src''' folder, e.g. '''C:\MinGW\msys\1.0\home\Administrator\dosbox\src''' to the folder you created<br />
** Copy the SDL.dll file located under '''SDL-1.2.15\bin''', e.g. '''C:\MinGW\msys\1.0\home\Administrator\SDL-1.2.15\bin''' to the folder you created<br />
** Optionally, copy the SDL_net.dll file located under '''SDL_net-1.2.8\.libs''', e.g. '''C:\MinGW\msys\1.0\home\Administrator\SDL_net-1.2.8\.libs''' to the folder you created<br />
<br />
Start up DOSBox, and see if it works.</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Building_DOSBox_with_MinGW&diff=134646Building DOSBox with MinGW2015-11-03T21:34:46Z<p>Beresford: /* Adding screenshot support (Optional) */ updated libpng version</p>
<hr />
<div>== Building your own version of DOSBox ==<br />
<br />
MinGW is the development environment that this page will show you how to use, an alternative is to use [[Building_DOSBox_with_Visual_C_2008_Express|Microsoft Visual Studio]]<br />
<br />
This page will guide you through setting up MinGW to compile a current (SVN/CVS) version of DOSBox. Because of updates to compilers and libraries, this guide will not work with the 0.74 (the last official release, which is currently over 4 years old) source files.<br />
<br />
== Installing MinGW ==<br />
* Download mingw-get-setup.exe from http://sourceforge.net/projects/mingw/<br />
* Run the installer, choosing the defaults<br />
* Once the '''MinGW Installation Manager''' application starts, select<br />
** mingw-developer-toolkit (msys-base should be automatically added)<br />
** mingw32-base<br />
** mingw32-gcc-g++<br />
* On the installation menu, apply changes, and confirm that you want to apply the changes<br />
<br />
The installation manager is going to download a bunch of files, and at the end, start installing them. Once this is done, you can close the dialog box as well as the installation manager.<br />
<br />
Well done, MinGW is now installed! Let's start it up.<br />
<br />
* Browse to '''C:\MinGW\msys\1.0'''<br />
* Run '''MSYS.BAT'''<br />
<br />
This will start up a DOS prompt like screen, lets mount the base path<br />
mount 'c:\MinGW' /mingw<br />
<br />
You have now completed this section, lets move on to adding the SDL libraries to MinGW.<br />
<br />
== Adding the SDL libraries to MinGW ==<br />
* Download the pre compiled SDL development libraries from here http://www.libsdl.org/release/SDL-devel-1.2.15-mingw32.tar.gz<br />
* Copy the downloaded file to your MSYS home folder, it's going to be something like '''C:\MinGW\msys\1.0\home\Administrator'''<br />
* Switch back to the MSYS command prompt we started earlier<br />
* Lets extract the downloaded files<br />
tar xvf SDL-devel-1.2.15-mingw32.tar.gz<br />
* And now add the files to MinGW<br />
cd SDL-1.2.15<br />
make install-sdl prefix=/mingw<br />
cd ..<br />
<br />
Cool, the SDL libraries have been added to MinGW, onto the next section.<br />
<br />
== Adding Direct Draw support to DOSBox (Optional) ==<br />
If you want to give DOSBox the option to use the DDRAW output option, then we need to add a couple of extra libraries to MinGW<br />
* Download the following file, http://www.libsdl.org/extras/win32/common/directx-devel.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the files (the -C parameter, tells tar where to extract the files to)<br />
tar xvf directx-devel.tar.gz -C /mingw<br />
<br />
== Adding networking support to DOSBox (Optional) ==<br />
These steps show you how to add the SDL_net libraries to MinGW, which enable networking and modem for DOSBox. If you aren't going to be using DOSBox for multi player games, then you can probably skip this step.<br />
* Download the SDL_net source files from https://www.libsdl.org/projects/SDL_net/release/SDL_net-1.2.8.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file<br />
tar xvf SDL_net-1.2.8.tar.gz<br />
* Lets configure the libraries<br />
cd SDL_net-1.2.8<br />
./configure --prefix=/mingw<br />
* And now compile them<br />
make<br />
* And then install them (copy the files)<br />
make install<br />
cd ..<br />
<br />
== Adding screenshot support (Optional) ==<br />
This one is a bit tricky because it relies on two libraries, zlib (libpng needs these libraries), and libpng. We are also going to be compiling the libraries statically to keep external DLL's to a minimum.<br />
* Download zlib from here http://sourceforge.net/projects/libpng/files/zlib/1.2.8/zlib-1.2.8.tar.xz/download<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file<br />
tar xvf zlib-1.2.8.tar.xz<br />
* Lets build the static library<br />
cd zlib-1.2.8<br />
make -f win32/Makefile.gcc<br />
* And now copy the files to /mingw<br />
cp libz.a /mingw/lib/<br />
cp zlib.h zconf.h /mingw/include/<br />
cd ..<br />
Cool, that wasn't too hard, onto libpng<br />
* Download libpng from here http://sourceforge.net/projects/libpng/files/libpng16/1.6.18/libpng-1.6.18.tar.gz/download<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file <br />
tar xvf libpng-1.6.18.tar.gz<br />
* Configure the library<br />
cd libpng-1.6.18<br />
./configure --disable-shared --prefix=/mingw<br />
* And now to compile and install the files<br />
make<br />
make install<br />
cd ..<br />
<br />
== Adding support for compressed audio on diskimages (Optional) ==<br />
This is for cue/bin cdrom images with compressed (ogg) audio tracks. We will be adding the libvorbis, libogg, and sdl_sound libraries. <br />
* Download libogg from here http://downloads.xiph.org/releases/ogg/libogg-1.3.2.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file <br />
tar xvf libogg-1.3.2.tar.gz<br />
* Configure the library, disabling shared library files<br />
cd libogg-1.3.2<br />
./configure --disable-shared --prefix=/mingw<br />
* Compile and install the library files<br />
make<br />
make install<br />
cd ..<br />
<br />
* Download libvorbis from here http://downloads.xiph.org/releases/vorbis/libvorbis-1.3.4.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file <br />
tar xvf libvorbis-1.3.4.tar.gz<br />
* Configure the library, disabling shared library files<br />
cd libvorbis-1.3.4<br />
./configure --disable-shared --prefix=/mingw<br />
* Compile and install the library files<br />
make<br />
make install<br />
cd ..<br />
<br />
* Download sdl_sound from here https://www.icculus.org/SDL_sound/downloads/SDL_sound-1.0.3.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file <br />
tar xvf SDL_sound-1.0.3<br />
* Unfortunately sdl_sound isn't going to compile on MinGW so we are going to have to edit some of the source files.<br />
* Using something like Notepad++ (or Wordpad in a pinch), open up '''SDL_sound-1.0.3\decoders\mpglib\mpg123_sdlsound.h'''<br />
* Replace line 8<br />
#include <math.h><br />
* With the following<br />
# define M_PI 3.14159265358979323846<br />
# define M_SQRT2 1.41421356237309504880<br />
# define REAL_IS_FLOAT<br />
# define NEW_DCT9<br />
<br />
# define random rand<br />
# define srandom srand<br />
<br />
* Using something like Notepad++ (or Wordpad in a pinch), open up '''SDL_sound-1.0.3\decoders\timidity\tables.h'''<br />
* Comment out line 23 with two //<br />
//#include <math.h><br />
* The hard part is done, lets configure and compile<br />
cd SDL_sound-1.0.3<br />
./configure --disable-shared --prefix=/mingw LIBS="-lvorbisfile -lvorbis -logg"<br />
make<br />
make install<br />
cd ..<br />
<br />
== Enabling the debugger (You probably don't want this) ==<br />
The debugger is mainly for developers of DOSBox, so they can find out why a game isn't working.<br />
* Download the PDCurses source files from http://sourceforge.net/projects/pdcurses/files/pdcurses/3.4/PDCurses-3.4.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file<br />
tar xvf PDCurses-3.4.tar.gz<br />
* Compile the library<br />
cd PDCurses-3.4/win32<br />
make -f gccwin32.mak DLL=N<br />
* And now copy the files to your /mingw folders<br />
cp pdcurses.a /mingw/lib/libpdcurses.a<br />
cd ..<br />
cp curses.h panel.h /mingw/include/<br />
cd ..<br />
<br />
== Compiling DOSBox ==<br />
* Download the latest official DOSBox SVN source files from here: http://source.dosbox.com/dosboxsvn.tgz<br />
(There are also enhanced SVN versions containing additional fixes and/or features that are not officially part of DOSBox, see [[SVN Builds]] for more details)<br />
* Copy the file to your MSYS home folder<br />
* Extract the file<br />
tar xvf dosboxsvn.tgz<br />
* Let's configure DOSBox, and tell it to use the static C library (-static-libgcc) and C++ library (-static-libstdc++) and stripping the final EXE of debug information (-s)<br />
cd dosbox<br />
./autogen.sh<br />
./configure --enable-core-inline LDFLAGS="-static-libgcc -static-libstdc++ -s"<br />
* For SDL_sound support, you have to extra some extra parameters so that the configure command knows where to find the audio library files (LIBS="-lvorbisfile.....)<br />
./configure --enable-core-inline LDFLAGS="-static-libgcc -static-libstdc++ -s" LIBS="-lvorbisfile -lvorbis -logg"<br />
* If you want to enable debugging (you probably don't)<br />
./configure --enable-core-inline LDFLAGS="-static-libgcc -static-libstdc++ -s" LIBS="-lvorbisfile -lvorbis -logg" --enable-debug<br />
* And now for compiling DOSBox<br />
make<br />
* The last step is to gather all the files together in a folder<br />
** Create a folder with a name of your choosing<br />
** Copy the dosbox.exe file located under the '''dosbox\src''' folder, e.g. '''C:\MinGW\msys\1.0\home\Administrator\dosbox\src''' to the folder you created<br />
** Copy the SDL.dll file located under '''SDL-1.2.15\bin''', e.g. '''C:\MinGW\msys\1.0\home\Administrator\SDL-1.2.15\bin''' to the folder you created<br />
** Optionally, copy the SDL_net.dll file located under '''SDL_net-1.2.8\.libs''', e.g. '''C:\MinGW\msys\1.0\home\Administrator\SDL_net-1.2.8\.libs''' to the folder you created<br />
<br />
Start up DOSBox, and see if it works.</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Commands&diff=134618Commands2015-07-05T22:53:58Z<p>Beresford: /* MOUNT */ changed mount to mount & imgmount</p>
<hr />
<div>== [[BOOT]] ==<br />
:Will start floppy images or hard disk images independent of the operating system emulation offered by DOSBox. This will allow you to play booter floppies or boot other operating systems inside DOSBox. <br />
<br />
== CD (Change Directory) ==<br />
:Allows you to move up and down a directory tree. '''CD''' is simple to use, just type <br />
<br />
CD [Directory-Name]<br />
<br />
:And if the Directory-Name correctly refers to an available directory then you will be moved from your current working directory to the new one. Once completed, any command you issue will operate under the new working directory, and your prompt will be updated to reflect your current working directory. Multiple folders can be traversed at once (assuming you know the correct names) by typing their names together with the '''\''' separating them for example<br />
<br />
C:\>'''CD SIERRA\KQ5'''<br />
C:\SIERRA\KQ5><br />
<br />
:There are also 3 special directories that are available inside every directory which help you simply move around. They are<br />
<br />
. which refers to the current directory <br />
<br />
.. which refers to the directory directly above the current directory<br />
<br />
/ which refers to the root directory<br />
<br />
:Once you have moved into a sub directory, you can move back by typing<br />
<br />
C:\SIERRA\KQ5>'''CD ..'''<br />
C:\SIERRA><br />
<br />
:And like all other directories you can string them together<br />
<br />
C:\SIERRA\KQ5>'''CD ..\..'''<br />
C:\><br />
<br />
:If you ever need to move back to the root directory you can use the '''\''' alias.<br />
<br />
C:\SIERRA\KQ5>'''CD \'''<br />
C:\><br />
<br />
== CHOICE ==<br />
:Waits for a keypress and sets ERRORLEVEL. Displays the given prompt followed by [Y,N]? for yes or no respones.<br />
:Used for batch scripts in most cases.<br />
<br />
CHOICE "Text to ask"<br />
<br />
== CLS ==<br />
:Clears the screen of all input and returns just the current prompt in the upper left hand corner.<br />
<br />
== [[CONFIG]] ==<br />
:Change or query various DOSBox settings during runtime.<br />
<br />
== COPY ==<br />
:Copy a file<br />
:Syntax is COPY <Orignal Filename> <New Filename><br />
<br />
COPY Document.txt CopyOfDocument.TXT<br />
<br />
== DEL ==<br />
:Remove one or more files.<br />
<br />
== DIR ==<br />
:Lists all of the available files and sub directories inside the current directory. Some variants of this are "dir/p" (pauses after each page) and "dir/w" (this gives a wide view)<br />
<br />
== EXIT ==<br />
:Exit from DOSBox.<br />
<br />
== [[IMGMOUNT]] ==<br />
:Mount CD-ROM and floppy disk images.<br />
<br />
== [[IPX]] ==<br />
:Allows you to connect multiple instances of DOSBox using the IPX protocal. <br />
<br />
== [[KEYB]] ==<br />
:Is used to change the layout of the keyboard used for different countries. <br />
<br />
== LOADFIX ==<br />
:Loads a program above the first 64K of memory.<br />
<br />
== LOADHIGH ==<br />
:Loads a program into upper memory (requires xms=true,umb=true)<br />
<br />
== MD ==<br />
:Makes a directory.<br />
<br />
== [[MEM]] ==<br />
:A program to display the amount of free memory.<br />
<br />
== [[MIXER]] ==<br />
:Display current sound levels.<br />
<br />
== [[MOUNT|MOUNT & IMGMOUNT]] ==<br />
: Mount folders and CD-ROM drives.<br />
<br />
== MOVE (unsupported) ==<br />
:DOSBox has no MOVE command. Use the REN command to move files.<br />
<br />
== RD ==<br />
:Removes a directory.<br />
<br />
== REN ==<br />
:Renames one or more files.<br />
:Note: Unlike MS-DOS, DOSBox doesn't require the source and target filenames to be in the same folder.<br />
<br />
== [[RESCAN]] ==<br />
: Refresh mounted drives. This has the same affect as pressing CTRL-F4.<br />
<br />
== TYPE ==<br />
:Display the contents of a text-file.<br />
<br />
== SET ==<br />
:Displays and sets environment variables<br />
<br />
== VER ==<br />
:View and set the reported DOS version. Also displays the running DOSBox version.<br />
:To set the reported DOS version use the following:<br />
<br />
VER SET <MAJOR> [MINOR]<br />
<br />
:where MAJOR is the number before the period, and MINOR is what comes after.<br />
:Versions can range from 0.0 to 255.255. Any values over 255 will loop from zero. (That is, 256=0, 257=1, 258=2, etc)</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=PATH&diff=134608PATH2015-06-09T20:14:07Z<p>Beresford: changed utilities link to commands link</p>
<hr />
<div>The PATH is an environment variable that instructs DOSBox where to find an executable if one cannot be found in the current directory. <br />
== Example PATH ==<br />
<code><pre>PATH=Z:\;C:\UTILITIES;C:\DOS</pre></code><br />
Each element should be a full path (drive letter and sub directories) for clarity, and they should each be separated by a ''';'''. Linux and Apple users should be aware that the current working directory is always checked first (unlike your host system, which requires a '''./''' to be inside your path). By default the '''[[ZDrive|Z:\]]''' is at the beginning of the PATH making the default DOSBox [[Commands|utilities]] available to you no matter what sub directory you are currently in. Very few software tools would require a change in your PATH, usually only system wide command line utilities like text editors.<br />
<br />
The PATH can be modified by the [[Commands#SET|SET]] command.</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=ZDrive&diff=134607ZDrive2015-06-09T20:12:53Z<p>Beresford: changed utilities link to commands link</p>
<hr />
<div>When DOSBox loads it automatically creates a Virtual Internal Drive called '''Z:''' which contains various [[Commands|utilities]] that make a reasonable approximation of a fully setup DOS Compatible environment. This drive is automatically inserted to the front of the [[PATH]] and cannot be modified. This Z: Drive can be largely hidden with some creative modifications to the [[AUTOEXEC|AUTOEXEC.BAT]] for a more complete emulation of MS-DOS.<br />
<br />
You can find the following files in Z: drive.<br />
* COMMAND.COM<br />
* AUTOEXEC.BAT<br />
* INTRO.COM<br />
* [[KEYB|KEYB.COM]]<br />
* [[IMGMOUNT|IMGMOUNT.COM]]<br />
* [[BOOT|BOOT.COM]]<br />
* [[RESCAN|RESCAN.COM]]<br />
* [[LOADFIX|LOADFIX.COM]]<br />
* [[MEM|MEM.COM]]<br />
* [[MOUNT|MOUNT.COM]]<br />
* [[MIXER|MIXER.COM]]<br />
* [[CONFIG|CONFIG.COM]]</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Contact&diff=134606Contact2015-06-09T20:08:22Z<p>Beresford: fixed forum url to go directly to the dosbox section</p>
<hr />
<div>Use the [http://www.vogons.org/viewforum.php?f=53 forum] for questions.</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Main_Page&diff=134605Main Page2015-06-09T20:03:01Z<p>Beresford: fixed forum url to go directly to the dosbox section</p>
<hr />
<div>'''<br />
=Welcome to the Wiki page of the DOSBox project=<br />
<br />
'''DOSBox''' emulates an Intel x86 PC, complete with [[Sound|sound]], [[Display|graphics]], [[Input|mouse]], [[Input|joystick]], [[Connectivity|modem]], etc., necessary for running many old MS-DOS [[GAMES|games]] that simply cannot be run on modern PCs and operating systems, such as Microsoft Windows XP, Windows Vista, Linux and FreeBSD. However, it is not restricted to running only games. In theory, any MS-DOS or PC-DOS (referred to commonly as "DOS") [[Software|application]] should run in DOSBox, but the emphasis has been on getting DOS [[GAMES|games]] to run smoothly, which means that communication, networking and printer support are still in early development.<br />
<br />
DOSBox also comes with its own [[Command Line|DOS-like command prompt]]. It is still quite rudimentary and lacks many of the features found in MS-DOS, but it is sufficient for installing and running most DOS [[GAMES|games]].<br />
<br />
DOSBox has a lively, user-supported [http://www.vogons.org/viewforum.php?f=53 community forum] hosted at VOGONS (Very Old Games On New Systems). Feel very very free to drop by if you have questions about DOSBox!<br />
<br />
==General Information==<br />
*[[Releases|Downloading DOSBox]]<br />
*[[System Requirements]]<br />
*[[DOSBox_FAQ|Frequently Asked Questions]] (FAQ)<br />
*Guides<br />
**[[Basic_Setup_and_Installation_of_DosBox|Basic Setup and Installation of DOSBox]]<br />
***[[DOSBox and Windows Vista|Vista Specific Issues]]<br />
***[[DOSBox and Mac OSX|Mac OSX Specific Issues]]<br />
***[[Mac OSX Advanced]]<br />
***[[Recording Video]]<br />
**[[Contributing to this Wiki]]<br />
**[[GAMES|Games]] that DOSBox can (or can't) run<br />
**[[Software]] applications that DOSBox can (or can't) run<br />
**[[TOOLS|Tools]] that can assist either playing games or using DOSBox generally<br />
**[[DOSBoxFrontends|Frontends]] - simplifies running and understanding DOSBox.<br />
**[[Performance|Running Resource Demanding Games]]<br />
*[[Special Thanks]]<br />
*[[Contact]]<br />
<br />
==More Specific Topics==<br />
*[[Usage| DOSBox.exe Supported Parameters]]<br />
*[[ZDrive|Z:\> Prompt]]<br />
*[[Commands|Command Line Utilities]]<br />
**[[MOUNT|Mounting your CD-ROM in DOSBox]]<br />
*[[Special Keys]]<br />
*[[dosbox.conf|The Configuration File]] (dosbox.conf)<br />
**[[Associating the Configuration File in Windows]]<br />
*[[Language File|The Language File]]<br />
*[[Keymapper|The Keymapper]]<br />
*[[Ubuntu Configuration|Ubuntu Configuration]]<br />
*[[DOSBoxShortcuts|DOSBox Shortcuts]]<br />
*[[GOG_games_that_use_DOSBox|GOG Games that use DOSBox]] - An overview<br />
<br />
==DOSBox Resources==<br />
*[http://dosbox.cvs.sourceforge.net/dosbox/dosbox/README?view=markup DOSBox README File]<br />
*[http://dosbox.com/comp_list.php List of Games and Applications] (and how to install and run them)<br />
*[http://www.vogons.org/viewforum.php?f=53 DOSBox community forum]<br />
*[http://dosbox.sourceforge.net/oldwiki/ The original DOSBox Wiki]<br />
<br />
==Advanced Topics==<br />
*[[BuildingDOSBox|Building DOSBox]] - Building your own version of DOSBox using mingw<br />
*[[Building_DOSBox_with_Visual_C_2008_Express|Building DOSBox with Visual C 2008 Express]]<br />
*[https://wiki.libsdl.org/FAQUsingSDL Using SDL FAQ] (SDL environment variables that can make or break things)<br />
*[[Special:Allpages|Index of all articles]]</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Basic_Setup_and_Installation_of_DosBox&diff=134604Basic Setup and Installation of DosBox2015-06-09T02:57:02Z<p>Beresford: moved the windows quick start to the bottom</p>
<hr />
<div>== Basic Concepts ==<br />
<br />
DOSBox is an emulator that recreates a MS-DOS compatible environment (complete with Sound, Input, Graphics and even basic networking). This environment is complete enough to run many classic MS-DOS games completely unmodified. In order to utilize all of DOSBox's features you need to first understand some basic concepts about the MS-DOS environment.<br />
<br />
* [[MOUNT|Mount a Drive]]<br />
* [[Drives]]<br />
* [[Sound]]<br />
* [[Display]]<br />
* [[Input]]<br />
* [[Connectivity]] (Modems/Networking)<br />
<br />
== Installation ==<br />
<br />
The first step is to install DOSBox. This guide will use the [[Version0.74|0.74]] Windows 32-bit version which is available for [http://www.dosbox.com/download.php?main=1 download]. Download the [[Releases|release]] for your operating system. If you are a Windows user, get the '''Win32 installer'''.<br />
<br />
After downloading, install DOSBox to any directory. Also, make a folder to put all your old games in. I put DOSBox in '''<tt>C:\DOSBox</tt>''', and my old games directory is '''<tt>C:\OLDGAMES</tt>'''. I put a game in my '''<tt>OLDGAMES</tt>''' directory, '''<tt>TESTDRIV</tt>''', which is [[GAMES:TestDrive|Test Drive]], an old racing game. Your directories should look like this:<br />
<br />
[[Image:DOSBox-Folders.jpg]]<br />
<br />
== Running a game ==<br />
<br />
Now, the hardest part, getting games to run. First, run '''dosbox.exe''' in your DOSBox folder. Remember that '''<tt>OLDGAMES</tt>''' directory you created in Step 1? You have to basically set that as new directory just for DOSBox. Essentially, it's going to become the '''[[CDrive|C:\>]]''' drive of DOSBox. So, type:<br />
Z:\>'''MOUNT C C:\OLDGAMES'''<br />
Drive C mounted as local directory C:\OLDGAMES\<br />
<br />
To dissect the above:<br />
*'''[[MOUNT]]''': Tells the program to [[MOUNT|mount]] a directory<br />
*'''C''': Tells the program what you want your new drive to be called (leaving it as C: is fine)<br />
*'''C:\OLDGAMES''': This is the directory I want to set as the new drive for DOSBox, because all my games are in it. If you created a different directory, write in the directory you created.<br />
<br />
''(Note: If you want to [[MOUNT|mount]] a CD-ROM instead of a folder, type this:''<br />
Z:\>'''MOUNT D D:\ -t cdrom'''<br />
MSCDEX installed.<br />
Drive D is mounted as CDRom D:\<br />
<br />
''(Note: '''"cdrom"''' is case sensitive and must be lowercase!)''<br />
<br />
In this example, '''D:\ -T cdrom''' tells DOSBox that my D:\ drive is a CD-ROM drive, and the first '''D''', tells DOSBox what my new drive name should be called. If you are running your game off a CD-ROM then make sure to use '''D:''' in place of '''C:''' in the following examples. You can find instructions on how to [[MOUNT|mount]] other devices, such as floppy drives, in the [[MOUNT|mount]] section).''<br />
<br />
After you've done this, you will be prompted with a '''[[ZDrive|Z:\>]]'''. Now, just write what you wanted to call your new DOSBox drive, which as I said above, we called '''C'''. To navigate to that newly mounted drive just type in:<br />
<br />
Z:\>'''C:'''<br />
<br />
C:\><br />
<br />
Hopefully, you're all set! Now, it's time to run the game. Previously I had mentioned a game called '''<tt>TESTDRIV</tt>''' in my '''<tt>OLDGAMES</tt>''' folder. I now want DOSBox to go to that folder. So type in:<br />
<br />
C:\>'''CD TESTDRIV'''<br />
<br />
C:\TESTDRIV><br />
<br />
That's it! [[Commands#CD|CD]] stands for "Change Directory", so you've changed the directory to TESTDRIV. You can find instructions on how to use the [[Commands#CD|Change Directory]] command, in the [[Commands#CD|CD]] section of the [[Commands]] article.<br />
<br />
One more step, running the game! Most games have an EXE file in their directory that you can run. However, some might require a BAT file, or COM file (common in demos and really old games). Most of the time, the file is in the root folder. Please consult the documentation of your game for which file is needed to start the game. In the case of [[GAMES:TestDrive|Test Drive]], it's '''TDCGA.EXE'''. So now, I just type this:<br />
<br />
C:\TESTDRIV>'''TDCGA.EXE'''<br />
<br />
That's it! Here's a picture of all of the commands I've written about in Step 2: <br />
<br />
[[Image:Dosbox2.jpg]]<br />
<br />
== Alternate methods for running a game ==<br />
<br />
The steps described above are closely aligned with how DOS Based operating systems behave natively. However modern operating system allow for more user friendly (although less authentic) ways of playing your favorite games. If the steps above seem tedious or confusing you can try some of these other guides. In most cases these guides will still require you to setup a working DOSBox environment.<br />
<br />
*[[DOSBoxFrontends|Using Frontends]]<br />
*[[DOSBoxShortcuts|Creating desktop shortcuts]]<br />
**[[DOSBoxShortcuts#Windows|in Microsoft Windows]]<br />
**[[DOSBoxShortcuts#OSX|in Apple OSX]]<br />
**[[DOSBoxShortcuts#GNOME|in Linux GNOME]]<br />
<br />
NOTE: If you have problems with launching the game, unrecognizable errors being spit out, saving settings, or having the game drop out while running it, one thing to try is to make sure all the files are not set to Read Only. In Windows, select the folder of the game, right click and hit properties, uncheck '''Read Only''' if it is checked, and apply to all sub folders.<br />
<br />
If you have other errors, please search the [http://vogons.org forums] first before posting a question.<br />
<br />
== Performance ==<br />
Yay, you've gotten your game to run! But maybe you're experiencing slowdown? How do you fix this? With the following commands:<br />
<br />
'''<tt>CTRL+F7</tt>''' = Decreases frameskip<br/><br />
'''<tt>CTRL+F8</tt>''' = Increases Frameskip<br/><br />
'''<tt>CTRL+F11</tt>''' = Slows down the game<br/><br />
'''<tt>CTRL+F12</tt>''' = Speeds up the game<br/><br />
<br />
Press '''<tt>CTRL+ALT+DEL</tt>''' to open the Task Manager, and click the Performance tab. Start by pressing '''<tt>CTRL+F12</tt>''' until your CPU Usage level begins to go above 95%. After that, if you still need a performance boost, hit '''<tt>CTRL+F8</tt>''' to have DOSBox not render some frames. The console window will display all of the changes you've made, and the top of the game window will display the current settings. Adjust these settings as needed until your game goes smoothly. '''''Please keep in mind that not all games will run smoothly on DOSBox.'''''<br />
<br />
[[Image:Dosbox3.jpg]]<br />
<br />
== Other Useful features ==<br />
<br />
=== Quick Start for Windows ===<br />
Windows users have an option of dragging the EXE of their DOS game onto the DOSBox program (or shorcut pointing to the DOSBox program). This will automatically start the game. If this doesn't work, then I would recommend reading the rest of this article.<br />
<br />
=== Automatically Mounting Your DOS Games folder ===<br />
<br />
You can save yourself some time by having DOSBox automatically [[MOUNT]] your folders and change the drive to '''C:'''. In original DOS based operating systems a file called '''<tt>[[AUTOEXEC|AUTOEXEC.BAT]]</tt>''' contained any commands that the user wanted executed every time the computer booted up. This functionality is simulated by the [[dosbox.conf#.5Bautoexec.5D|[autoexec]]] section of the [[dosbox.conf]] file. <br />
<br />
For DOSBox versions older than 0.73 browse into program installation folder and open the [[dosbox.conf]] file in any text editor. For version 0.73 go to Start Menu and click on "Configuration" and then "Edit Configuration". Then scroll down to the very end, and add these lines:<br />
<br />
<code><pre>MOUNT C C:\OLDGAMES<br />
C:</pre></code><br />
<br />
Now those commands will be executed automatically when starting! If you're having trouble with that, make sure it looks like this (look at the bottom): <br />
<br />
[[Image:Dosbox4.jpg]]<br />
<br />
=== Full Screen ===<br />
<br />
Just press '''<tt>ALT+ENTER</tt>''' to go into and out of full screen.<br />
<br />
Alternatively, you can open the [[dosbox.conf]] file as mentioned above and change "fullscreen=false" to "fullscreen=true". DOSBox will then run in full screen mode when you open it.</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Basic_Setup_and_Installation_of_DosBox&diff=134603Basic Setup and Installation of DosBox2015-06-09T01:52:19Z<p>Beresford: added a quick start section for Windows users</p>
<hr />
<div>== Quick Start for Windows ==<br />
Windows users have an option of dragging the EXE of their DOS game onto the DOSBox program (or shorcut pointing to the DOSBox program). This will automatically start the game. If this doesn't work, then I would recommend reading the rest of this article.<br />
<br />
== Basic Concepts ==<br />
<br />
DOSBox is an emulator that recreates a MS-DOS compatible environment (complete with Sound, Input, Graphics and even basic networking). This environment is complete enough to run many classic MS-DOS games completely unmodified. In order to utilize all of DOSBox's features you need to first understand some basic concepts about the MS-DOS environment.<br />
<br />
* [[MOUNT|Mount a Drive]]<br />
* [[Drives]]<br />
* [[Sound]]<br />
* [[Display]]<br />
* [[Input]]<br />
* [[Connectivity]] (Modems/Networking)<br />
<br />
== Installation ==<br />
<br />
The first step is to install DOSBox. This guide will use the [[Version0.74|0.74]] Windows 32-bit version which is available for [http://www.dosbox.com/download.php?main=1 download]. Download the [[Releases|release]] for your operating system. If you are a Windows user, get the '''Win32 installer'''.<br />
<br />
After downloading, install DOSBox to any directory. Also, make a folder to put all your old games in. I put DOSBox in '''<tt>C:\DOSBox</tt>''', and my old games directory is '''<tt>C:\OLDGAMES</tt>'''. I put a game in my '''<tt>OLDGAMES</tt>''' directory, '''<tt>TESTDRIV</tt>''', which is [[GAMES:TestDrive|Test Drive]], an old racing game. Your directories should look like this:<br />
<br />
[[Image:DOSBox-Folders.jpg]]<br />
<br />
== Running a game ==<br />
<br />
Now, the hardest part, getting games to run. First, run '''dosbox.exe''' in your DOSBox folder. Remember that '''<tt>OLDGAMES</tt>''' directory you created in Step 1? You have to basically set that as new directory just for DOSBox. Essentially, it's going to become the '''[[CDrive|C:\>]]''' drive of DOSBox. So, type:<br />
Z:\>'''MOUNT C C:\OLDGAMES'''<br />
Drive C mounted as local directory C:\OLDGAMES\<br />
<br />
To dissect the above:<br />
*'''[[MOUNT]]''': Tells the program to [[MOUNT|mount]] a directory<br />
*'''C''': Tells the program what you want your new drive to be called (leaving it as C: is fine)<br />
*'''C:\OLDGAMES''': This is the directory I want to set as the new drive for DOSBox, because all my games are in it. If you created a different directory, write in the directory you created.<br />
<br />
''(Note: If you want to [[MOUNT|mount]] a CD-ROM instead of a folder, type this:''<br />
Z:\>'''MOUNT D D:\ -t cdrom'''<br />
MSCDEX installed.<br />
Drive D is mounted as CDRom D:\<br />
<br />
''(Note: '''"cdrom"''' is case sensitive and must be lowercase!)''<br />
<br />
In this example, '''D:\ -T cdrom''' tells DOSBox that my D:\ drive is a CD-ROM drive, and the first '''D''', tells DOSBox what my new drive name should be called. If you are running your game off a CD-ROM then make sure to use '''D:''' in place of '''C:''' in the following examples. You can find instructions on how to [[MOUNT|mount]] other devices, such as floppy drives, in the [[MOUNT|mount]] section).''<br />
<br />
After you've done this, you will be prompted with a '''[[ZDrive|Z:\>]]'''. Now, just write what you wanted to call your new DOSBox drive, which as I said above, we called '''C'''. To navigate to that newly mounted drive just type in:<br />
<br />
Z:\>'''C:'''<br />
<br />
C:\><br />
<br />
Hopefully, you're all set! Now, it's time to run the game. Previously I had mentioned a game called '''<tt>TESTDRIV</tt>''' in my '''<tt>OLDGAMES</tt>''' folder. I now want DOSBox to go to that folder. So type in:<br />
<br />
C:\>'''CD TESTDRIV'''<br />
<br />
C:\TESTDRIV><br />
<br />
That's it! [[Commands#CD|CD]] stands for "Change Directory", so you've changed the directory to TESTDRIV. You can find instructions on how to use the [[Commands#CD|Change Directory]] command, in the [[Commands#CD|CD]] section of the [[Commands]] article.<br />
<br />
One more step, running the game! Most games have an EXE file in their directory that you can run. However, some might require a BAT file, or COM file (common in demos and really old games). Most of the time, the file is in the root folder. Please consult the documentation of your game for which file is needed to start the game. In the case of [[GAMES:TestDrive|Test Drive]], it's '''TDCGA.EXE'''. So now, I just type this:<br />
<br />
C:\TESTDRIV>'''TDCGA.EXE'''<br />
<br />
That's it! Here's a picture of all of the commands I've written about in Step 2: <br />
<br />
[[Image:Dosbox2.jpg]]<br />
<br />
== Alternate methods for running a game ==<br />
<br />
The steps described above are closely aligned with how DOS Based operating systems behave natively. However modern operating system allow for more user friendly (although less authentic) ways of playing your favorite games. If the steps above seem tedious or confusing you can try some of these other guides. In most cases these guides will still require you to setup a working DOSBox environment.<br />
<br />
*[[DOSBoxFrontends|Using Frontends]]<br />
*[[DOSBoxShortcuts|Creating desktop shortcuts]]<br />
**[[DOSBoxShortcuts#Windows|in Microsoft Windows]]<br />
**[[DOSBoxShortcuts#OSX|in Apple OSX]]<br />
**[[DOSBoxShortcuts#GNOME|in Linux GNOME]]<br />
<br />
NOTE: If you have problems with launching the game, unrecognizable errors being spit out, saving settings, or having the game drop out while running it, one thing to try is to make sure all the files are not set to Read Only. In Windows, select the folder of the game, right click and hit properties, uncheck '''Read Only''' if it is checked, and apply to all sub folders.<br />
<br />
If you have other errors, please search the [http://vogons.org forums] first before posting a question.<br />
<br />
== Performance ==<br />
Yay, you've gotten your game to run! But maybe you're experiencing slowdown? How do you fix this? With the following commands:<br />
<br />
'''<tt>CTRL+F7</tt>''' = Decreases frameskip<br/><br />
'''<tt>CTRL+F8</tt>''' = Increases Frameskip<br/><br />
'''<tt>CTRL+F11</tt>''' = Slows down the game<br/><br />
'''<tt>CTRL+F12</tt>''' = Speeds up the game<br/><br />
<br />
Press '''<tt>CTRL+ALT+DEL</tt>''' to open the Task Manager, and click the Performance tab. Start by pressing '''<tt>CTRL+F12</tt>''' until your CPU Usage level begins to go above 95%. After that, if you still need a performance boost, hit '''<tt>CTRL+F8</tt>''' to have DOSBox not render some frames. The console window will display all of the changes you've made, and the top of the game window will display the current settings. Adjust these settings as needed until your game goes smoothly. '''''Please keep in mind that not all games will run smoothly on DOSBox.'''''<br />
<br />
[[Image:Dosbox3.jpg]]<br />
<br />
== Other Useful features ==<br />
<br />
=== Quick start ===<br />
<br />
You can save yourself some time by having DOSBox automatically [[MOUNT]] your folders and change the drive to '''C:'''. In original DOS based operating systems a file called '''<tt>[[AUTOEXEC|AUTOEXEC.BAT]]</tt>''' contained any commands that the user wanted executed every time the computer booted up. This functionality is simulated by the [[dosbox.conf#.5Bautoexec.5D|[autoexec]]] section of the [[dosbox.conf]] file. <br />
<br />
For DOSBox versions older than 0.73 browse into program installation folder and open the [[dosbox.conf]] file in any text editor. For version 0.73 go to Start Menu and click on "Configuration" and then "Edit Configuration". Then scroll down to the very end, and add these lines:<br />
<br />
<code><pre>MOUNT C C:\OLDGAMES<br />
C:</pre></code><br />
<br />
Now those commands will be executed automatically when starting! If you're having trouble with that, make sure it looks like this (look at the bottom): <br />
<br />
[[Image:Dosbox4.jpg]]<br />
<br />
=== Full Screen ===<br />
<br />
Just press '''<tt>ALT+ENTER</tt>''' to go into and out of full screen.<br />
<br />
Alternatively, you can open the [[dosbox.conf]] file as mentioned above and change "fullscreen=false" to "fullscreen=true". DOSBox will then run in full screen mode when you open it.</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Main_Page&diff=134602Main Page2015-06-09T01:37:09Z<p>Beresford: /* General Information */ added back in the basic setup section which i accidentally removed</p>
<hr />
<div>'''<br />
=Welcome to the Wiki page of the DOSBox project=<br />
<br />
'''DOSBox''' emulates an Intel x86 PC, complete with [[Sound|sound]], [[Display|graphics]], [[Input|mouse]], [[Input|joystick]], [[Connectivity|modem]], etc., necessary for running many old MS-DOS [[GAMES|games]] that simply cannot be run on modern PCs and operating systems, such as Microsoft Windows XP, Windows Vista, Linux and FreeBSD. However, it is not restricted to running only games. In theory, any MS-DOS or PC-DOS (referred to commonly as "DOS") [[Software|application]] should run in DOSBox, but the emphasis has been on getting DOS [[GAMES|games]] to run smoothly, which means that communication, networking and printer support are still in early development.<br />
<br />
DOSBox also comes with its own [[Command Line|DOS-like command prompt]]. It is still quite rudimentary and lacks many of the features found in MS-DOS, but it is sufficient for installing and running most DOS [[GAMES|games]].<br />
<br />
DOSBox has a lively, user-supported [http://vogons.org community forum] hosted at VOGONS (Very Old Games On New Systems). Feel very very free to drop by if you have questions about DOSBox!<br />
<br />
==General Information==<br />
*[[Releases|Downloading DOSBox]]<br />
*[[System Requirements]]<br />
*[[DOSBox_FAQ|Frequently Asked Questions]] (FAQ)<br />
*Guides<br />
**[[Basic_Setup_and_Installation_of_DosBox|Basic Setup and Installation of DOSBox]]<br />
***[[DOSBox and Windows Vista|Vista Specific Issues]]<br />
***[[DOSBox and Mac OSX|Mac OSX Specific Issues]]<br />
***[[Mac OSX Advanced]]<br />
***[[Recording Video]]<br />
**[[Contributing to this Wiki]]<br />
**[[GAMES|Games]] that DOSBox can (or can't) run<br />
**[[Software]] applications that DOSBox can (or can't) run<br />
**[[TOOLS|Tools]] that can assist either playing games or using DOSBox generally<br />
**[[DOSBoxFrontends|Frontends]] - simplifies running and understanding DOSBox.<br />
**[[Performance|Running Resource Demanding Games]]<br />
*[[Special Thanks]]<br />
*[[Contact]]<br />
<br />
==More Specific Topics==<br />
*[[Usage| DOSBox.exe Supported Parameters]]<br />
*[[ZDrive|Z:\> Prompt]]<br />
*[[Commands|Command Line Utilities]]<br />
**[[MOUNT|Mounting your CD-ROM in DOSBox]]<br />
*[[Special Keys]]<br />
*[[dosbox.conf|The Configuration File]] (dosbox.conf)<br />
**[[Associating the Configuration File in Windows]]<br />
*[[Language File|The Language File]]<br />
*[[Keymapper|The Keymapper]]<br />
*[[Ubuntu Configuration|Ubuntu Configuration]]<br />
*[[DOSBoxShortcuts|DOSBox Shortcuts]]<br />
*[[GOG_games_that_use_DOSBox|GOG Games that use DOSBox]] - An overview<br />
<br />
==DOSBox Resources==<br />
*[http://dosbox.cvs.sourceforge.net/dosbox/dosbox/README?view=markup DOSBox README File]<br />
*[http://dosbox.com/comp_list.php List of Games and Applications] (and how to install and run them)<br />
*[http://vogons.org DOSBox community forum]<br />
*[http://dosbox.sourceforge.net/oldwiki/ The original DOSBox Wiki]<br />
<br />
==Advanced Topics==<br />
*[[BuildingDOSBox|Building DOSBox]] - Building your own version of DOSBox using mingw<br />
*[[Building_DOSBox_with_Visual_C_2008_Express|Building DOSBox with Visual C 2008 Express]]<br />
*[https://wiki.libsdl.org/FAQUsingSDL Using SDL FAQ] (SDL environment variables that can make or break things)<br />
*[[Special:Allpages|Index of all articles]]</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Main_Page&diff=134601Main Page2015-06-09T01:31:17Z<p>Beresford: /* More Specific Topics */ removed utilities page, its been consolidated onto the commands page</p>
<hr />
<div>'''<br />
=Welcome to the Wiki page of the DOSBox project=<br />
<br />
'''DOSBox''' emulates an Intel x86 PC, complete with [[Sound|sound]], [[Display|graphics]], [[Input|mouse]], [[Input|joystick]], [[Connectivity|modem]], etc., necessary for running many old MS-DOS [[GAMES|games]] that simply cannot be run on modern PCs and operating systems, such as Microsoft Windows XP, Windows Vista, Linux and FreeBSD. However, it is not restricted to running only games. In theory, any MS-DOS or PC-DOS (referred to commonly as "DOS") [[Software|application]] should run in DOSBox, but the emphasis has been on getting DOS [[GAMES|games]] to run smoothly, which means that communication, networking and printer support are still in early development.<br />
<br />
DOSBox also comes with its own [[Command Line|DOS-like command prompt]]. It is still quite rudimentary and lacks many of the features found in MS-DOS, but it is sufficient for installing and running most DOS [[GAMES|games]].<br />
<br />
DOSBox has a lively, user-supported [http://vogons.org community forum] hosted at VOGONS (Very Old Games On New Systems). Feel very very free to drop by if you have questions about DOSBox!<br />
<br />
==General Information==<br />
*[[Releases|Downloading DOSBox]]<br />
*[[System Requirements]]<br />
*[[DOSBox_FAQ|Frequently Asked Questions]] (FAQ)<br />
*Guides<br />
**Basic Setup and Installation of DOSBox<br />
***[[DOSBox and Windows Vista|Vista Specific Issues]]<br />
***[[DOSBox and Mac OSX|Mac OSX Specific Issues]]<br />
***[[Mac OSX Advanced]]<br />
***[[Recording Video]]<br />
**[[Contributing to this Wiki]]<br />
**[[GAMES|Games]] that DOSBox can (or can't) run<br />
**[[Software]] applications that DOSBox can (or can't) run<br />
**[[TOOLS|Tools]] that can assist either playing games or using DOSBox generally<br />
**[[DOSBoxFrontends|Frontends]] - simplifies running and understanding DOSBox.<br />
**[[Performance|Running Resource Demanding Games]]<br />
*[[Special Thanks]]<br />
*[[Contact]]<br />
<br />
==More Specific Topics==<br />
*[[Usage| DOSBox.exe Supported Parameters]]<br />
*[[ZDrive|Z:\> Prompt]]<br />
*[[Commands|Command Line Utilities]]<br />
**[[MOUNT|Mounting your CD-ROM in DOSBox]]<br />
*[[Special Keys]]<br />
*[[dosbox.conf|The Configuration File]] (dosbox.conf)<br />
**[[Associating the Configuration File in Windows]]<br />
*[[Language File|The Language File]]<br />
*[[Keymapper|The Keymapper]]<br />
*[[Ubuntu Configuration|Ubuntu Configuration]]<br />
*[[DOSBoxShortcuts|DOSBox Shortcuts]]<br />
*[[GOG_games_that_use_DOSBox|GOG Games that use DOSBox]] - An overview<br />
<br />
==DOSBox Resources==<br />
*[http://dosbox.cvs.sourceforge.net/dosbox/dosbox/README?view=markup DOSBox README File]<br />
*[http://dosbox.com/comp_list.php List of Games and Applications] (and how to install and run them)<br />
*[http://vogons.org DOSBox community forum]<br />
*[http://dosbox.sourceforge.net/oldwiki/ The original DOSBox Wiki]<br />
<br />
==Advanced Topics==<br />
*[[BuildingDOSBox|Building DOSBox]] - Building your own version of DOSBox using mingw<br />
*[[Building_DOSBox_with_Visual_C_2008_Express|Building DOSBox with Visual C 2008 Express]]<br />
*[https://wiki.libsdl.org/FAQUsingSDL Using SDL FAQ] (SDL environment variables that can make or break things)<br />
*[[Special:Allpages|Index of all articles]]</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Utilities&diff=134600Utilities2015-06-09T01:30:21Z<p>Beresford: updated to show that this page is now redundant</p>
<hr />
<div>This page has been consolidated onto the [[commands]] page.<br />
<br />
<strike>DOSBox supports most of the DOS commands found in command.com.<br />
To get a list of the internal commands type "HELP" at the prompt.<br />
<br />
In addition, the following commands are available: <br />
* [[MOUNT]]<br />
* [[MEM]]<br />
* [[VER]]<br />
* [[CONFIG]]<br />
* [[LOADFIX]]<br />
* [[RESCAN]]<br />
* [[MIXER]]<br />
* [[IMGMOUNT]]<br />
* [[BOOT]]<br />
* [[IPX]]<br />
* [[KEYB]]<br />
</strike></div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Commands&diff=134599Commands2015-06-09T01:25:17Z<p>Beresford: added lots of extra commands</p>
<hr />
<div>== [[BOOT]] ==<br />
:Will start floppy images or hard disk images independent of the operating system emulation offered by DOSBox. This will allow you to play booter floppies or boot other operating systems inside DOSBox. <br />
<br />
== CD (Change Directory) ==<br />
:Allows you to move up and down a directory tree. '''CD''' is simple to use, just type <br />
<br />
CD [Directory-Name]<br />
<br />
:And if the Directory-Name correctly refers to an available directory then you will be moved from your current working directory to the new one. Once completed, any command you issue will operate under the new working directory, and your prompt will be updated to reflect your current working directory. Multiple folders can be traversed at once (assuming you know the correct names) by typing their names together with the '''\''' separating them for example<br />
<br />
C:\>'''CD SIERRA\KQ5'''<br />
C:\SIERRA\KQ5><br />
<br />
:There are also 3 special directories that are available inside every directory which help you simply move around. They are<br />
<br />
. which refers to the current directory <br />
<br />
.. which refers to the directory directly above the current directory<br />
<br />
/ which refers to the root directory<br />
<br />
:Once you have moved into a sub directory, you can move back by typing<br />
<br />
C:\SIERRA\KQ5>'''CD ..'''<br />
C:\SIERRA><br />
<br />
:And like all other directories you can string them together<br />
<br />
C:\SIERRA\KQ5>'''CD ..\..'''<br />
C:\><br />
<br />
:If you ever need to move back to the root directory you can use the '''\''' alias.<br />
<br />
C:\SIERRA\KQ5>'''CD \'''<br />
C:\><br />
<br />
== CHOICE ==<br />
:Waits for a keypress and sets ERRORLEVEL. Displays the given prompt followed by [Y,N]? for yes or no respones.<br />
:Used for batch scripts in most cases.<br />
<br />
CHOICE "Text to ask"<br />
<br />
== CLS ==<br />
:Clears the screen of all input and returns just the current prompt in the upper left hand corner.<br />
<br />
== [[CONFIG]] ==<br />
:Change or query various DOSBox settings during runtime.<br />
<br />
== COPY ==<br />
:Copy a file<br />
:Syntax is COPY <Orignal Filename> <New Filename><br />
<br />
COPY Document.txt CopyOfDocument.TXT<br />
<br />
== DEL ==<br />
:Remove one or more files.<br />
<br />
== DIR ==<br />
:Lists all of the available files and sub directories inside the current directory. Some variants of this are "dir/p" (pauses after each page) and "dir/w" (this gives a wide view)<br />
<br />
== EXIT ==<br />
:Exit from DOSBox.<br />
<br />
== [[IMGMOUNT]] ==<br />
:Mount CD-ROM and floppy disk images.<br />
<br />
== [[IPX]] ==<br />
:Allows you to connect multiple instances of DOSBox using the IPX protocal. <br />
<br />
== [[KEYB]] ==<br />
:Is used to change the layout of the keyboard used for different countries. <br />
<br />
== LOADFIX ==<br />
:Loads a program above the first 64K of memory.<br />
<br />
== LOADHIGH ==<br />
:Loads a program into upper memory (requires xms=true,umb=true)<br />
<br />
== MD ==<br />
:Makes a directory.<br />
<br />
== [[MEM]] ==<br />
:A program to display the amount of free memory.<br />
<br />
== [[MIXER]] ==<br />
:Display current sound levels.<br />
<br />
== [[MOUNT]] ==<br />
: Mount folders and CD-ROM drives.<br />
<br />
== MOVE (unsupported) ==<br />
:DOSBox has no MOVE command. Use the REN command to move files.<br />
<br />
== RD ==<br />
:Removes a directory.<br />
<br />
== REN ==<br />
:Renames one or more files.<br />
:Note: Unlike MS-DOS, DOSBox doesn't require the source and target filenames to be in the same folder.<br />
<br />
== [[RESCAN]] ==<br />
: Refresh mounted drives. This has the same affect as pressing CTRL-F4.<br />
<br />
== TYPE ==<br />
:Display the contents of a text-file.<br />
<br />
== SET ==<br />
:Displays and sets environment variables<br />
<br />
== VER ==<br />
:View and set the reported DOS version. Also displays the running DOSBox version.<br />
:To set the reported DOS version use the following:<br />
<br />
VER SET <MAJOR> [MINOR]<br />
<br />
:where MAJOR is the number before the period, and MINOR is what comes after.<br />
:Versions can range from 0.0 to 255.255. Any values over 255 will loop from zero. (That is, 256=0, 257=1, 258=2, etc)</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Main_Page&diff=134598Main Page2015-06-08T23:55:26Z<p>Beresford: /* More Specific Topics */ renamed usage link again to try and avoid ambiguity</p>
<hr />
<div>'''<br />
=Welcome to the Wiki page of the DOSBox project=<br />
<br />
'''DOSBox''' emulates an Intel x86 PC, complete with [[Sound|sound]], [[Display|graphics]], [[Input|mouse]], [[Input|joystick]], [[Connectivity|modem]], etc., necessary for running many old MS-DOS [[GAMES|games]] that simply cannot be run on modern PCs and operating systems, such as Microsoft Windows XP, Windows Vista, Linux and FreeBSD. However, it is not restricted to running only games. In theory, any MS-DOS or PC-DOS (referred to commonly as "DOS") [[Software|application]] should run in DOSBox, but the emphasis has been on getting DOS [[GAMES|games]] to run smoothly, which means that communication, networking and printer support are still in early development.<br />
<br />
DOSBox also comes with its own [[Command Line|DOS-like command prompt]]. It is still quite rudimentary and lacks many of the features found in MS-DOS, but it is sufficient for installing and running most DOS [[GAMES|games]].<br />
<br />
DOSBox has a lively, user-supported [http://vogons.org community forum] hosted at VOGONS (Very Old Games On New Systems). Feel very very free to drop by if you have questions about DOSBox!<br />
<br />
==General Information==<br />
*[[Releases|Downloading DOSBox]]<br />
*[[System Requirements]]<br />
*[[DOSBox_FAQ|Frequently Asked Questions]] (FAQ)<br />
*Guides<br />
**Basic Setup and Installation of DOSBox<br />
***[[DOSBox and Windows Vista|Vista Specific Issues]]<br />
***[[DOSBox and Mac OSX|Mac OSX Specific Issues]]<br />
***[[Mac OSX Advanced]]<br />
***[[Recording Video]]<br />
**[[Contributing to this Wiki]]<br />
**[[GAMES|Games]] that DOSBox can (or can't) run<br />
**[[Software]] applications that DOSBox can (or can't) run<br />
**[[TOOLS|Tools]] that can assist either playing games or using DOSBox generally<br />
**[[DOSBoxFrontends|Frontends]] - simplifies running and understanding DOSBox.<br />
**[[Performance|Running Resource Demanding Games]]<br />
*[[Special Thanks]]<br />
*[[Contact]]<br />
<br />
==More Specific Topics==<br />
*[[Usage| DOSBox.exe Supported Parameters]]<br />
*[[ZDrive|Z:\> Prompt]]<br />
*[[Commands|Command Line Utilities]]<br />
*[[Utilities|Internal Programs]]<br />
**[[MOUNT|Mounting your CD-ROM in DOSBox]]<br />
*[[Special Keys]]<br />
*[[dosbox.conf|The Configuration File]] (dosbox.conf)<br />
**[[Associating the Configuration File in Windows]]<br />
*[[Language File|The Language File]]<br />
*[[Keymapper|The Keymapper]]<br />
*[[Ubuntu Configuration|Ubuntu Configuration]]<br />
*[[DOSBoxShortcuts|DOSBox Shortcuts]]<br />
*[[GOG_games_that_use_DOSBox|GOG Games that use DOSBox]] - An overview<br />
<br />
==DOSBox Resources==<br />
*[http://dosbox.cvs.sourceforge.net/dosbox/dosbox/README?view=markup DOSBox README File]<br />
*[http://dosbox.com/comp_list.php List of Games and Applications] (and how to install and run them)<br />
*[http://vogons.org DOSBox community forum]<br />
*[http://dosbox.sourceforge.net/oldwiki/ The original DOSBox Wiki]<br />
<br />
==Advanced Topics==<br />
*[[BuildingDOSBox|Building DOSBox]] - Building your own version of DOSBox using mingw<br />
*[[Building_DOSBox_with_Visual_C_2008_Express|Building DOSBox with Visual C 2008 Express]]<br />
*[https://wiki.libsdl.org/FAQUsingSDL Using SDL FAQ] (SDL environment variables that can make or break things)<br />
*[[Special:Allpages|Index of all articles]]</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Usage&diff=134597Usage2015-06-08T23:50:16Z<p>Beresford: /* Usage */ better explanation of -userconf parameter and minor formatting changes</p>
<hr />
<div>== Command Line Parameters ==<br />
<code>dosbox [name] [-exit] [-c command] [-fullscreen] [-userconf] [-conf congfigfilelocation] [-lang languagefilelocation] [-machine machine type] [-noconsole] [-startmapper] [-noautoexec] [-securemode] [-scaler scaler | -forcescaler scaler] [-version] [-socket socket] [-editconf program] [-opencaptures program] [-printconf] [-eraseconf] [-erasemapper]</code><br />
<br />
===Usage===<br />
;<code>name</code>: If <code>name</code> is a directory, DOSBox will mount the specified directory as the C drive.<br /> If <code>name</code> is an executable, DOSBox will mount the directory of <code>name</code> as the C drive, and start executing <code>name</code>.<br />
<br />
;<code>-exit</code>: DOSBox will close itself when the DOS application <code>name</code> ends.<br />
<br />
;<code>-c command</code>: Runs the specified command before running <code>name</code>. Multiple commands can be specified. Each command should start with <code>-c</code> though. A command can be: an Internal Program, a DOS command or an executable on a mounted drive.<br />
<br />
;<code>-fullscreen</code>: Starts DOSBox in fullscreen mode.<br />
<br />
;<code>-userconf</code>[http://www.vogons.org/viewtopic.php?f=31&t=38724#p349443]: Start DOSBox and load the default configuration as the primary configuration file. This will normally be used in conjunction with a game specific stub .conf file.<br />
<br />
;<code>-conf configfilelocation</code>: Start DOSBox with the options specified in <code>configfilelocation</code>. Multiple -conf options may be present.<br />
<br />
;<code>-lang languagefilelocation</code>: Start DOSBox using the language string specified in <code>languagefilelocation</code>.<br />
<br />
;<code>-machine machinetype</code>: Setup DOSBox to emulate a specific type of machine. Valid choices are: hercules, cga, ega, pcjr, tandy, svga_s3 (default) as well as the additional svga chipsets listed in the [[dosbox.conf|DOSBox configuration file]]. The machinetype affects the video card and the available sound cards.<br />
<br />
;<code>-noconsole</code> (Windows Only): Start DOSBox without showing the console window, output will be redirected to <code>stdout.txt</code> and <code>stderr.txt</code>. This is useful if DOSBox crashes, since the error messages stored in <code>stdout.txt</code> and <code>stderr.txt</code> may help the developers fixing the problem.<br />
<br />
;<code>-startmapper</code>: Enter the [[Mapper|mapper]] directly on startup. Useful for people with keyboard or joystick problems.<br />
<br />
;<code>-noautoexec</code>: Skips the [autoexec] section of the loaded configuration file.<br />
<br />
;<code>-securemode</code>: Same as -noautoexec, but adds config.com <code>-securemode</code> at the bottom of AUTOEXEC.BAT (which in turn disables any changes to how the drives are mounted inside DOSBox).<br />
<br />
;<code>-scaler</code>: Uses the scaler specified by "scaler". See the DOSBox [[dosbox.conf|configuration file]] for the available scalers.<br />
<br />
;<code>-forcescaler</code>: Similar to the -scaler parameter, but tries to force usage of the specified scaler even if it might not fit.<br />
<br />
;<code>-version</code>: output version information and exit. (see stdout.txt) Useful for frontends.<br />
<br />
;<code>-editconf program</code>: calls program with as first parameter the configuration file. You can specify this command more than once. In this case it will move to second program if the first one fails to start.<br />
<br />
;<code>-opencaptures program</code>: calls program with as first parameter the location of the captures folder.<br />
<br />
;<code>-printconf</code>: prints the location of the default configuration file.<br />
<br />
;<code>-resetconf</code>: removes the default configuration file.<br />
<br />
;<code>-resetmapper</code>: removes the mapperfile used by the default clean configuration file.<br />
<br />
;<code>-socket</code>: passes the socket number to the nullmodem emulation.<br />
<br />
===Notes===<br />
*If a <code>name/ command/ configfilelocation/ languagefilelocation</code> contains a space in it, put the whole <code>name/ command/ configfilelocation/ languagefilelocation</code> between quotes ("example").<br />
*In Windows you can also drag directories/files onto the DOSBox executable.<br />
<br />
<br />
===Example===<br />
dosbox c:\atlantis\atlantis.exe -c "MOUNT D C:\SAVES"<br />
<br />
This would mount <code>c:\atlantis</code> as <code>c:\</code> and run <code>atlantis.exe</code>. Before it does that, it would first mount <code>C:\SAVES</code> as the D drive.</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Main_Page&diff=134596Main Page2015-06-08T23:27:57Z<p>Beresford: /* More Specific Topics */ updated the description on the usage link</p>
<hr />
<div>'''<br />
=Welcome to the Wiki page of the DOSBox project=<br />
<br />
'''DOSBox''' emulates an Intel x86 PC, complete with [[Sound|sound]], [[Display|graphics]], [[Input|mouse]], [[Input|joystick]], [[Connectivity|modem]], etc., necessary for running many old MS-DOS [[GAMES|games]] that simply cannot be run on modern PCs and operating systems, such as Microsoft Windows XP, Windows Vista, Linux and FreeBSD. However, it is not restricted to running only games. In theory, any MS-DOS or PC-DOS (referred to commonly as "DOS") [[Software|application]] should run in DOSBox, but the emphasis has been on getting DOS [[GAMES|games]] to run smoothly, which means that communication, networking and printer support are still in early development.<br />
<br />
DOSBox also comes with its own [[Command Line|DOS-like command prompt]]. It is still quite rudimentary and lacks many of the features found in MS-DOS, but it is sufficient for installing and running most DOS [[GAMES|games]].<br />
<br />
DOSBox has a lively, user-supported [http://vogons.org community forum] hosted at VOGONS (Very Old Games On New Systems). Feel very very free to drop by if you have questions about DOSBox!<br />
<br />
==General Information==<br />
*[[Releases|Downloading DOSBox]]<br />
*[[System Requirements]]<br />
*[[DOSBox_FAQ|Frequently Asked Questions]] (FAQ)<br />
*Guides<br />
**Basic Setup and Installation of DOSBox<br />
***[[DOSBox and Windows Vista|Vista Specific Issues]]<br />
***[[DOSBox and Mac OSX|Mac OSX Specific Issues]]<br />
***[[Mac OSX Advanced]]<br />
***[[Recording Video]]<br />
**[[Contributing to this Wiki]]<br />
**[[GAMES|Games]] that DOSBox can (or can't) run<br />
**[[Software]] applications that DOSBox can (or can't) run<br />
**[[TOOLS|Tools]] that can assist either playing games or using DOSBox generally<br />
**[[DOSBoxFrontends|Frontends]] - simplifies running and understanding DOSBox.<br />
**[[Performance|Running Resource Demanding Games]]<br />
*[[Special Thanks]]<br />
*[[Contact]]<br />
<br />
==More Specific Topics==<br />
*[[Usage| Command Line Options]]<br />
*[[ZDrive|Z:\> Prompt]]<br />
*[[Commands|Command Line Utilities]]<br />
*[[Utilities|Internal Programs]]<br />
**[[MOUNT|Mounting your CD-ROM in DOSBox]]<br />
*[[Special Keys]]<br />
*[[dosbox.conf|The Configuration File]] (dosbox.conf)<br />
**[[Associating the Configuration File in Windows]]<br />
*[[Language File|The Language File]]<br />
*[[Keymapper|The Keymapper]]<br />
*[[Ubuntu Configuration|Ubuntu Configuration]]<br />
*[[DOSBoxShortcuts|DOSBox Shortcuts]]<br />
*[[GOG_games_that_use_DOSBox|GOG Games that use DOSBox]] - An overview<br />
<br />
==DOSBox Resources==<br />
*[http://dosbox.cvs.sourceforge.net/dosbox/dosbox/README?view=markup DOSBox README File]<br />
*[http://dosbox.com/comp_list.php List of Games and Applications] (and how to install and run them)<br />
*[http://vogons.org DOSBox community forum]<br />
*[http://dosbox.sourceforge.net/oldwiki/ The original DOSBox Wiki]<br />
<br />
==Advanced Topics==<br />
*[[BuildingDOSBox|Building DOSBox]] - Building your own version of DOSBox using mingw<br />
*[[Building_DOSBox_with_Visual_C_2008_Express|Building DOSBox with Visual C 2008 Express]]<br />
*[https://wiki.libsdl.org/FAQUsingSDL Using SDL FAQ] (SDL environment variables that can make or break things)<br />
*[[Special:Allpages|Index of all articles]]</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Main_Page&diff=134595Main Page2015-06-08T23:03:26Z<p>Beresford: /* General Information */ removed basic setup and installation inter wiki link</p>
<hr />
<div>'''<br />
=Welcome to the Wiki page of the DOSBox project=<br />
<br />
'''DOSBox''' emulates an Intel x86 PC, complete with [[Sound|sound]], [[Display|graphics]], [[Input|mouse]], [[Input|joystick]], [[Connectivity|modem]], etc., necessary for running many old MS-DOS [[GAMES|games]] that simply cannot be run on modern PCs and operating systems, such as Microsoft Windows XP, Windows Vista, Linux and FreeBSD. However, it is not restricted to running only games. In theory, any MS-DOS or PC-DOS (referred to commonly as "DOS") [[Software|application]] should run in DOSBox, but the emphasis has been on getting DOS [[GAMES|games]] to run smoothly, which means that communication, networking and printer support are still in early development.<br />
<br />
DOSBox also comes with its own [[Command Line|DOS-like command prompt]]. It is still quite rudimentary and lacks many of the features found in MS-DOS, but it is sufficient for installing and running most DOS [[GAMES|games]].<br />
<br />
DOSBox has a lively, user-supported [http://vogons.org community forum] hosted at VOGONS (Very Old Games On New Systems). Feel very very free to drop by if you have questions about DOSBox!<br />
<br />
==General Information==<br />
*[[Releases|Downloading DOSBox]]<br />
*[[System Requirements]]<br />
*[[DOSBox_FAQ|Frequently Asked Questions]] (FAQ)<br />
*Guides<br />
**Basic Setup and Installation of DOSBox<br />
***[[DOSBox and Windows Vista|Vista Specific Issues]]<br />
***[[DOSBox and Mac OSX|Mac OSX Specific Issues]]<br />
***[[Mac OSX Advanced]]<br />
***[[Recording Video]]<br />
**[[Contributing to this Wiki]]<br />
**[[GAMES|Games]] that DOSBox can (or can't) run<br />
**[[Software]] applications that DOSBox can (or can't) run<br />
**[[TOOLS|Tools]] that can assist either playing games or using DOSBox generally<br />
**[[DOSBoxFrontends|Frontends]] - simplifies running and understanding DOSBox.<br />
**[[Performance|Running Resource Demanding Games]]<br />
*[[Special Thanks]]<br />
*[[Contact]]<br />
<br />
==More Specific Topics==<br />
*[[Usage]]<br />
*[[ZDrive|Z:\> Prompt]]<br />
*[[Commands|Command Line Utilities]]<br />
*[[Utilities|Internal Programs]]<br />
**[[MOUNT|Mounting your CD-ROM in DOSBox]]<br />
*[[Special Keys]]<br />
*[[dosbox.conf|The Configuration File]] (dosbox.conf)<br />
**[[Associating the Configuration File in Windows]]<br />
*[[Language File|The Language File]]<br />
*[[Keymapper|The Keymapper]]<br />
*[[Ubuntu Configuration|Ubuntu Configuration]]<br />
*[[DOSBoxShortcuts|DOSBox Shortcuts]]<br />
*[[GOG_games_that_use_DOSBox|GOG Games that use DOSBox]] - An overview<br />
<br />
==DOSBox Resources==<br />
*[http://dosbox.cvs.sourceforge.net/dosbox/dosbox/README?view=markup DOSBox README File]<br />
*[http://dosbox.com/comp_list.php List of Games and Applications] (and how to install and run them)<br />
*[http://vogons.org DOSBox community forum]<br />
*[http://dosbox.sourceforge.net/oldwiki/ The original DOSBox Wiki]<br />
<br />
==Advanced Topics==<br />
*[[BuildingDOSBox|Building DOSBox]] - Building your own version of DOSBox using mingw<br />
*[[Building_DOSBox_with_Visual_C_2008_Express|Building DOSBox with Visual C 2008 Express]]<br />
*[https://wiki.libsdl.org/FAQUsingSDL Using SDL FAQ] (SDL environment variables that can make or break things)<br />
*[[Special:Allpages|Index of all articles]]</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Contact&diff=134594Contact2015-06-08T22:11:55Z<p>Beresford: fixed forum url</p>
<hr />
<div>Use the [http://vogons.org forum] for questions.</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Main_Page&diff=134593Main Page2015-06-08T22:10:32Z<p>Beresford: /* General Information */ minor case correction</p>
<hr />
<div>'''<br />
=Welcome to the Wiki page of the DOSBox project=<br />
<br />
'''DOSBox''' emulates an Intel x86 PC, complete with [[Sound|sound]], [[Display|graphics]], [[Input|mouse]], [[Input|joystick]], [[Connectivity|modem]], etc., necessary for running many old MS-DOS [[GAMES|games]] that simply cannot be run on modern PCs and operating systems, such as Microsoft Windows XP, Windows Vista, Linux and FreeBSD. However, it is not restricted to running only games. In theory, any MS-DOS or PC-DOS (referred to commonly as "DOS") [[Software|application]] should run in DOSBox, but the emphasis has been on getting DOS [[GAMES|games]] to run smoothly, which means that communication, networking and printer support are still in early development.<br />
<br />
DOSBox also comes with its own [[Command Line|DOS-like command prompt]]. It is still quite rudimentary and lacks many of the features found in MS-DOS, but it is sufficient for installing and running most DOS [[GAMES|games]].<br />
<br />
DOSBox has a lively, user-supported [http://vogons.org community forum] hosted at VOGONS (Very Old Games On New Systems). Feel very very free to drop by if you have questions about DOSBox!<br />
<br />
==General Information==<br />
*[[Releases|Downloading DOSBox]]<br />
*[[System Requirements]]<br />
*[[DOSBox_FAQ|Frequently Asked Questions]] (FAQ)<br />
*Guides<br />
**[[Basic Setup and Installation of DOSBox]]<br />
***[[DOSBox and Windows Vista|Vista Specific Issues]]<br />
***[[DOSBox and Mac OSX|Mac OSX Specific Issues]]<br />
***[[Mac OSX Advanced]]<br />
***[[Recording Video]]<br />
**[[Contributing to this Wiki]]<br />
**[[GAMES|Games]] that DOSBox can (or can't) run<br />
**[[Software]] applications that DOSBox can (or can't) run<br />
**[[TOOLS|Tools]] that can assist either playing games or using DOSBox generally<br />
**[[DOSBoxFrontends|Frontends]] - simplifies running and understanding DOSBox.<br />
**[[Performance|Running Resource Demanding Games]]<br />
*[[Special Thanks]]<br />
*[[Contact]]<br />
<br />
==More Specific Topics==<br />
*[[Usage]]<br />
*[[ZDrive|Z:\> Prompt]]<br />
*[[Commands|Command Line Utilities]]<br />
*[[Utilities|Internal Programs]]<br />
**[[MOUNT|Mounting your CD-ROM in DOSBox]]<br />
*[[Special Keys]]<br />
*[[dosbox.conf|The Configuration File]] (dosbox.conf)<br />
**[[Associating the Configuration File in Windows]]<br />
*[[Language File|The Language File]]<br />
*[[Keymapper|The Keymapper]]<br />
*[[Ubuntu Configuration|Ubuntu Configuration]]<br />
*[[DOSBoxShortcuts|DOSBox Shortcuts]]<br />
*[[GOG_games_that_use_DOSBox|GOG Games that use DOSBox]] - An overview<br />
<br />
==DOSBox Resources==<br />
*[http://dosbox.cvs.sourceforge.net/dosbox/dosbox/README?view=markup DOSBox README File]<br />
*[http://dosbox.com/comp_list.php List of Games and Applications] (and how to install and run them)<br />
*[http://vogons.org DOSBox community forum]<br />
*[http://dosbox.sourceforge.net/oldwiki/ The original DOSBox Wiki]<br />
<br />
==Advanced Topics==<br />
*[[BuildingDOSBox|Building DOSBox]] - Building your own version of DOSBox using mingw<br />
*[[Building_DOSBox_with_Visual_C_2008_Express|Building DOSBox with Visual C 2008 Express]]<br />
*[https://wiki.libsdl.org/FAQUsingSDL Using SDL FAQ] (SDL environment variables that can make or break things)<br />
*[[Special:Allpages|Index of all articles]]</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Configuration:SDL&diff=134592Configuration:SDL2015-06-08T22:09:24Z<p>Beresford: fixed urls, spelling mistakes, and settings that are no longer current</p>
<hr />
<div>This section contains all of the low level system settings for how DOSBox interacts with your real hardware. You can define what resolutions are emulated, how DOSBox should treat errors or listen to your keyboard and mouse. You can often achieve a fair level of optimization by working with these setting, though for the most part leaving them at their default settings will create the best experience. These settings are passed on to the SDL Library which handles low level things like input and thread priority.<br />
<br />
;fullscreen = true | false<br />
:Start DOSBox directly in fullscreen.<br />
:Default is false.<br />
<br />
;fulldouble = true | false<br />
:Use double buffering in fullscreen. See [http://en.wikipedia.org/wiki/Multiple_buffering]<br />
:Default is false.<br />
<br />
;fullresolution = ''width'' x ''height'' | original | desktop<br />
:Scale the application to this size IF the output device supports hardware scaling (i.e. any output other than surface). Original is the game's default or chosen (through setup.exe or in-game menu) resolution. If original resolution is less than desktop resolution, DOSBox will switch the screen resolution to the closest match requested by the game or application. For example, if a game in DOSBox is requesting a graphics screen resolution of (320 x 240) while your desktop is (1920 x 1200), DosBox will switch to (320x240) or the next highest resolution supported by your GPU drivers, e.g. (800 x 600) if the former is not available. Many games will be below the minimum resolution supported by modern video cards, so DOSBox will scale the game up to at least that minimum. Note: the scaler setting under [render] is also able to scale up the original resolution to some degree. Those changes are performed before any additional scaling done with fullresolution setting.<br />
:Default is original.<br />
<br />
;windowresolution = ''width'' x ''height'' | original | desktop<br />
:Scale the window to this size IF the output device supports hardware scaling (i.e. any output other than surface). Original is the game's default or chosen (through setup.exe or in-game menu) resolution. Note: the scaler setting under [render] is also able to scale up the original resolution to some degree. Those changes are performed before any scaling done with windowresolution setting.<br />
:Default is original.<br />
<br />
;output = surface | overlay | opengl | openglnb | ddraw<br />
:What to use for output. Surface does not support scaling or aspect correction. More information here: [http://www.vogons.org/viewtopic.php?=&p=102291]<br />
:Default is surface.<br />
<br />
;autolock = true | false<br />
:Mouse will automatically lock, if you click on the screen.<br />
:Default is true.<br />
<br />
;sensitivity = 1..1000<br />
:Mouse sensitivity.<br />
:Default is 100.<br />
<br />
;waitonerror = true | false<br />
:Wait before closing the console if DOSBox has an error.<br />
:Default is true.<br />
<br />
;priority = ''when-focused'',''when-minimzed''<br />
:Priority levels for DOSBox. Second entry behind the comma is for when DOSBox is not focused/minimized. Valid priorities are: lowest, lower, normal, higher, highest, and pause.<br />
:Default is higher,normal.<br />
<br />
;mapperfile = ''path-to-mapper-file''<br />
:File used to load/save the key/event mappings from.<br />
:Default is mapper-<version>.txt.<br />
<br />
;usescancodes = true | false<br />
:Avoid usage of symkeys, might not work on all operating systems.<br />
:Default is true.</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Basic_Setup_and_Installation_of_DosBox&diff=134591Basic Setup and Installation of DosBox2015-06-08T21:50:38Z<p>Beresford: /* Alternate methods for running a game */ fixed url of vogons</p>
<hr />
<div>== Basic Concepts ==<br />
<br />
DOSBox is an emulator that recreates a MS-DOS compatible environment (complete with Sound, Input, Graphics and even basic networking). This environment is complete enough to run many classic MS-DOS games completely unmodified. In order to utilize all of DOSBox's features you need to first understand some basic concepts about the MS-DOS environment.<br />
<br />
* [[MOUNT|Mount a Drive]]<br />
* [[Drives]]<br />
* [[Sound]]<br />
* [[Display]]<br />
* [[Input]]<br />
* [[Connectivity]] (Modems/Networking)<br />
<br />
== Installation ==<br />
<br />
The first step is to install DOSBox. This guide will use the [[Version0.74|0.74]] Windows 32-bit version which is available for [http://www.dosbox.com/download.php?main=1 download]. Download the [[Releases|release]] for your operating system. If you are a Windows user, get the '''Win32 installer'''.<br />
<br />
After downloading, install DOSBox to any directory. Also, make a folder to put all your old games in. I put DOSBox in '''<tt>C:\DOSBox</tt>''', and my old games directory is '''<tt>C:\OLDGAMES</tt>'''. I put a game in my '''<tt>OLDGAMES</tt>''' directory, '''<tt>TESTDRIV</tt>''', which is [[GAMES:TestDrive|Test Drive]], an old racing game. Your directories should look like this:<br />
<br />
[[Image:DOSBox-Folders.jpg]]<br />
<br />
== Running a game ==<br />
<br />
Now, the hardest part, getting games to run. First, run '''dosbox.exe''' in your DOSBox folder. Remember that '''<tt>OLDGAMES</tt>''' directory you created in Step 1? You have to basically set that as new directory just for DOSBox. Essentially, it's going to become the '''[[CDrive|C:\>]]''' drive of DOSBox. So, type:<br />
Z:\>'''MOUNT C C:\OLDGAMES'''<br />
Drive C mounted as local directory C:\OLDGAMES\<br />
<br />
To dissect the above:<br />
*'''[[MOUNT]]''': Tells the program to [[MOUNT|mount]] a directory<br />
*'''C''': Tells the program what you want your new drive to be called (leaving it as C: is fine)<br />
*'''C:\OLDGAMES''': This is the directory I want to set as the new drive for DOSBox, because all my games are in it. If you created a different directory, write in the directory you created.<br />
<br />
''(Note: If you want to [[MOUNT|mount]] a CD-ROM instead of a folder, type this:''<br />
Z:\>'''MOUNT D D:\ -t cdrom'''<br />
MSCDEX installed.<br />
Drive D is mounted as CDRom D:\<br />
<br />
''(Note: '''"cdrom"''' is case sensitive and must be lowercase!)''<br />
<br />
In this example, '''D:\ -T cdrom''' tells DOSBox that my D:\ drive is a CD-ROM drive, and the first '''D''', tells DOSBox what my new drive name should be called. If you are running your game off a CD-ROM then make sure to use '''D:''' in place of '''C:''' in the following examples. You can find instructions on how to [[MOUNT|mount]] other devices, such as floppy drives, in the [[MOUNT|mount]] section).''<br />
<br />
After you've done this, you will be prompted with a '''[[ZDrive|Z:\>]]'''. Now, just write what you wanted to call your new DOSBox drive, which as I said above, we called '''C'''. To navigate to that newly mounted drive just type in:<br />
<br />
Z:\>'''C:'''<br />
<br />
C:\><br />
<br />
Hopefully, you're all set! Now, it's time to run the game. Previously I had mentioned a game called '''<tt>TESTDRIV</tt>''' in my '''<tt>OLDGAMES</tt>''' folder. I now want DOSBox to go to that folder. So type in:<br />
<br />
C:\>'''CD TESTDRIV'''<br />
<br />
C:\TESTDRIV><br />
<br />
That's it! [[Commands#CD|CD]] stands for "Change Directory", so you've changed the directory to TESTDRIV. You can find instructions on how to use the [[Commands#CD|Change Directory]] command, in the [[Commands#CD|CD]] section of the [[Commands]] article.<br />
<br />
One more step, running the game! Most games have an EXE file in their directory that you can run. However, some might require a BAT file, or COM file (common in demos and really old games). Most of the time, the file is in the root folder. Please consult the documentation of your game for which file is needed to start the game. In the case of [[GAMES:TestDrive|Test Drive]], it's '''TDCGA.EXE'''. So now, I just type this:<br />
<br />
C:\TESTDRIV>'''TDCGA.EXE'''<br />
<br />
That's it! Here's a picture of all of the commands I've written about in Step 2: <br />
<br />
[[Image:Dosbox2.jpg]]<br />
<br />
== Alternate methods for running a game ==<br />
<br />
The steps described above are closely aligned with how DOS Based operating systems behave natively. However modern operating system allow for more user friendly (although less authentic) ways of playing your favorite games. If the steps above seem tedious or confusing you can try some of these other guides. In most cases these guides will still require you to setup a working DOSBox environment.<br />
<br />
*[[DOSBoxFrontends|Using Frontends]]<br />
*[[DOSBoxShortcuts|Creating desktop shortcuts]]<br />
**[[DOSBoxShortcuts#Windows|in Microsoft Windows]]<br />
**[[DOSBoxShortcuts#OSX|in Apple OSX]]<br />
**[[DOSBoxShortcuts#GNOME|in Linux GNOME]]<br />
<br />
NOTE: If you have problems with launching the game, unrecognizable errors being spit out, saving settings, or having the game drop out while running it, one thing to try is to make sure all the files are not set to Read Only. In Windows, select the folder of the game, right click and hit properties, uncheck '''Read Only''' if it is checked, and apply to all sub folders.<br />
<br />
If you have other errors, please search the [http://vogons.org forums] first before posting a question.<br />
<br />
== Performance ==<br />
Yay, you've gotten your game to run! But maybe you're experiencing slowdown? How do you fix this? With the following commands:<br />
<br />
'''<tt>CTRL+F7</tt>''' = Decreases frameskip<br/><br />
'''<tt>CTRL+F8</tt>''' = Increases Frameskip<br/><br />
'''<tt>CTRL+F11</tt>''' = Slows down the game<br/><br />
'''<tt>CTRL+F12</tt>''' = Speeds up the game<br/><br />
<br />
Press '''<tt>CTRL+ALT+DEL</tt>''' to open the Task Manager, and click the Performance tab. Start by pressing '''<tt>CTRL+F12</tt>''' until your CPU Usage level begins to go above 95%. After that, if you still need a performance boost, hit '''<tt>CTRL+F8</tt>''' to have DOSBox not render some frames. The console window will display all of the changes you've made, and the top of the game window will display the current settings. Adjust these settings as needed until your game goes smoothly. '''''Please keep in mind that not all games will run smoothly on DOSBox.'''''<br />
<br />
[[Image:Dosbox3.jpg]]<br />
<br />
== Other Useful features ==<br />
<br />
=== Quick start ===<br />
<br />
You can save yourself some time by having DOSBox automatically [[MOUNT]] your folders and change the drive to '''C:'''. In original DOS based operating systems a file called '''<tt>[[AUTOEXEC|AUTOEXEC.BAT]]</tt>''' contained any commands that the user wanted executed every time the computer booted up. This functionality is simulated by the [[dosbox.conf#.5Bautoexec.5D|[autoexec]]] section of the [[dosbox.conf]] file. <br />
<br />
For DOSBox versions older than 0.73 browse into program installation folder and open the [[dosbox.conf]] file in any text editor. For version 0.73 go to Start Menu and click on "Configuration" and then "Edit Configuration". Then scroll down to the very end, and add these lines:<br />
<br />
<code><pre>MOUNT C C:\OLDGAMES<br />
C:</pre></code><br />
<br />
Now those commands will be executed automatically when starting! If you're having trouble with that, make sure it looks like this (look at the bottom): <br />
<br />
[[Image:Dosbox4.jpg]]<br />
<br />
=== Full Screen ===<br />
<br />
Just press '''<tt>ALT+ENTER</tt>''' to go into and out of full screen.<br />
<br />
Alternatively, you can open the [[dosbox.conf]] file as mentioned above and change "fullscreen=false" to "fullscreen=true". DOSBox will then run in full screen mode when you open it.</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=SVN_Builds&diff=134590SVN Builds2015-06-08T21:45:33Z<p>Beresford: /* Enhanced SVN builds */ fixed urls for DOSBox-X and Daum</p>
<hr />
<div>This article is a discussion of the general purpose of DOSBox SVN builds, and a list of which known public ones exist and where to get them. The first part is a FAQ covering various questions regarding DOSBox SVN builds; it is followed by a listing, description of and links to known SVN builds, as well as a selection of useful related links. <br />
<br />
==SVN Builds FAQ==<br />
<br />
===What are SVN builds?===<br />
SVN builds are versions of DOSBox that people have built from the latest version of the DOSBox source code, which is stored on [http://www.sourceforge.net/ sourceforge.net] in something called an SVN repository. SVN builds contain changes that have been made by the DOSBox developers since the latest official release. Some enhanced SVN builds also contain unofficial features and fixes that have been created by enthusiasts in the DOSBox development community.<br />
<br />
===Why should I use an SVN build?===<br />
Every so often a new official version of DOSBox is released. Active development continues between releases, however, with new features and fixes continuously added to DOSBox's SVN repository that eventually result in the next release. At the time of this writing, the last official release is several years old, and is therefore missing a significant amount of work performed by the developers. If you're having trouble running a game with the current DOSBox release, it's worth trying an SVN build to see if the problem has been addressed since then. You may also want access to the new features or optimizations if you are having compatibility or performance issues.<br />
<br />
===Which one should I use?===<br />
That's up to you. Consult the list below to see which features the different builds contain and decide which one you want to try first. If you are interested in trying an SVN build in hopes that it will fix a problem you're having in the latest release version, you should probably start with a "plain" (no-enhancements) SVN build. Also, see replies to this post from the maintainers for additional info on their builds.<br />
<br />
===How do I use it?===<br />
Some SVN builds come packaged as a fully-functional DOSBox distribution, so you can simply unpack the archive into an empty folder and run it. Other builds contain only a custom dosbox executable binary (e.g. dosbox.exe) and possibly some supporting libraries, and require that you first install the latest official release of DOSBox and then unpack the SVN build over the top of it - replacing the release versions of the files with the SVN versions. Some developers also recommend regenerating your dosbox.conf configuration file so that you will see any new config options that have been added. Consult [http://www.vogons.org/viewtopic.php?p=68701#68701 this forum thread] for info on how to regenerate a config file.<br />
<br />
===What do I do if I find bugs in an SVN build?===<br />
First, search the DOSBox community forums to see if it's already been reported. If it hasn't, post as much information as possible (see the [http://www.vogons.org/viewtopic.php?t=2949 help request guidelines]). ''Update:'' Note that bugs in plain SVN builds are probably the only ones of interest to the DOSBox developers. Problem reports for the other builds should be addressed to their respective maintainers, as problems could be caused by experimental patches that aren't part of the official SVN source code.<br />
<br />
===Where can I go to talk about SVN builds? (forum thread)===<br />
Please feel free to discuss SVN build-related topics in the [http://www.vogons.org/viewtopic.php?t=9306 forum thread] where this article originally started.<br />
<br />
==List of SVN Builds==<br />
<br />
===Plain/vanilla/clean SVN builds===<br />
The following SVN builds are based directly off of the official DOSBox SVN source code. Use these builds to test the latest official SVN changes:<br />
<br />
* '''EmuCR''' for Windows<br />
** URL: http://www.emucr.com/search/label/DOSBox<br />
** Notes: Updated daily, although there are reports that it may lag behind if multiple changes are checked in by the DOSBox developers on the same day followed by no changes for some time after.<br />
** Compiled '''without''' screenshot, video recording and IPX support.<br />
<br />
* '''Dominus''' for OS X 10.4 - 10.7 (ppc/intel)<br />
** URL: http://dl.dropbox.com/u/7737184/Dosbox/Dosbox-Snapshot.dmg<br />
** Notes: Automatically updated on changes to SVN.<br />
<br />
===Enhanced SVN builds===<br />
The following SVN builds contain additional fixes and/or features that are not officially part of DOSBox. Many people prefer them due to the included extra features that are not included in in the SVN. Note that if you have problems with these builds, it may be due to the unofficial changes that have been made by their maintainers and not the official DOSBox code itself that is to blame:<br />
<br />
* '''DOSBox with Long File Name (LFN) and mouse copy/past support''' by Wengier<br />
** Last updated: 2014-10-26<br />
** SVN base version: r3871<br />
** URL: http://www.vogons.org/viewtopic.php?t=40610 (discussion + source + Windows binary)<br />
** URL: http://www.vogons.org/viewtopic.php?t=41179 (discussion + source + Windows binary)<br />
** URL: http://bit.ly/12jANWF (latest Windows binary + required DLLs, zipped)<br />
** Description: This is a build of DOSBox based on its SVN version that adds Long File Name (LFN) and mouse copy/past support. With this both the DOSBox shell commands and many native LFN-aware DOS programs should now be able to use LFN in DOSBox, and users can also use the right mouse button to select, copy and paste text from and to DOSBox (when the mouse is not locked). Windows binaries are provided, but sources should work on other platforms too (pdcurses is required for the cross-platform clipboard copy/paste feature).<br />
<br />
* '''DOSBox SVN Daum''' by ykhwong for Windows, OSX, and Linux<br />
** Last updated: 2015-01-25<br />
** SVN base version: r3894<br />
** URL: http://ykhwong.x-y.net/ (Windows binary, Linux x86 source)<br />
** URL: http://cafe.daum.net/dosbox<br />
** Description: The Windows build incorporates Direct3D with pixelshaders, OpenglHQ, Innovation, Glide, zip/7z mount, Beep, NE2000 Ethernet, Graphis user interface (menu), Save/Load states, Vertical sync, CPU flags optimization, Various DOS commands (PROMPT, VOL, LABEL, MOUSE, etc) and CONFIG.SYS commands (DEVICE, BUFFERS, FILES, etc), Continuous turbo key, Core-switch key, Show details (from menu bar), Nice DOSBox icon, Font patch (cp437), MAKEIMG command, INTRO, Ctrl-break patch, DBCS support patch, Automatic mount, Printer output, MT-32 emulation (MUNT), MP3CUE, Overscan border, Stereo-swap, SDL_Resize, MemSize128, Internal 3dfx voodoo chip emulation, etc. Recent versions include DOSBox-X branch changes as well.<br />
<br />
* '''dosbox-patched''' for Ubuntu Linux (Oneiric and newer)<br />
** Last updated: 2014-01-12<br />
** SVN base version: ?<br />
** URL: https://code.launchpad.net/~i30817/+archive/dosbox-patched<br />
** Description: "Daily build of dosbox trunk with mt32 patch (roms go into ~/.dosbox)". Automatically-built PPA packages built from DOSBox SVN trunk with Munt MT-32 emulation patch.<br />
<br />
* '''DOSBox-X''' by TheGreatCodeholio<br />
** Last updated: It is constantly updated<br />
** URL: http://www.vogons.org/viewtopic.php?t=31881 (discussion + links)<br />
** URL: https://github.com/joncampbell123/dosbox-x/releases<br />
** Description: "This is a branch of DOSBox 0.74 that I have been working on and off for the past 8 months. I've been modifying a lot in the source to make the emulation more accurate, to fix other parts of the emulation, and to widen the kind of hardware DOSBox emulates. I call it "DOSBox-x" for lack of a better name."<br />
<br />
===Obsolete SVN/CVS builds===<br />
These builds appear to be no longer maintained, and are listed here for historical reference.<br />
<br />
* '''"Mega Build" series (by H-A-L-9000)'''<br />
** Last updated: 2010-11-18<br />
** SVN base version: r3661<br />
** URL: http://home.arcor.de/h-a-l-9000/ (Windows binary, Linux source, Intel Mac OS X port by thedoctor45)<br />
** URL: http://www.vogons.org/viewtopic.php?t=26170 to discuss the Mac port<br />
** Description: Builds of DOSBox focused on serial/networking support. Contains the NE2000 patch, parallel port passthrough and file forwarding, virtual printer, SVGA enhacements, OPL passthrough, and others. The Windows installer contains the debug-enabled build as option.<br />
<br />
* '''"UBER BUILD" (by Virusek)'''<br />
** Last Updated: 2010-07-23<br />
** SVN base version: r3623<br />
** URL: http://www.vogons.org/viewtopic.php?p=193022#193022 (Windows binary, source)<br />
** Description: All patches from gulikoza's build (coreswitch, direct3d, glide, mt32, openglhq, physfs, NE2000, printer and oplpassthrough). Updated Glide patch by gulikoza to 24.11.2009. SDL_sound support. Some other small fixes (mostly VS2010 compatibility fixes).<br />
<br />
* '''Zirias'''<br />
** Last Updated: 2010-05-12<br />
** URL: http://www.vogons.org/viewtopic.php?p=186679#186679 (Debian i386 + amd64 binary & source packages)<br />
** Description: Debian Linux APT packaged version of DOSBox with Glide support.<br />
<br />
* '''Tharos (by XTale)'''<br />
** Last updated: 2010-03-28<br />
** <s>URL: http://builds.tharos-online.de/index.php?dir=&sort=date&order=desc</s><br />
** Notes: '''Daily builds seem to have stopped as of 3/28/10.'''<br />
<br />
* '''gulikoza'''<br />
** Last Updated: 2009-07-09<br />
** URL: http://www.si-gamer.net/gulikoza/ (Windows binary, source)<br />
** Description: Build of DOSBox focused on GLIDE support.<br />
<br />
* '''DOSBox for Mac OSX (by rhoenie/Marcus Herbert)'''<br />
** Last updated: 2008-08-09<br />
** URL: http://www.spam-filter.de/bastelstunde#dosbox<br />
** Description: DosBox 0.72 for G3 & DosBox CVS for OSX (G4/G5/i386)<br />
<br />
* '''DOSBox CVS for Linux (by Moe)'''<br />
** Last updated: 2006-12-15<br />
** <s>URL: http://garni.ch/dosbox/</s><br />
** Description: Recently Moe has decided to provide a DOSBox Linux (x86, 32-bit, Athlon64-optimized) binary including some useful patches. It is built against latest CVS and includes at least these patches: addkey, adlib optimize, Innovation SSI-2001, Self-Modifying-Code optimizations, SVGA chipsets, CD-Image cycling, Glide emulation, Printer emulation.<br />
** Notes: Moe is also the creator of OPENGL-HQ. OPENGL-HQ is another scaler that is implemented in SDL.dll. Unfortunately it may be some time (or never), until OPENGL-HQ is implemented in the official SDL so until then you'll have to download it from here (or compile it yourself). Neat thing about this is that you can use this SDL.DLL with any SDL program (e.g. DOSBox, SCUMMVM...).<br />
<br />
* '''DOSBox with MT-32 emulation (by Canadacow)'''<br />
** Last updated: 2004-10-15<br />
** <s>URL: http://www.artworxinn.com/alex/downloads.htm</s><br />
** Description: ''This build is no longer useful''; it was made before DOSBox 0.63 came out and contains MT-32 emulation code that is much older than the current Munt releases. Note that more current MT-32 emulation is also included as an unofficial feature of some of the newer SVN builds.<br />
<br />
==Useful Links==<br />
<br />
===SVN changelog===<br />
The following links list the latest changes to the official DOSBox source code on its sourceforge.net SVN repository:<br />
* http://source.dosbox.com/dosboxsvn.txt (auto-generated changelog provided by Qbix)<br />
* http://sourceforge.net/p/dosbox/code-0/3852/log/?path=/dosbox (sourceforge.net SVN log) - '''fixed on 2014-01-01'''<br />
<br />
===SVN build news===<br />
The following link(s) provide news related to DOSBox SVN builds:<br />
* http://www.emucr.com/search/label/DOSBox (EmuCR posts with DOSBox tag, which includes news regarding DOSBox SVN builds, frontends and other DOSBox ports)<br />
<br />
===Debugger-enabled builds===<br />
Qbix has a thread on the DOSBox forum containing links to some special DOSBox builds that have a built-in debugger:<br />
* http://www.vogons.org/viewtopic.php?t=7323<br />
<br />
===Making your own SVN build===<br />
The following DOSBoxWiki article discusses the process of making your own SVN build from the official DOSBox SVN source code:<br />
* [[BuildingDOSBox]]<br />
<br />
===Snapshot of latest DOSBox SVN source code===<br />
Snapshots of the latest SVN versions of the DOSBox source code are available at the following URL(s) :<br />
* http://source.dosbox.com/dosboxsvn.tgz (auto-generated tarball provided by Qbix)<br />
* http://dosbox.svn.sourceforge.net/viewvc/dosbox/dosbox/trunk/?view=tar (auto-generated tarball created by sourceforge.net)<br />
* http://sourceforge.net/scm/?type=svn&group_id=52551 (sourceforge.net instructions for accessing official DOSBox SVN repository)<br />
* http://dosbox.svn.sourceforge.net/viewvc/dosbox/dosbox/trunk/ (sourceforge.net SVN browser for official DOSBox SVN repository)<br />
<br />
==Unofficial ports==<br />
These builds are for other Operating Systems and hardware platforms and are not in any way supported by the DOSBox team.<br />
<br />
===Android===<br />
* '''AnDOSBox''' (ver. 0.74, v1.2.7, 2012-06)<br />
** URL: http://sites.google.com/site/andosbox/<br />
<br />
* '''DosBox Turbo''' (ver. 0.74 SVN, v1.5.0, 2012-09-28)<br />
** URL: http://sites.google.com/site/dosboxturbo/<br />
<br />
* '''aDOSBox''' (ver. 0.73, v0.2.5, 2011-05)<br />
** URL: http://androiddosbox.appspot.com<br />
<br />
===iOS===<br />
* '''DOSPad''' (ver. 0.74, v1.96, 2011-01)<br />
** URL: http://www.litchie.com/?page_id=123<br />
<br />
===PSP===<br />
* '''DOSBox PSP''' (ver. 0.71, 2008-08-03)<br />
** <s>URL: http://www.qj.net/tag/crazyc-gaming-news.html</s><br />
** URL: http://www.pspdosbox.co.uk<br />
** <s>URL: http://forums.ps2dev.org/viewtopic.php?t=9564</s><br />
<br />
===Pocket PC / Windows Mobile===<br />
* '''DosBox PPC''' (ver. 0.73, 2009-07-06)<br />
** URL: http://n0p.8bit.fm<br />
<br />
===Wii===<br />
* '''DOSBox for Wii''' (ver. 0.74, v1.7, 2012-06-30)<br />
** URL: http://code.google.com/p/dosbox-wii/<br />
<br />
===Dreamcast===<br />
* '''DOSBox for Dreamcast''' (ver. 0.60, 2005?)<br />
** URL: http://gpf.dcemu.co.uk/dcdoxbox.shtml<br />
<br />
===GP2x===<br />
* '''DOSBox for GP2x''' (ver. 0.72, 2009-01-03)<br />
** URL: http://dl.openhandhelds.org/cgi-bin/gp2x.cgi?0,0,0,0,72,2534<br />
** <s>URL: http://wiki.gp2x.org/wiki/DosBox</s><br />
<br />
* '''DOSBox for GP2x Wiz''' (ver. 0.72, 2009-08-27)<br />
** URL: http://dl.openhandhelds.org/cgi-bin/wiz.cgi?0,0,0,0,72,198<br />
<br />
* '''DOSBox for GP2x Caanoo''' (ver. 0.74, 2012-01-14)<br />
** URL: http://dl.openhandhelds.org/cgi-bin/caanoo.cgi?0,0,0,0,72,826<br />
<br />
===Dingoo A320===<br />
* '''DOSBox for Dingoo A320''' (ver. 0.73, 2010-04-26)<br />
** URL: http://www.slaanesh.net/2010/04/dosbox-073-for-dingoo-a320-and-ben.html<br />
<br />
===OS/2===<br />
* '''DOSBox/2''' (ver. 0.74, 2010-09-17)<br />
** <s>URL: http://www.os2site.com/sw/emulators/dosbox/index.html<s/><br />
** URL: http://www.joschs-robotics.de/dosbox/<br />
** URL: http://wiki.netlabs.org/index.php/DOSBox_Port<br />
<br />
===AmigaOS 4.0===<br />
* '''DOSBox for AmigaOS 4.0''' (ver. 0.72, 2009-06-14)<br />
** URL: http://www.os4depot.net/share/emulation/computer/dosbox.lha<br />
** URL: http://www.os4depot.net/index.php?function=browse&cat=emulation/computer<br />
<br />
===Java===<br />
* '''jDosbox''' (ver. v0.74, v0.74.25, 2011-08-25)<br />
** URL: http://jdosbox.sourceforge.net<br />
<br />
===JavaScript===<br />
* '''JsDOSBox''' (ver. 0.74, 2012-07)<br />
** URL: http://sourceforge.net/projects/jsdosbox/<br />
<br />
===IRIX===<br />
* '''DOSBox for IRIX''' (ver. 0.71, 2007?)<br />
** URL: http://www.spam-filter.de/dosbox/dosbox_on_irix<br />
** <s>URL: http://www.enosnusnu.de/index.php?/archives/98-DOSBox-on-IRIX.html</s><br />
** Notes: Original enosnusnu.de link seems to now redirect to spam-filter.de. I added a link to a DOSBox on IRIX page on the latter site, but it appears that it may only offer a source code tarball and no binary.<br />
<br />
===PXA270===<br />
* '''DOSBox "Optimized" for PXA270 (by wellswang & kkazakov)''' (ver. 0.70, 2007-03-19)<br />
** <s>URL: http://www.oesf.org/forum/index.php?showtopic=18415&st=270&p=156742&#entry156742</s><br />
** URL: http://wells.osall.com/files/download.php?id=1727<br />
** URL: http://www.oesf.org/forums/index.php?s=1dec7dd003587d385fbec45efb1ffbaa&showtopic=18415&st=270&p=156742&#entry156742</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=SVN_Builds&diff=134589SVN Builds2015-06-08T21:38:17Z<p>Beresford: /* Plain/vanilla/clean SVN builds */ removed dates from the EmuCR builds, as per the notes, they are updated daily</p>
<hr />
<div>This article is a discussion of the general purpose of DOSBox SVN builds, and a list of which known public ones exist and where to get them. The first part is a FAQ covering various questions regarding DOSBox SVN builds; it is followed by a listing, description of and links to known SVN builds, as well as a selection of useful related links. <br />
<br />
==SVN Builds FAQ==<br />
<br />
===What are SVN builds?===<br />
SVN builds are versions of DOSBox that people have built from the latest version of the DOSBox source code, which is stored on [http://www.sourceforge.net/ sourceforge.net] in something called an SVN repository. SVN builds contain changes that have been made by the DOSBox developers since the latest official release. Some enhanced SVN builds also contain unofficial features and fixes that have been created by enthusiasts in the DOSBox development community.<br />
<br />
===Why should I use an SVN build?===<br />
Every so often a new official version of DOSBox is released. Active development continues between releases, however, with new features and fixes continuously added to DOSBox's SVN repository that eventually result in the next release. At the time of this writing, the last official release is several years old, and is therefore missing a significant amount of work performed by the developers. If you're having trouble running a game with the current DOSBox release, it's worth trying an SVN build to see if the problem has been addressed since then. You may also want access to the new features or optimizations if you are having compatibility or performance issues.<br />
<br />
===Which one should I use?===<br />
That's up to you. Consult the list below to see which features the different builds contain and decide which one you want to try first. If you are interested in trying an SVN build in hopes that it will fix a problem you're having in the latest release version, you should probably start with a "plain" (no-enhancements) SVN build. Also, see replies to this post from the maintainers for additional info on their builds.<br />
<br />
===How do I use it?===<br />
Some SVN builds come packaged as a fully-functional DOSBox distribution, so you can simply unpack the archive into an empty folder and run it. Other builds contain only a custom dosbox executable binary (e.g. dosbox.exe) and possibly some supporting libraries, and require that you first install the latest official release of DOSBox and then unpack the SVN build over the top of it - replacing the release versions of the files with the SVN versions. Some developers also recommend regenerating your dosbox.conf configuration file so that you will see any new config options that have been added. Consult [http://www.vogons.org/viewtopic.php?p=68701#68701 this forum thread] for info on how to regenerate a config file.<br />
<br />
===What do I do if I find bugs in an SVN build?===<br />
First, search the DOSBox community forums to see if it's already been reported. If it hasn't, post as much information as possible (see the [http://www.vogons.org/viewtopic.php?t=2949 help request guidelines]). ''Update:'' Note that bugs in plain SVN builds are probably the only ones of interest to the DOSBox developers. Problem reports for the other builds should be addressed to their respective maintainers, as problems could be caused by experimental patches that aren't part of the official SVN source code.<br />
<br />
===Where can I go to talk about SVN builds? (forum thread)===<br />
Please feel free to discuss SVN build-related topics in the [http://www.vogons.org/viewtopic.php?t=9306 forum thread] where this article originally started.<br />
<br />
==List of SVN Builds==<br />
<br />
===Plain/vanilla/clean SVN builds===<br />
The following SVN builds are based directly off of the official DOSBox SVN source code. Use these builds to test the latest official SVN changes:<br />
<br />
* '''EmuCR''' for Windows<br />
** URL: http://www.emucr.com/search/label/DOSBox<br />
** Notes: Updated daily, although there are reports that it may lag behind if multiple changes are checked in by the DOSBox developers on the same day followed by no changes for some time after.<br />
** Compiled '''without''' screenshot, video recording and IPX support.<br />
<br />
* '''Dominus''' for OS X 10.4 - 10.7 (ppc/intel)<br />
** URL: http://dl.dropbox.com/u/7737184/Dosbox/Dosbox-Snapshot.dmg<br />
** Notes: Automatically updated on changes to SVN.<br />
<br />
===Enhanced SVN builds===<br />
The following SVN builds contain additional fixes and/or features that are not officially part of DOSBox. Many people prefer them due to the included extra features that are not included in in the SVN. Note that if you have problems with these builds, it may be due to the unofficial changes that have been made by their maintainers and not the official DOSBox code itself that is to blame:<br />
<br />
* '''DOSBox with Long File Name (LFN) and mouse copy/past support''' by Wengier<br />
** Last updated: 2014-10-26<br />
** SVN base version: r3871<br />
** URL: http://www.vogons.org/viewtopic.php?t=40610 (discussion + source + Windows binary)<br />
** URL: http://www.vogons.org/viewtopic.php?t=41179 (discussion + source + Windows binary)<br />
** URL: http://bit.ly/12jANWF (latest Windows binary + required DLLs, zipped)<br />
** Description: This is a build of DOSBox based on its SVN version that adds Long File Name (LFN) and mouse copy/past support. With this both the DOSBox shell commands and many native LFN-aware DOS programs should now be able to use LFN in DOSBox, and users can also use the right mouse button to select, copy and paste text from and to DOSBox (when the mouse is not locked). Windows binaries are provided, but sources should work on other platforms too (pdcurses is required for the cross-platform clipboard copy/paste feature).<br />
<br />
* '''DOSBox SVN Daum''' by ykhwong for Windows, OSX, and Linux<br />
** Last updated: 2014-01-27<br />
** SVN base version: r3852<br />
** URL: http://ykhwong.x-y.net/ (Windows binary, Linux x86 source)<br />
** URL: http://cafe.daum.net/dosbox<br />
** Description: The Windows build incorporates Direct3D with pixelshaders, OpenglHQ, Innovation, Glide, zip/7z mount, Beep, NE2000 Ethernet, Graphis user interface (menu), Save/Load states, Vertical sync, CPU flags optimization, Various DOS commands (PROMPT, VOL, LABEL, MOUSE, etc) and CONFIG.SYS commands (DEVICE, BUFFERS, FILES, etc), Continuous turbo key, Core-switch key, Show details (from menu bar), Nice DOSBox icon, Font patch (cp437), MAKEIMG command, INTRO, Ctrl-break patch, DBCS support patch, Automatic mount, Printer output, MT-32 emulation (MUNT), MP3CUE, Overscan border, Stereo-swap, SDL_Resize, MemSize128, Internal 3dfx voodoo chip emulation, etc. Recent versions include DOSBox-X branch changes as well.<br />
<br />
* '''dosbox-patched''' for Ubuntu Linux (Oneiric and newer)<br />
** Last updated: 2013-12-11<br />
** SVN base version: ?<br />
** URL: https://code.launchpad.net/~i30817/+archive/dosbox-patched<br />
** Description: "Daily build of dosbox trunk with mt32 patch (roms go into ~/.dosbox)". Automatically-built PPA packages built from DOSBox SVN trunk with Munt MT-32 emulation patch.<br />
<br />
* '''DOSBox-X''' by TheGreatCodeholio<br />
** Last updated: 2012-06-10?<br />
** SVN base version: ?<br />
** URL: http://www.vogons.org/viewtopic.php?t=31881 (discussion + links)<br />
** URL: http://hackipedia.org/Projects/DOSBox-X/ (source only?)<br />
** Description: "This is a branch of DOSBox 0.74 that I have been working on and off for the past 8 months. I've been modifying a lot in the source to make the emulation more accurate, to fix other parts of the emulation, and to widen the kind of hardware DOSBox emulates. I call it "DOSBox-x" for lack of a better name."<br />
<br />
===Obsolete SVN/CVS builds===<br />
These builds appear to be no longer maintained, and are listed here for historical reference.<br />
<br />
* '''"Mega Build" series (by H-A-L-9000)'''<br />
** Last updated: 2010-11-18<br />
** SVN base version: r3661<br />
** URL: http://home.arcor.de/h-a-l-9000/ (Windows binary, Linux source, Intel Mac OS X port by thedoctor45)<br />
** URL: http://www.vogons.org/viewtopic.php?t=26170 to discuss the Mac port<br />
** Description: Builds of DOSBox focused on serial/networking support. Contains the NE2000 patch, parallel port passthrough and file forwarding, virtual printer, SVGA enhacements, OPL passthrough, and others. The Windows installer contains the debug-enabled build as option.<br />
<br />
* '''"UBER BUILD" (by Virusek)'''<br />
** Last Updated: 2010-07-23<br />
** SVN base version: r3623<br />
** URL: http://www.vogons.org/viewtopic.php?p=193022#193022 (Windows binary, source)<br />
** Description: All patches from gulikoza's build (coreswitch, direct3d, glide, mt32, openglhq, physfs, NE2000, printer and oplpassthrough). Updated Glide patch by gulikoza to 24.11.2009. SDL_sound support. Some other small fixes (mostly VS2010 compatibility fixes).<br />
<br />
* '''Zirias'''<br />
** Last Updated: 2010-05-12<br />
** URL: http://www.vogons.org/viewtopic.php?p=186679#186679 (Debian i386 + amd64 binary & source packages)<br />
** Description: Debian Linux APT packaged version of DOSBox with Glide support.<br />
<br />
* '''Tharos (by XTale)'''<br />
** Last updated: 2010-03-28<br />
** <s>URL: http://builds.tharos-online.de/index.php?dir=&sort=date&order=desc</s><br />
** Notes: '''Daily builds seem to have stopped as of 3/28/10.'''<br />
<br />
* '''gulikoza'''<br />
** Last Updated: 2009-07-09<br />
** URL: http://www.si-gamer.net/gulikoza/ (Windows binary, source)<br />
** Description: Build of DOSBox focused on GLIDE support.<br />
<br />
* '''DOSBox for Mac OSX (by rhoenie/Marcus Herbert)'''<br />
** Last updated: 2008-08-09<br />
** URL: http://www.spam-filter.de/bastelstunde#dosbox<br />
** Description: DosBox 0.72 for G3 & DosBox CVS for OSX (G4/G5/i386)<br />
<br />
* '''DOSBox CVS for Linux (by Moe)'''<br />
** Last updated: 2006-12-15<br />
** <s>URL: http://garni.ch/dosbox/</s><br />
** Description: Recently Moe has decided to provide a DOSBox Linux (x86, 32-bit, Athlon64-optimized) binary including some useful patches. It is built against latest CVS and includes at least these patches: addkey, adlib optimize, Innovation SSI-2001, Self-Modifying-Code optimizations, SVGA chipsets, CD-Image cycling, Glide emulation, Printer emulation.<br />
** Notes: Moe is also the creator of OPENGL-HQ. OPENGL-HQ is another scaler that is implemented in SDL.dll. Unfortunately it may be some time (or never), until OPENGL-HQ is implemented in the official SDL so until then you'll have to download it from here (or compile it yourself). Neat thing about this is that you can use this SDL.DLL with any SDL program (e.g. DOSBox, SCUMMVM...).<br />
<br />
* '''DOSBox with MT-32 emulation (by Canadacow)'''<br />
** Last updated: 2004-10-15<br />
** <s>URL: http://www.artworxinn.com/alex/downloads.htm</s><br />
** Description: ''This build is no longer useful''; it was made before DOSBox 0.63 came out and contains MT-32 emulation code that is much older than the current Munt releases. Note that more current MT-32 emulation is also included as an unofficial feature of some of the newer SVN builds.<br />
<br />
==Useful Links==<br />
<br />
===SVN changelog===<br />
The following links list the latest changes to the official DOSBox source code on its sourceforge.net SVN repository:<br />
* http://source.dosbox.com/dosboxsvn.txt (auto-generated changelog provided by Qbix)<br />
* http://sourceforge.net/p/dosbox/code-0/3852/log/?path=/dosbox (sourceforge.net SVN log) - '''fixed on 2014-01-01'''<br />
<br />
===SVN build news===<br />
The following link(s) provide news related to DOSBox SVN builds:<br />
* http://www.emucr.com/search/label/DOSBox (EmuCR posts with DOSBox tag, which includes news regarding DOSBox SVN builds, frontends and other DOSBox ports)<br />
<br />
===Debugger-enabled builds===<br />
Qbix has a thread on the DOSBox forum containing links to some special DOSBox builds that have a built-in debugger:<br />
* http://www.vogons.org/viewtopic.php?t=7323<br />
<br />
===Making your own SVN build===<br />
The following DOSBoxWiki article discusses the process of making your own SVN build from the official DOSBox SVN source code:<br />
* [[BuildingDOSBox]]<br />
<br />
===Snapshot of latest DOSBox SVN source code===<br />
Snapshots of the latest SVN versions of the DOSBox source code are available at the following URL(s) :<br />
* http://source.dosbox.com/dosboxsvn.tgz (auto-generated tarball provided by Qbix)<br />
* http://dosbox.svn.sourceforge.net/viewvc/dosbox/dosbox/trunk/?view=tar (auto-generated tarball created by sourceforge.net)<br />
* http://sourceforge.net/scm/?type=svn&group_id=52551 (sourceforge.net instructions for accessing official DOSBox SVN repository)<br />
* http://dosbox.svn.sourceforge.net/viewvc/dosbox/dosbox/trunk/ (sourceforge.net SVN browser for official DOSBox SVN repository)<br />
<br />
==Unofficial ports==<br />
These builds are for other Operating Systems and hardware platforms and are not in any way supported by the DOSBox team.<br />
<br />
===Android===<br />
* '''AnDOSBox''' (ver. 0.74, v1.2.7, 2012-06)<br />
** URL: http://sites.google.com/site/andosbox/<br />
<br />
* '''DosBox Turbo''' (ver. 0.74 SVN, v1.5.0, 2012-09-28)<br />
** URL: http://sites.google.com/site/dosboxturbo/<br />
<br />
* '''aDOSBox''' (ver. 0.73, v0.2.5, 2011-05)<br />
** URL: http://androiddosbox.appspot.com<br />
<br />
===iOS===<br />
* '''DOSPad''' (ver. 0.74, v1.96, 2011-01)<br />
** URL: http://www.litchie.com/?page_id=123<br />
<br />
===PSP===<br />
* '''DOSBox PSP''' (ver. 0.71, 2008-08-03)<br />
** <s>URL: http://www.qj.net/tag/crazyc-gaming-news.html</s><br />
** URL: http://www.pspdosbox.co.uk<br />
** <s>URL: http://forums.ps2dev.org/viewtopic.php?t=9564</s><br />
<br />
===Pocket PC / Windows Mobile===<br />
* '''DosBox PPC''' (ver. 0.73, 2009-07-06)<br />
** URL: http://n0p.8bit.fm<br />
<br />
===Wii===<br />
* '''DOSBox for Wii''' (ver. 0.74, v1.7, 2012-06-30)<br />
** URL: http://code.google.com/p/dosbox-wii/<br />
<br />
===Dreamcast===<br />
* '''DOSBox for Dreamcast''' (ver. 0.60, 2005?)<br />
** URL: http://gpf.dcemu.co.uk/dcdoxbox.shtml<br />
<br />
===GP2x===<br />
* '''DOSBox for GP2x''' (ver. 0.72, 2009-01-03)<br />
** URL: http://dl.openhandhelds.org/cgi-bin/gp2x.cgi?0,0,0,0,72,2534<br />
** <s>URL: http://wiki.gp2x.org/wiki/DosBox</s><br />
<br />
* '''DOSBox for GP2x Wiz''' (ver. 0.72, 2009-08-27)<br />
** URL: http://dl.openhandhelds.org/cgi-bin/wiz.cgi?0,0,0,0,72,198<br />
<br />
* '''DOSBox for GP2x Caanoo''' (ver. 0.74, 2012-01-14)<br />
** URL: http://dl.openhandhelds.org/cgi-bin/caanoo.cgi?0,0,0,0,72,826<br />
<br />
===Dingoo A320===<br />
* '''DOSBox for Dingoo A320''' (ver. 0.73, 2010-04-26)<br />
** URL: http://www.slaanesh.net/2010/04/dosbox-073-for-dingoo-a320-and-ben.html<br />
<br />
===OS/2===<br />
* '''DOSBox/2''' (ver. 0.74, 2010-09-17)<br />
** <s>URL: http://www.os2site.com/sw/emulators/dosbox/index.html<s/><br />
** URL: http://www.joschs-robotics.de/dosbox/<br />
** URL: http://wiki.netlabs.org/index.php/DOSBox_Port<br />
<br />
===AmigaOS 4.0===<br />
* '''DOSBox for AmigaOS 4.0''' (ver. 0.72, 2009-06-14)<br />
** URL: http://www.os4depot.net/share/emulation/computer/dosbox.lha<br />
** URL: http://www.os4depot.net/index.php?function=browse&cat=emulation/computer<br />
<br />
===Java===<br />
* '''jDosbox''' (ver. v0.74, v0.74.25, 2011-08-25)<br />
** URL: http://jdosbox.sourceforge.net<br />
<br />
===JavaScript===<br />
* '''JsDOSBox''' (ver. 0.74, 2012-07)<br />
** URL: http://sourceforge.net/projects/jsdosbox/<br />
<br />
===IRIX===<br />
* '''DOSBox for IRIX''' (ver. 0.71, 2007?)<br />
** URL: http://www.spam-filter.de/dosbox/dosbox_on_irix<br />
** <s>URL: http://www.enosnusnu.de/index.php?/archives/98-DOSBox-on-IRIX.html</s><br />
** Notes: Original enosnusnu.de link seems to now redirect to spam-filter.de. I added a link to a DOSBox on IRIX page on the latter site, but it appears that it may only offer a source code tarball and no binary.<br />
<br />
===PXA270===<br />
* '''DOSBox "Optimized" for PXA270 (by wellswang & kkazakov)''' (ver. 0.70, 2007-03-19)<br />
** <s>URL: http://www.oesf.org/forum/index.php?showtopic=18415&st=270&p=156742&#entry156742</s><br />
** URL: http://wells.osall.com/files/download.php?id=1727<br />
** URL: http://www.oesf.org/forums/index.php?s=1dec7dd003587d385fbec45efb1ffbaa&showtopic=18415&st=270&p=156742&#entry156742</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Main_Page&diff=134588Main Page2015-06-08T19:44:11Z<p>Beresford: /* More Specific Topics */ fixed casing of the work DOSBox</p>
<hr />
<div>'''<br />
=Welcome to the Wiki page of the DOSBox project=<br />
<br />
'''DOSBox''' emulates an Intel x86 PC, complete with [[Sound|sound]], [[Display|graphics]], [[Input|mouse]], [[Input|joystick]], [[Connectivity|modem]], etc., necessary for running many old MS-DOS [[GAMES|games]] that simply cannot be run on modern PCs and operating systems, such as Microsoft Windows XP, Windows Vista, Linux and FreeBSD. However, it is not restricted to running only games. In theory, any MS-DOS or PC-DOS (referred to commonly as "DOS") [[Software|application]] should run in DOSBox, but the emphasis has been on getting DOS [[GAMES|games]] to run smoothly, which means that communication, networking and printer support are still in early development.<br />
<br />
DOSBox also comes with its own [[Command Line|DOS-like command prompt]]. It is still quite rudimentary and lacks many of the features found in MS-DOS, but it is sufficient for installing and running most DOS [[GAMES|games]].<br />
<br />
DOSBox has a lively, user-supported [http://vogons.org community forum] hosted at VOGONS (Very Old Games On New Systems). Feel very very free to drop by if you have questions about DOSBox!<br />
<br />
==General Information==<br />
*[[Releases|Downloading DOSBox]]<br />
*[[System Requirements]]<br />
*[[DOSBox_FAQ|Frequently Asked Questions]] (FAQ)<br />
*Guides<br />
**[[Basic Setup and Installation of DosBox]]<br />
***[[DOSBox and Windows Vista|Vista Specific Issues]]<br />
***[[DOSBox and Mac OSX|Mac OSX Specific Issues]]<br />
***[[Mac OSX Advanced]]<br />
***[[Recording Video]]<br />
**[[Contributing to this Wiki]]<br />
**[[GAMES|Games]] that DOSBox can (or can't) run<br />
**[[Software]] applications that DOSBox can (or can't) run<br />
**[[TOOLS|Tools]] that can assist either playing games or using DOSBox generally<br />
**[[DOSBoxFrontends|Frontends]] - simplifies running and understanding DOSBox.<br />
**[[Performance|Running Resource Demanding Games]]<br />
*[[Special Thanks]]<br />
*[[Contact]]<br />
<br />
==More Specific Topics==<br />
*[[Usage]]<br />
*[[ZDrive|Z:\> Prompt]]<br />
*[[Commands|Command Line Utilities]]<br />
*[[Utilities|Internal Programs]]<br />
**[[MOUNT|Mounting your CD-ROM in DOSBox]]<br />
*[[Special Keys]]<br />
*[[dosbox.conf|The Configuration File]] (dosbox.conf)<br />
**[[Associating the Configuration File in Windows]]<br />
*[[Language File|The Language File]]<br />
*[[Keymapper|The Keymapper]]<br />
*[[Ubuntu Configuration|Ubuntu Configuration]]<br />
*[[DOSBoxShortcuts|DOSBox Shortcuts]]<br />
*[[GOG_games_that_use_DOSBox|GOG Games that use DOSBox]] - An overview<br />
<br />
==DOSBox Resources==<br />
*[http://dosbox.cvs.sourceforge.net/dosbox/dosbox/README?view=markup DOSBox README File]<br />
*[http://dosbox.com/comp_list.php List of Games and Applications] (and how to install and run them)<br />
*[http://vogons.org DOSBox community forum]<br />
*[http://dosbox.sourceforge.net/oldwiki/ The original DOSBox Wiki]<br />
<br />
==Advanced Topics==<br />
*[[BuildingDOSBox|Building DOSBox]] - Building your own version of DOSBox using mingw<br />
*[[Building_DOSBox_with_Visual_C_2008_Express|Building DOSBox with Visual C 2008 Express]]<br />
*[https://wiki.libsdl.org/FAQUsingSDL Using SDL FAQ] (SDL environment variables that can make or break things)<br />
*[[Special:Allpages|Index of all articles]]</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Main_Page&diff=134587Main Page2015-06-08T19:43:26Z<p>Beresford: /* Advanced Topics */ fixed url of sdl faq</p>
<hr />
<div>'''<br />
=Welcome to the Wiki page of the DOSBox project=<br />
<br />
'''DOSBox''' emulates an Intel x86 PC, complete with [[Sound|sound]], [[Display|graphics]], [[Input|mouse]], [[Input|joystick]], [[Connectivity|modem]], etc., necessary for running many old MS-DOS [[GAMES|games]] that simply cannot be run on modern PCs and operating systems, such as Microsoft Windows XP, Windows Vista, Linux and FreeBSD. However, it is not restricted to running only games. In theory, any MS-DOS or PC-DOS (referred to commonly as "DOS") [[Software|application]] should run in DOSBox, but the emphasis has been on getting DOS [[GAMES|games]] to run smoothly, which means that communication, networking and printer support are still in early development.<br />
<br />
DOSBox also comes with its own [[Command Line|DOS-like command prompt]]. It is still quite rudimentary and lacks many of the features found in MS-DOS, but it is sufficient for installing and running most DOS [[GAMES|games]].<br />
<br />
DOSBox has a lively, user-supported [http://vogons.org community forum] hosted at VOGONS (Very Old Games On New Systems). Feel very very free to drop by if you have questions about DOSBox!<br />
<br />
==General Information==<br />
*[[Releases|Downloading DOSBox]]<br />
*[[System Requirements]]<br />
*[[DOSBox_FAQ|Frequently Asked Questions]] (FAQ)<br />
*Guides<br />
**[[Basic Setup and Installation of DosBox]]<br />
***[[DOSBox and Windows Vista|Vista Specific Issues]]<br />
***[[DOSBox and Mac OSX|Mac OSX Specific Issues]]<br />
***[[Mac OSX Advanced]]<br />
***[[Recording Video]]<br />
**[[Contributing to this Wiki]]<br />
**[[GAMES|Games]] that DOSBox can (or can't) run<br />
**[[Software]] applications that DOSBox can (or can't) run<br />
**[[TOOLS|Tools]] that can assist either playing games or using DOSBox generally<br />
**[[DOSBoxFrontends|Frontends]] - simplifies running and understanding DOSBox.<br />
**[[Performance|Running Resource Demanding Games]]<br />
*[[Special Thanks]]<br />
*[[Contact]]<br />
<br />
==More Specific Topics==<br />
*[[Usage]]<br />
*[[ZDrive|Z:\> Prompt]]<br />
*[[Commands|Command Line Utilities]]<br />
*[[Utilities|Internal Programs]]<br />
**[[MOUNT|Mounting your CD-ROM in DOSBox]]<br />
*[[Special Keys]]<br />
*[[dosbox.conf|The Configuration File]] (dosbox.conf)<br />
**[[Associating the Configuration File in Windows]]<br />
*[[Language File|The Language File]]<br />
*[[Keymapper|The Keymapper]]<br />
*[[Ubuntu Configuration|Ubuntu Configuration]]<br />
*[[DOSBoxShortcuts|DosBox Shortcuts]]<br />
*[[GOG_games_that_use_DOSBox|GOG Games that use DOSBox]] - An overview<br />
<br />
==DOSBox Resources==<br />
*[http://dosbox.cvs.sourceforge.net/dosbox/dosbox/README?view=markup DOSBox README File]<br />
*[http://dosbox.com/comp_list.php List of Games and Applications] (and how to install and run them)<br />
*[http://vogons.org DOSBox community forum]<br />
*[http://dosbox.sourceforge.net/oldwiki/ The original DOSBox Wiki]<br />
<br />
==Advanced Topics==<br />
*[[BuildingDOSBox|Building DOSBox]] - Building your own version of DOSBox using mingw<br />
*[[Building_DOSBox_with_Visual_C_2008_Express|Building DOSBox with Visual C 2008 Express]]<br />
*[https://wiki.libsdl.org/FAQUsingSDL Using SDL FAQ] (SDL environment variables that can make or break things)<br />
*[[Special:Allpages|Index of all articles]]</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Main_Page&diff=134586Main Page2015-06-08T19:36:29Z<p>Beresford: fixed urls of vogons forum</p>
<hr />
<div>'''<br />
=Welcome to the Wiki page of the DOSBox project=<br />
<br />
'''DOSBox''' emulates an Intel x86 PC, complete with [[Sound|sound]], [[Display|graphics]], [[Input|mouse]], [[Input|joystick]], [[Connectivity|modem]], etc., necessary for running many old MS-DOS [[GAMES|games]] that simply cannot be run on modern PCs and operating systems, such as Microsoft Windows XP, Windows Vista, Linux and FreeBSD. However, it is not restricted to running only games. In theory, any MS-DOS or PC-DOS (referred to commonly as "DOS") [[Software|application]] should run in DOSBox, but the emphasis has been on getting DOS [[GAMES|games]] to run smoothly, which means that communication, networking and printer support are still in early development.<br />
<br />
DOSBox also comes with its own [[Command Line|DOS-like command prompt]]. It is still quite rudimentary and lacks many of the features found in MS-DOS, but it is sufficient for installing and running most DOS [[GAMES|games]].<br />
<br />
DOSBox has a lively, user-supported [http://vogons.org community forum] hosted at VOGONS (Very Old Games On New Systems). Feel very very free to drop by if you have questions about DOSBox!<br />
<br />
==General Information==<br />
*[[Releases|Downloading DOSBox]]<br />
*[[System Requirements]]<br />
*[[DOSBox_FAQ|Frequently Asked Questions]] (FAQ)<br />
*Guides<br />
**[[Basic Setup and Installation of DosBox]]<br />
***[[DOSBox and Windows Vista|Vista Specific Issues]]<br />
***[[DOSBox and Mac OSX|Mac OSX Specific Issues]]<br />
***[[Mac OSX Advanced]]<br />
***[[Recording Video]]<br />
**[[Contributing to this Wiki]]<br />
**[[GAMES|Games]] that DOSBox can (or can't) run<br />
**[[Software]] applications that DOSBox can (or can't) run<br />
**[[TOOLS|Tools]] that can assist either playing games or using DOSBox generally<br />
**[[DOSBoxFrontends|Frontends]] - simplifies running and understanding DOSBox.<br />
**[[Performance|Running Resource Demanding Games]]<br />
*[[Special Thanks]]<br />
*[[Contact]]<br />
<br />
==More Specific Topics==<br />
*[[Usage]]<br />
*[[ZDrive|Z:\> Prompt]]<br />
*[[Commands|Command Line Utilities]]<br />
*[[Utilities|Internal Programs]]<br />
**[[MOUNT|Mounting your CD-ROM in DOSBox]]<br />
*[[Special Keys]]<br />
*[[dosbox.conf|The Configuration File]] (dosbox.conf)<br />
**[[Associating the Configuration File in Windows]]<br />
*[[Language File|The Language File]]<br />
*[[Keymapper|The Keymapper]]<br />
*[[Ubuntu Configuration|Ubuntu Configuration]]<br />
*[[DOSBoxShortcuts|DosBox Shortcuts]]<br />
*[[GOG_games_that_use_DOSBox|GOG Games that use DOSBox]] - An overview<br />
<br />
==DOSBox Resources==<br />
*[http://dosbox.cvs.sourceforge.net/dosbox/dosbox/README?view=markup DOSBox README File]<br />
*[http://dosbox.com/comp_list.php List of Games and Applications] (and how to install and run them)<br />
*[http://vogons.org DOSBox community forum]<br />
*[http://dosbox.sourceforge.net/oldwiki/ The original DOSBox Wiki]<br />
<br />
==Advanced Topics==<br />
*[[BuildingDOSBox|Building DOSBox]] - Building your own version of DOSBox using mingw<br />
*[[Building_DOSBox_with_Visual_C_2008_Express|Building DOSBox with Visual C 2008 Express]]<br />
*[http://docs.mandragor.org/files/Common_libs_documentation/SDL/FAQ_en/FAQ-Using_SDL.html Using SDL FAQ] (SDL environment variables that can make or break things) '''*Currently down as of Feb 23, 2010*'''<br />
*[[Special:Allpages|Index of all articles]]</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=GAMES:King%27s_Quest:_Quest_for_the_Crown&diff=134584GAMES:King's Quest: Quest for the Crown2015-06-07T04:40:17Z<p>Beresford: updated dosbox conf settings</p>
<hr />
<div>{{Infobox Game<br />
|title=King's Quest: Quest for the Crown<br />
|id=132<br />
|image=[[Image:GAME_Kings1_1987_Title.png‎|320px]]<br />
|caption=Title Screen (1987 version)<br />
|developer=Sierra On-Line<br />
|publisher=IBM, Sierra On-Line<br />
|released=1983 & 1984 (original),<br />
<br />
1987 (5th release),<br />
<br />
1990 (Enhanced)<br />
|version=[[Version0.74|0.74]]<br />
|status=Supported<br />
|executable='''SIERRA.COM'''<br />
|installer='''INSTALLH.BAT'''}}<br />
<br />
'''King's Quest: Quest for the Crown''' is a adventure game.<br />
<br />
== Making it work ==<br />
<br />
King's Quest (both the original version and the enhanced remake) works fine under DOSBox, but you can get enhanced sound from the original version by changing your [[Dosbox.conf|dosbox.conf]] file to emulate a Tandy computer.<br />
<br />
The 1987 version and enhanced remake (1990) was compatible with DOS:<br />
[dosbox]<br />
machine=tandy<br />
[render]<br />
aspect=true<br />
[cpu]<br />
core=normal<br />
cycles=10000<br />
<br />
The 1984 version was distributed with a PC Booter disk that overrode the operating system:<br />
[dosbox]<br />
machine=cga<br />
<br />
[autoexec]<br />
mount c C:\KQ1<br />
boot KQ.img<br />
<br />
If you require support for general issues, see the [[Performance|performance guide]] and [[DOSBox_FAQ|FAQ]].<br />
<br />
== See also ==<br />
<br />
* [[GAMES:King's Quest II: Romancing the Throne|King's Quest II: Romancing the Throne]]<br />
* [[GAMES:King's Quest III: To Heir Is Human|King's Quest III: To Heir Is Human]]<br />
<br />
== External links ==<br />
<br />
*[http://www.gog.com/gamecard/kings_quest_1_2_3 King’s Quest 1+2+3] at Good Old Games (GOG)<br />
*[http://www.mobygames.com/game/dos/kings-quest King's Quest] at MobyGames<br />
<br />
[[Category:Adventure games]]</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=File:Gr-lida.jpg&diff=134583File:Gr-lida.jpg2015-06-07T02:13:46Z<p>Beresford: Screenshot of GR-Lida frontend</p>
<hr />
<div>Screenshot of GR-Lida frontend</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=File:Dqml.jpg&diff=134582File:Dqml.jpg2015-06-07T02:05:38Z<p>Beresford: Screenshot of Dread's QuickMame Launcher</p>
<hr />
<div>Screenshot of Dread's QuickMame Launcher</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=File:Dboxfe.png&diff=134581File:Dboxfe.png2015-06-07T01:42:08Z<p>Beresford: Screenshot of DBoxFE</p>
<hr />
<div>Screenshot of DBoxFE</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=File:D-box.png&diff=134580File:D-box.png2015-06-07T00:24:36Z<p>Beresford: Screenshot of the D-Box frontend</p>
<hr />
<div>Screenshot of the D-Box frontend</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Template:Infobox_Frontend&diff=134579Template:Infobox Frontend2015-06-07T00:19:27Z<p>Beresford: added line break, hopefully</p>
<hr />
<div>{| class="infobox bordered vevent" style="float: {{{align|right}}}; font-size: 90%; text-align: left;" cellpadding="3"<br />
|-<br />
! colspan="2" style="font-size:110%; text-align: center; background-color: #ccccff;" class="summary" | ''{{{name|{{PAGENAME}}}}}''<br />
|-<br />
| colspan="2" style="text-align: center;" | {{{image|}}}<div>{{{caption|}}}</div><br />
|-<br />
| style="background-color: #ccccff;" | Supported Operating System<br />
| {{{os|''Unknown''}}}<br />
|-<br />
| style="background-color: #ccccff;" | Programming Language<br />
| {{{pglanguage|''Unknown''}}}<br />
|-<br />
| style="background-color: #ccccff;" | License<br />
| {{{license|''Unknown''}}}<br />
|-<br />
| style="background-color: #ccccff;" | Active<br />
| {{{active|''Unknown''}}}<br />
|-<br />
| style="background-color: #ccccff;" | Portable<br />
| {{{portable|''Unknown''}}}<br />
|}<br />
'''Description'''<br />
<br />
{{{description|'' ''}}}<br />
<br clear="all" /></div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Template:Infobox_Frontend&diff=134578Template:Infobox Frontend2015-06-06T23:47:07Z<p>Beresford: fixed description formatting</p>
<hr />
<div>{| class="infobox bordered vevent" style="float: {{{align|right}}}; font-size: 90%; text-align: left;" cellpadding="3"<br />
|-<br />
! colspan="2" style="font-size:110%; text-align: center; background-color: #ccccff;" class="summary" | ''{{{name|{{PAGENAME}}}}}''<br />
|-<br />
| colspan="2" style="text-align: center;" | {{{image|}}}<div>{{{caption|}}}</div><br />
|-<br />
| style="background-color: #ccccff;" | Supported Operating System<br />
| {{{os|''Unknown''}}}<br />
|-<br />
| style="background-color: #ccccff;" | Programming Language<br />
| {{{pglanguage|''Unknown''}}}<br />
|-<br />
| style="background-color: #ccccff;" | License<br />
| {{{license|''Unknown''}}}<br />
|-<br />
| style="background-color: #ccccff;" | Active<br />
| {{{active|''Unknown''}}}<br />
|-<br />
| style="background-color: #ccccff;" | Portable<br />
| {{{portable|''Unknown''}}}<br />
|}<br />
'''Description'''<br />
<br />
{{{description|'' ''}}}</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=File:Dbgl.png&diff=134577File:Dbgl.png2015-06-06T23:37:55Z<p>Beresford: Screenshot of DOSBox Game Launcher</p>
<hr />
<div>Screenshot of DOSBox Game Launcher</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Template:Infobox_Frontend&diff=134576Template:Infobox Frontend2015-06-06T23:25:16Z<p>Beresford: copied from infobox game</p>
<hr />
<div>{| class="infobox bordered vevent" style="float: {{{align|right}}}; font-size: 90%; text-align: left;" cellpadding="3"<br />
|-<br />
! colspan="2" style="font-size:110%; text-align: center; background-color: #ccccff;" class="summary" | ''{{{name|{{PAGENAME}}}}}''<br />
|-<br />
| colspan="2" style="text-align: center;" | {{{image|}}}<div>{{{caption|}}}</div><br />
|-<br />
| style="background-color: #ccccff;" | Supported Operating System<br />
| {{{os|''Unknown''}}}<br />
|-<br />
| style="background-color: #ccccff;" | Programming Language<br />
| {{{pglanguage|''Unknown''}}}<br />
|-<br />
| style="background-color: #ccccff;" | License<br />
| {{{license|''Unknown''}}}<br />
|-<br />
| style="background-color: #ccccff;" | Active<br />
| {{{active|''Unknown''}}}<br />
|-<br />
| style="background-color: #ccccff;" | Portable<br />
| {{{portable|''Unknown''}}}<br />
|}</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Building_DOSBox_with_MinGW&diff=134551Building DOSBox with MinGW2015-02-27T03:09:04Z<p>Beresford: /* Adding screenshot support (Optional) */ updated libpng version</p>
<hr />
<div>== Building your own version of DOSBox ==<br />
<br />
MinGW is the development environment that this page will show you how to use, an alternative is to use [[Building_DOSBox_with_Visual_C_2008_Express|Microsoft Visual Studio]]<br />
<br />
This page will guide you through setting up MinGW to compile a current (SVN/CVS) version of DOSBox. Because of updates to compilers and libraries, this guide will not work with the 0.74 (the last official release, which is currently over 4 years old) source files.<br />
<br />
== Installing MinGW ==<br />
* Download mingw-get-setup.exe from http://sourceforge.net/projects/mingw/<br />
* Run the installer, choosing the defaults<br />
* Once the '''MinGW Installation Manager''' application starts, select<br />
** mingw-developer-toolkit (msys-base should be automatically added)<br />
** mingw32-base<br />
** mingw32-gcc-g++<br />
* On the installation menu, apply changes, and confirm that you want to apply the changes<br />
<br />
The installation manager is going to download a bunch of files, and at the end, start installing them. Once this is done, you can close the dialog box as well as the installation manager.<br />
<br />
Well done, MinGW is now installed! Let's start it up.<br />
<br />
* Browse to '''C:\MinGW\msys\1.0'''<br />
* Run '''MSYS.BAT'''<br />
<br />
This will start up a DOS prompt like screen, lets mount the base path<br />
mount 'c:\MinGW' /mingw<br />
<br />
You have now completed this section, lets move on to adding the SDL libraries to MinGW.<br />
<br />
== Adding the SDL libraries to MinGW ==<br />
* Download the pre compiled SDL development libraries from here http://www.libsdl.org/release/SDL-devel-1.2.15-mingw32.tar.gz<br />
* Copy the downloaded file to your MSYS home folder, it's going to be something like '''C:\MinGW\msys\1.0\home\Administrator'''<br />
* Switch back to the MSYS command prompt we started earlier<br />
* Lets extract the downloaded files<br />
tar xvf SDL-devel-1.2.15-mingw32.tar.gz<br />
* And now add the files to MinGW<br />
cd SDL-1.2.15<br />
make install-sdl prefix=/mingw<br />
cd ..<br />
<br />
Cool, the SDL libraries have been added to MinGW, onto the next section.<br />
<br />
== Adding Direct Draw support to DOSBox (Optional) ==<br />
If you want to give DOSBox the option to use the DDRAW output option, then we need to add a couple of extra libraries to MinGW<br />
* Download the following file, http://www.libsdl.org/extras/win32/common/directx-devel.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the files (the -C parameter, tells tar where to extract the files to)<br />
tar xvf directx-devel.tar.gz -C /mingw<br />
<br />
== Adding networking support to DOSBox (Optional) ==<br />
These steps show you how to add the SDL_net libraries to MinGW, which enable networking and modem for DOSBox. If you aren't going to be using DOSBox for multi player games, then you can probably skip this step.<br />
* Download the SDL_net source files from https://www.libsdl.org/projects/SDL_net/release/SDL_net-1.2.8.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file<br />
tar xvf SDL_net-1.2.8.tar.gz<br />
* Lets configure the libraries<br />
cd SDL_net-1.2.8<br />
./configure --prefix=/mingw<br />
* And now compile them<br />
make<br />
* And then install them (copy the files)<br />
make install<br />
cd ..<br />
<br />
== Adding screenshot support (Optional) ==<br />
This one is a bit tricky because it relies on two libraries, zlib (libpng needs these libraries), and libpng. We are also going to be compiling the libraries statically to keep external DLL's to a minimum.<br />
* Download zlib from here http://sourceforge.net/projects/libpng/files/zlib/1.2.8/zlib-1.2.8.tar.xz/download<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file<br />
tar xvf zlib-1.2.8.tar.xz<br />
* Lets build the static library<br />
cd zlib-1.2.8<br />
make -f win32/Makefile.gcc<br />
* And now copy the files to /mingw<br />
cp libz.a /mingw/lib/<br />
cp zlib.h zconf.h /mingw/include/<br />
cd ..<br />
Cool, that wasn't too hard, onto libpng<br />
* Download libpng from here http://sourceforge.net/projects/libpng/files/libpng16/1.6.16/libpng-1.6.16.tar.gz/download<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file <br />
tar xvf libpng-1.6.16.tar.gz<br />
* Configure the library<br />
cd libpng-1.6.16<br />
./configure --disable-shared --prefix=/mingw<br />
* And now to compile and install the files<br />
make<br />
make install<br />
cd ..<br />
<br />
== Adding support for compressed audio on diskimages (Optional) ==<br />
This is for cue/bin cdrom images with compressed (ogg) audio tracks. We will be adding the libvorbis, libogg, and sdl_sound libraries. <br />
* Download libogg from here http://downloads.xiph.org/releases/ogg/libogg-1.3.2.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file <br />
tar xvf libogg-1.3.2.tar.gz<br />
* Configure the library, disabling shared library files<br />
cd libogg-1.3.2<br />
./configure --disable-shared --prefix=/mingw<br />
* Compile and install the library files<br />
make<br />
make install<br />
cd ..<br />
<br />
* Download libvorbis from here http://downloads.xiph.org/releases/vorbis/libvorbis-1.3.4.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file <br />
tar xvf libvorbis-1.3.4.tar.gz<br />
* Configure the library, disabling shared library files<br />
cd libvorbis-1.3.4<br />
./configure --disable-shared --prefix=/mingw<br />
* Compile and install the library files<br />
make<br />
make install<br />
cd ..<br />
<br />
* Download sdl_sound from here https://www.icculus.org/SDL_sound/downloads/SDL_sound-1.0.3.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file <br />
tar xvf SDL_sound-1.0.3<br />
* Unfortunately sdl_sound isn't going to compile on MinGW so we are going to have to edit some of the source files.<br />
* Using something like Notepad++ (or Wordpad in a pinch), open up '''SDL_sound-1.0.3\decoders\mpglib\mpg123_sdlsound.h'''<br />
* Replace line 8<br />
#include <math.h><br />
* With the following<br />
# define M_PI 3.14159265358979323846<br />
# define M_SQRT2 1.41421356237309504880<br />
# define REAL_IS_FLOAT<br />
# define NEW_DCT9<br />
<br />
# define random rand<br />
# define srandom srand<br />
<br />
* Using something like Notepad++ (or Wordpad in a pinch), open up '''SDL_sound-1.0.3\decoders\timidity\tables.h'''<br />
* Comment out line 23 with two //<br />
//#include <math.h><br />
* The hard part is done, lets configure and compile<br />
cd SDL_sound-1.0.3<br />
./configure --disable-shared --prefix=/mingw LIBS="-lvorbisfile -lvorbis -logg"<br />
make<br />
make install<br />
cd ..<br />
<br />
== Enabling the debugger (You probably don't want this) ==<br />
The debugger is mainly for developers of DOSBox, so they can find out why a game isn't working.<br />
* Download the PDCurses source files from http://sourceforge.net/projects/pdcurses/files/pdcurses/3.4/PDCurses-3.4.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file<br />
tar xvf PDCurses-3.4.tar.gz<br />
* Compile the library<br />
cd PDCurses-3.4/win32<br />
make -f gccwin32.mak DLL=N<br />
* And now copy the files to your /mingw folders<br />
cp pdcurses.a /mingw/lib/libpdcurses.a<br />
cd ..<br />
cp curses.h panel.h /mingw/include/<br />
cd ..<br />
<br />
== Compiling DOSBox ==<br />
* Download the latest official DOSBox SVN source files from here: http://source.dosbox.com/dosboxsvn.tgz<br />
(There are also enhanced SVN versions containing additional fixes and/or features that are not officially part of DOSBox, see [[SVN Builds]] for more details)<br />
* Copy the file to your MSYS home folder<br />
* Extract the file<br />
tar xvf dosboxsvn.tgz<br />
* Let's configure DOSBox, and tell it to use the static C library (-static-libgcc) and C++ library (-static-libstdc++) and stripping the final EXE of debug information (-s)<br />
cd dosbox<br />
./autogen.sh<br />
./configure --enable-core-inline LDFLAGS="-static-libgcc -static-libstdc++ -s"<br />
* For SDL_sound support, you have to extra some extra parameters so that the configure command knows where to find the audio library files (LIBS="-lvorbisfile.....)<br />
./configure --enable-core-inline LDFLAGS="-static-libgcc -static-libstdc++ -s" LIBS="-lvorbisfile -lvorbis -logg"<br />
* If you want to enable debugging (you probably don't)<br />
./configure --enable-core-inline LDFLAGS="-static-libgcc -static-libstdc++ -s" LIBS="-lvorbisfile -lvorbis -logg" --enable-debug<br />
* And now for compiling DOSBox<br />
make<br />
* The last step is to gather all the files together in a folder<br />
** Create a folder with a name of your choosing<br />
** Copy the dosbox.exe file located under the '''dosbox\src''' folder, e.g. '''C:\MinGW\msys\1.0\home\Administrator\dosbox\src''' to the folder you created<br />
** Copy the SDL.dll file located under '''SDL-1.2.15\bin''', e.g. '''C:\MinGW\msys\1.0\home\Administrator\SDL-1.2.15\bin''' to the folder you created<br />
** Optionally, copy the SDL_net.dll file located under '''SDL_net-1.2.8\.libs''', e.g. '''C:\MinGW\msys\1.0\home\Administrator\SDL_net-1.2.8\.libs''' to the folder you created<br />
<br />
Start up DOSBox, and see if it works.</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Frontend_Comparison&diff=134546Frontend Comparison2015-01-05T07:42:28Z<p>Beresford: removed discontinued frontends</p>
<hr />
<div>{| class="sortable wikitable"<br />
!Name !!Programming Language !!Source Code !!Active !!Portable !!Multi Platform !!Notes<br />
|-<br />
|DOSBox Game Launcher || Java || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} ||<br />
|-<br />
|D-Fend Reloaded || Delphi || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} ||<br />
|-<br />
|Boxer || Object C || {{Yes}} || {{Yes}} || {{No}} || {{No}} ||<br />
|-<br />
|GR-Lida || C++ (QT) || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} ||<br />
|-<br />
|LaunchBox || .Net || {{No}} || {{Yes}} || {{Yes}} || {{No}} ||<br />
|-<br />
|AmpShell || .Net || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} ||<br />
|-<br />
|DosBlaster || .Net || {{Yes}} || {{No}} || {{No}} || {{No}} ||<br />
|-<br />
|D-Box || Java || {{Yes}} || {{No}} || {{No}} || {{Yes}} ||<br />
|-<br />
|DBoxFE || C++ (QT) || {{Yes}} || {{No}} || {{No}} || {{Yes}} ||<br />
|-<br />
|DOSBoxGui || Python || {{No}} || {{No}} || {{No}} || {{Yes}} || Download link is broken<br />
|-<br />
|CBoxRun || .Net || {{No}} || {{No}} || {{Yes}} || {{No}} ||<br />
|-<br />
|DBFrontend || Delphi || {{Yes}} || {{No}} || {{No}} || {{No}} || Run in Windows 98 Compatibility<br />
|-<br />
|DOS Shell || .Net || {{No}} || {{No}} || {{Yes}} || {{No}} ||<br />
|-<br />
|Old Games Launcher || .Net || {{Yes}} || {{No}} || {{No}} || {{No}} ||<br />
|-<br />
|Turbo Dos Box || .Net || {{No}} || {{No}} || {{No}} || {{No}} ||<br />
|-<br />
|Petit DOSBox || Object C || {{No}} || {{No}} || {{No}} || {{No}} || <br />
|-<br />
|pyDOSBox || Python || {{Yes}} || {{No}} || {{No}} || {{No}} ||<br />
|}</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=DOSBoxFrontends&diff=134545DOSBoxFrontends2015-01-05T07:41:42Z<p>Beresford: /* Incomplete overview of discontinued Frontends */ removed this section. i don't think it adds anything to the page.</p>
<hr />
<div>= Frontends for DOSBox =<br />
<br />
The following frontends will help you run, install and manage your DOS games. Some of them also support other emulators like ScummVM, Windows games, and console emulators. The current most popular frontends are, Boxer for MacOS X, D-Fend Reloaded for Windows, and DBGL which runs on multiple platforms.<br />
<br />
You can also have a look at the [[Frontend Comparison]] page.<br />
<br />
=== Multi Platform ===<br />
<br />
<br />
* '''DBGL''' - DOSBox Game Launcher<br />
<br />
: '''Description: '''An open source frontend for DOSBox, based largely upon the proven interface of D-Fend.<br />
<br />
: '''Platforms: ''' Windows, Linux, OS X<br />
<br />
: '''Website''': http://home.quicknet.nl/qn/prive/blankendaalr/dbgl/<br />
<br />
<br />
<br />
* '''D-Box'''<br />
<br />
: '''Description: ''' An open source frontend for DOSBOX. It tries to distinguish itself from alternatives by having "the right set of features", which means not too few, and not too many features. Includes a fancy "floppy flow" user interface.<br />
<br />
: '''Platforms: ''' Windows, Linux, OS X<br />
<br />
: '''Website''': https://code.google.com/p/dbox/<br />
<br />
<br />
<br />
* '''DBoxFE'''<br />
<br />
: '''Description: ''' DBoxFE creates and manages configuration files for DOSBox. You can create different profiles for your games, etc. Currently in beta.<br />
<br />
: '''Platforms: ''' Windows, Linux<br />
<br />
: '''Website''': http://developer.berlios.de/projects/dboxfe/<br />
<br />
<br />
<br />
* '''DOSBoxGui'''<br />
<br />
: '''Description: ''' A portable DOSBox frontend. Needs Tcl/Tk, which is a free, albeit big (20MB) software compiler that you will need to assemble the program for your operating system.<br />
<br />
: '''Platforms: ''' Windows, Linux<br />
<br />
: '''Website''': http://losfinkos.googlepages.com/dosboxgui<br />
<br />
<br />
<br />
* '''GR-lida'''<br />
<br />
: '''Description: ''' An open source frontend for DOSBox, ScummVM and VDMSound. It can display games using pictureflow, which is a clone of Apples cover flow.<br />
<br />
: '''Platforms: ''' Windows, Linux, OS X<br />
<br />
: '''Website''': http://www.gr-lida.org/ (Website is in Spanish, but the program works in additional languages, including English)<br />
<br />
=== Windows Only ===<br />
<br />
* '''AmpShell'''<br />
: '''Description: ''' The purpose of AmpShell is to make you run games in DOSBox with a simple double click. It saves the time and trouble you can have with DOS commands. Plus, it has a lot of other time-saving features.<br />
<br />
: '''Website''': http://ampshell.tuxfamily.org/<br />
<br />
<br />
* '''CBoxRun'''<br />
<br />
: '''Description: ''' A frontend that emphasizes ease of use. It can automatically download game information and screenshots from Wikipedia, and it has a nice [[dosbox.conf|config file]] editor with help for every field. Requires .NET 3.51.<br />
<br />
: '''Website''': http://cboxrun.wordpress.com/<br />
<br />
<br />
<br />
* '''DBFrontend''' - '''D'''OS'''B'''ox'''Frontend''' <br />
<br />
: '''Description: ''' An open source frontend with a simple interface which allows you to have thumbnails of screen shots so you can easy recognize the game you want to run.<br />
<br />
: '''Website''': http://www.ingoknito.de/produkte/dbfrontend/<br />
<br />
<br />
<br />
* '''D-Fend Reloaded''' - '''D'''OSBox-'''F'''ront'''end''' Reloaded<br />
<br />
: '''Description: ''' An open source frontend for DOSBox, ScummVM and Windows games. The development objective for D-Fend Reloaded was (besides 100% D-Fend compability) to make the program operation more simple with respect to DosBox beginners. Simultaneously more features for administration and configuration became available.<br />
<br />
: '''Website''': http://dfendreloaded.sourceforge.net/<br />
<br />
<br />
<br />
* '''DosBlaster'''<br />
<br />
: '''Description: ''' An open source frontend that offers a simplified view of the DOS games which can be manage easily. <br />
<br />
: '''Website''': http://dosblasterx.sourceforge.net/<br />
<br />
<br />
<br />
* '''DOSShell'''<br />
<br />
: '''Description: ''' Applications launcher, plus convenient Explorer-like entries manager.<br />
<br />
: '''Website''': http://www.loonies.narod.ru/dosshell.htm<br />
<br />
<br />
<br />
* '''Old Games Launcher'''<br />
<br />
: '''Description: ''' Direct Draw games launcher & Dosbox Frontend<br />
<br />
: '''Website''': https://oldgameslauncher.codeplex.com/<br />
<br />
<br />
<br />
* '''Turbo Dos Box'''<br />
<br />
: '''Description: ''' Very simple and small (~100KB no install needed) manager for configuration. Automatically mounts drives and can change all DOSBox options via XML setup, and can right click an EXE/COM/BAT and play it through DosBox by using the default configuration profile in "Right click and play" fashion.<br />
<br />
: '''Website''': http://www.turboirc.com/tdb<br />
<br />
<br />
<br />
* '''LaunchBox'''<br />
<br />
: '''Description: ''' LaunchBox was originally built as an attractive frontend to DOSBox, but has since expanded to support both modern PC games and emulated console platforms. DOSBox will continue to be a main focus for LaunchBox, as will emulation and PC gaming. LaunchBox aims to be the one-stop shop for gaming on your computer, for both modern and historical games.<br />
: '''Website''': http://www.launchbox-app.com<br />
<br />
=== Mac OS X Only ===<br />
<br />
<br />
<br />
* '''Boxer'''<br />
<br />
: '''Description: ''' Boxer makes it easy to run your favourite DOS games without editing configuration files, without typing command line parameters, without mounting folders, without learning a confusing frontend; without doing any more than clicking on a game in Finder.<br />
<br />
: '''Website''': http://boxer.washboardabs.net/<br />
<br />
<br />
<br />
* '''Petit dosbox'''<br />
<br />
: '''Description: ''' Petit dosbox is a very easy to use interface to help you running the emulator, and will keep your last configuration for the next time you use it.<br />
<br />
: '''Website''': http://web.jet.es/guilly/slouc/software_petitdosbox.html<br />
<br />
<br />
<br />
=== Linux Only ===<br />
<br />
<br />
<br />
* '''pyDOSBox'''<br />
<br />
: '''Description: ''' The program is still in alpha stage but usable.<br />
<br />
: '''Website''': http://www.panayotis.com/prog/scripts/pydosbox/index.html</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Frontend_Comparison&diff=134544Frontend Comparison2015-01-05T07:37:34Z<p>Beresford: removed D.O.G and ScudoGR</p>
<hr />
<div>{| class="sortable wikitable"<br />
!Name !!Programming Language !!Source Code !!Active !!Portable !!Multi Platform !!Notes<br />
|-<br />
|DOSBox Game Launcher || Java || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} ||<br />
|-<br />
|D-Fend Reloaded || Delphi || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} ||<br />
|-<br />
|Boxer || Object C || {{Yes}} || {{Yes}} || {{No}} || {{No}} ||<br />
|-<br />
|GR-Lida || C++ (QT) || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} ||<br />
|-<br />
|LaunchBox || .Net || {{No}} || {{Yes}} || {{Yes}} || {{No}} ||<br />
|-<br />
|AmpShell || .Net || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} ||<br />
|-<br />
|DosBlaster || .Net || {{Yes}} || {{No}} || {{No}} || {{No}} ||<br />
|-<br />
|D-Box || Java || {{Yes}} || {{No}} || {{No}} || {{Yes}} ||<br />
|-<br />
|DBoxFE || C++ (QT) || {{Yes}} || {{No}} || {{No}} || {{Yes}} ||<br />
|-<br />
|DOSBoxGui || Python || {{No}} || {{No}} || {{No}} || {{Yes}} || Download link is broken<br />
|-<br />
|CBoxRun || .Net || {{No}} || {{No}} || {{Yes}} || {{No}} ||<br />
|-<br />
|DBFrontend || Delphi || {{Yes}} || {{No}} || {{No}} || {{No}} || Run in Windows 98 Compatibility<br />
|-<br />
|DOS Shell || .Net || {{No}} || {{No}} || {{Yes}} || {{No}} ||<br />
|-<br />
|Old Games Launcher || .Net || {{Yes}} || {{No}} || {{No}} || {{No}} ||<br />
|-<br />
|Turbo Dos Box || .Net || {{No}} || {{No}} || {{No}} || {{No}} ||<br />
|-<br />
|Petit DOSBox || Object C || {{No}} || {{No}} || {{No}} || {{No}} || <br />
|-<br />
|pyDOSBox || Python || {{Yes}} || {{No}} || {{No}} || {{No}} ||<br />
|-<br />
|D-Fend || || {{No}} || {{No}} || {{No}} || {{No}} || Discontinued<br />
|-<br />
|DOSBOXer || || {{No}} || {{No}} || {{No}} || {{No}} || Discontinued<br />
|-<br />
|RadNor || Object C || {{No}} || {{No}} || {{No}} || {{No}} || Discontinued<br />
|}</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=DOSBoxFrontends&diff=134543DOSBoxFrontends2015-01-05T07:36:44Z<p>Beresford: /* Windows Only */ removed ScudoGR, website is gone.</p>
<hr />
<div>= Frontends for DOSBox =<br />
<br />
The following frontends will help you run, install and manage your DOS games. Some of them also support other emulators like ScummVM, Windows games, and console emulators. The current most popular frontends are, Boxer for MacOS X, D-Fend Reloaded for Windows, and DBGL which runs on multiple platforms.<br />
<br />
You can also have a look at the [[Frontend Comparison]] page.<br />
<br />
=== Multi Platform ===<br />
<br />
<br />
* '''DBGL''' - DOSBox Game Launcher<br />
<br />
: '''Description: '''An open source frontend for DOSBox, based largely upon the proven interface of D-Fend.<br />
<br />
: '''Platforms: ''' Windows, Linux, OS X<br />
<br />
: '''Website''': http://home.quicknet.nl/qn/prive/blankendaalr/dbgl/<br />
<br />
<br />
<br />
* '''D-Box'''<br />
<br />
: '''Description: ''' An open source frontend for DOSBOX. It tries to distinguish itself from alternatives by having "the right set of features", which means not too few, and not too many features. Includes a fancy "floppy flow" user interface.<br />
<br />
: '''Platforms: ''' Windows, Linux, OS X<br />
<br />
: '''Website''': https://code.google.com/p/dbox/<br />
<br />
<br />
<br />
* '''DBoxFE'''<br />
<br />
: '''Description: ''' DBoxFE creates and manages configuration files for DOSBox. You can create different profiles for your games, etc. Currently in beta.<br />
<br />
: '''Platforms: ''' Windows, Linux<br />
<br />
: '''Website''': http://developer.berlios.de/projects/dboxfe/<br />
<br />
<br />
<br />
* '''DOSBoxGui'''<br />
<br />
: '''Description: ''' A portable DOSBox frontend. Needs Tcl/Tk, which is a free, albeit big (20MB) software compiler that you will need to assemble the program for your operating system.<br />
<br />
: '''Platforms: ''' Windows, Linux<br />
<br />
: '''Website''': http://losfinkos.googlepages.com/dosboxgui<br />
<br />
<br />
<br />
* '''GR-lida'''<br />
<br />
: '''Description: ''' An open source frontend for DOSBox, ScummVM and VDMSound. It can display games using pictureflow, which is a clone of Apples cover flow.<br />
<br />
: '''Platforms: ''' Windows, Linux, OS X<br />
<br />
: '''Website''': http://www.gr-lida.org/ (Website is in Spanish, but the program works in additional languages, including English)<br />
<br />
=== Windows Only ===<br />
<br />
* '''AmpShell'''<br />
: '''Description: ''' The purpose of AmpShell is to make you run games in DOSBox with a simple double click. It saves the time and trouble you can have with DOS commands. Plus, it has a lot of other time-saving features.<br />
<br />
: '''Website''': http://ampshell.tuxfamily.org/<br />
<br />
<br />
* '''CBoxRun'''<br />
<br />
: '''Description: ''' A frontend that emphasizes ease of use. It can automatically download game information and screenshots from Wikipedia, and it has a nice [[dosbox.conf|config file]] editor with help for every field. Requires .NET 3.51.<br />
<br />
: '''Website''': http://cboxrun.wordpress.com/<br />
<br />
<br />
<br />
* '''DBFrontend''' - '''D'''OS'''B'''ox'''Frontend''' <br />
<br />
: '''Description: ''' An open source frontend with a simple interface which allows you to have thumbnails of screen shots so you can easy recognize the game you want to run.<br />
<br />
: '''Website''': http://www.ingoknito.de/produkte/dbfrontend/<br />
<br />
<br />
<br />
* '''D-Fend Reloaded''' - '''D'''OSBox-'''F'''ront'''end''' Reloaded<br />
<br />
: '''Description: ''' An open source frontend for DOSBox, ScummVM and Windows games. The development objective for D-Fend Reloaded was (besides 100% D-Fend compability) to make the program operation more simple with respect to DosBox beginners. Simultaneously more features for administration and configuration became available.<br />
<br />
: '''Website''': http://dfendreloaded.sourceforge.net/<br />
<br />
<br />
<br />
* '''DosBlaster'''<br />
<br />
: '''Description: ''' An open source frontend that offers a simplified view of the DOS games which can be manage easily. <br />
<br />
: '''Website''': http://dosblasterx.sourceforge.net/<br />
<br />
<br />
<br />
* '''DOSShell'''<br />
<br />
: '''Description: ''' Applications launcher, plus convenient Explorer-like entries manager.<br />
<br />
: '''Website''': http://www.loonies.narod.ru/dosshell.htm<br />
<br />
<br />
<br />
* '''Old Games Launcher'''<br />
<br />
: '''Description: ''' Direct Draw games launcher & Dosbox Frontend<br />
<br />
: '''Website''': https://oldgameslauncher.codeplex.com/<br />
<br />
<br />
<br />
* '''Turbo Dos Box'''<br />
<br />
: '''Description: ''' Very simple and small (~100KB no install needed) manager for configuration. Automatically mounts drives and can change all DOSBox options via XML setup, and can right click an EXE/COM/BAT and play it through DosBox by using the default configuration profile in "Right click and play" fashion.<br />
<br />
: '''Website''': http://www.turboirc.com/tdb<br />
<br />
<br />
<br />
* '''LaunchBox'''<br />
<br />
: '''Description: ''' LaunchBox was originally built as an attractive frontend to DOSBox, but has since expanded to support both modern PC games and emulated console platforms. DOSBox will continue to be a main focus for LaunchBox, as will emulation and PC gaming. LaunchBox aims to be the one-stop shop for gaming on your computer, for both modern and historical games.<br />
: '''Website''': http://www.launchbox-app.com<br />
<br />
=== Mac OS X Only ===<br />
<br />
<br />
<br />
* '''Boxer'''<br />
<br />
: '''Description: ''' Boxer makes it easy to run your favourite DOS games without editing configuration files, without typing command line parameters, without mounting folders, without learning a confusing frontend; without doing any more than clicking on a game in Finder.<br />
<br />
: '''Website''': http://boxer.washboardabs.net/<br />
<br />
<br />
<br />
* '''Petit dosbox'''<br />
<br />
: '''Description: ''' Petit dosbox is a very easy to use interface to help you running the emulator, and will keep your last configuration for the next time you use it.<br />
<br />
: '''Website''': http://web.jet.es/guilly/slouc/software_petitdosbox.html<br />
<br />
<br />
<br />
=== Linux Only ===<br />
<br />
<br />
<br />
* '''pyDOSBox'''<br />
<br />
: '''Description: ''' The program is still in alpha stage but usable.<br />
<br />
: '''Website''': http://www.panayotis.com/prog/scripts/pydosbox/index.html <br />
<br />
<br />
<br />
== Incomplete overview of discontinued Frontends ==<br />
<br />
<br />
* '''D-Fend''' - '''D'''OSBox-'''F'''ront'''end''' <br />
<br />
: The largest DOSBox Frontend availabe. This frontend has supports for all '''DOSBox''' features and allows you generate default profiles for your system. It's also the only frontend which supports the unsupported SVN features. Because of its profile system and its intelligent mount system it's great for newbies and people using the SVN version of '''DOSBox'''. *Now supports Screenshot viewing for each Game Profile*<br />
<br />
However recently Anthony announced officially that he stopped his work on D-Fend.<br />
<br />
: '''Website''': http://members.home.nl/mabus<br />
<br />
<br />
<br />
* '''DOSBOXer'''<br />
<br />
: Scott Duensing at Jaeger Technologies has created "DOSBOXer" for Windows. There is no mention of this software on his website anymore.<br />
<br />
: '''Website''': http://www.jaegertech.net/<br />
<br />
<br />
<br />
* '''Radnor'''<br />
<br />
: Sveinbjorn Thordarson has created the frontend "Radnor" for the MacOS X 10.3 or later version of DOSBox. <br />
<br />
: '''Website''': http://www.sveinbjorn.org/radnor</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=DOSBoxFrontends&diff=134542DOSBoxFrontends2015-01-05T07:35:23Z<p>Beresford: /* Windows Only */ removed D.O.G, website is gone.</p>
<hr />
<div>= Frontends for DOSBox =<br />
<br />
The following frontends will help you run, install and manage your DOS games. Some of them also support other emulators like ScummVM, Windows games, and console emulators. The current most popular frontends are, Boxer for MacOS X, D-Fend Reloaded for Windows, and DBGL which runs on multiple platforms.<br />
<br />
You can also have a look at the [[Frontend Comparison]] page.<br />
<br />
=== Multi Platform ===<br />
<br />
<br />
* '''DBGL''' - DOSBox Game Launcher<br />
<br />
: '''Description: '''An open source frontend for DOSBox, based largely upon the proven interface of D-Fend.<br />
<br />
: '''Platforms: ''' Windows, Linux, OS X<br />
<br />
: '''Website''': http://home.quicknet.nl/qn/prive/blankendaalr/dbgl/<br />
<br />
<br />
<br />
* '''D-Box'''<br />
<br />
: '''Description: ''' An open source frontend for DOSBOX. It tries to distinguish itself from alternatives by having "the right set of features", which means not too few, and not too many features. Includes a fancy "floppy flow" user interface.<br />
<br />
: '''Platforms: ''' Windows, Linux, OS X<br />
<br />
: '''Website''': https://code.google.com/p/dbox/<br />
<br />
<br />
<br />
* '''DBoxFE'''<br />
<br />
: '''Description: ''' DBoxFE creates and manages configuration files for DOSBox. You can create different profiles for your games, etc. Currently in beta.<br />
<br />
: '''Platforms: ''' Windows, Linux<br />
<br />
: '''Website''': http://developer.berlios.de/projects/dboxfe/<br />
<br />
<br />
<br />
* '''DOSBoxGui'''<br />
<br />
: '''Description: ''' A portable DOSBox frontend. Needs Tcl/Tk, which is a free, albeit big (20MB) software compiler that you will need to assemble the program for your operating system.<br />
<br />
: '''Platforms: ''' Windows, Linux<br />
<br />
: '''Website''': http://losfinkos.googlepages.com/dosboxgui<br />
<br />
<br />
<br />
* '''GR-lida'''<br />
<br />
: '''Description: ''' An open source frontend for DOSBox, ScummVM and VDMSound. It can display games using pictureflow, which is a clone of Apples cover flow.<br />
<br />
: '''Platforms: ''' Windows, Linux, OS X<br />
<br />
: '''Website''': http://www.gr-lida.org/ (Website is in Spanish, but the program works in additional languages, including English)<br />
<br />
=== Windows Only ===<br />
<br />
* '''AmpShell'''<br />
: '''Description: ''' The purpose of AmpShell is to make you run games in DOSBox with a simple double click. It saves the time and trouble you can have with DOS commands. Plus, it has a lot of other time-saving features.<br />
<br />
: '''Website''': http://ampshell.tuxfamily.org/<br />
<br />
<br />
* '''CBoxRun'''<br />
<br />
: '''Description: ''' A frontend that emphasizes ease of use. It can automatically download game information and screenshots from Wikipedia, and it has a nice [[dosbox.conf|config file]] editor with help for every field. Requires .NET 3.51.<br />
<br />
: '''Website''': http://cboxrun.wordpress.com/<br />
<br />
<br />
<br />
* '''DBFrontend''' - '''D'''OS'''B'''ox'''Frontend''' <br />
<br />
: '''Description: ''' An open source frontend with a simple interface which allows you to have thumbnails of screen shots so you can easy recognize the game you want to run.<br />
<br />
: '''Website''': http://www.ingoknito.de/produkte/dbfrontend/<br />
<br />
<br />
<br />
* '''D-Fend Reloaded''' - '''D'''OSBox-'''F'''ront'''end''' Reloaded<br />
<br />
: '''Description: ''' An open source frontend for DOSBox, ScummVM and Windows games. The development objective for D-Fend Reloaded was (besides 100% D-Fend compability) to make the program operation more simple with respect to DosBox beginners. Simultaneously more features for administration and configuration became available.<br />
<br />
: '''Website''': http://dfendreloaded.sourceforge.net/<br />
<br />
<br />
<br />
* '''DosBlaster'''<br />
<br />
: '''Description: ''' An open source frontend that offers a simplified view of the DOS games which can be manage easily. <br />
<br />
: '''Website''': http://dosblasterx.sourceforge.net/<br />
<br />
<br />
<br />
* '''DOSShell'''<br />
<br />
: '''Description: ''' Applications launcher, plus convenient Explorer-like entries manager.<br />
<br />
: '''Website''': http://www.loonies.narod.ru/dosshell.htm<br />
<br />
<br />
<br />
* '''Old Games Launcher'''<br />
<br />
: '''Description: ''' Direct Draw games launcher & Dosbox Frontend<br />
<br />
: '''Website''': https://oldgameslauncher.codeplex.com/<br />
<br />
<br />
<br />
* '''ScudoGR - ScummVM, Dosbox (and Windows) Game Runner'''<br />
<br />
: '''Description: ''' It's a simple interface to run games for DOSBox, ScummVM and Windows games. Games are created and managed by zip-files, which are easily importable by drag and drop. It uses several configuration files, it manages mounting/unmounting file (by dosbox 'imgmount' command or with daemon tools), and it's language-configurable.<br />
<br />
: '''Website''': http://www.scudogr.it<br />
<br />
<br />
<br />
* '''Turbo Dos Box'''<br />
<br />
: '''Description: ''' Very simple and small (~100KB no install needed) manager for configuration. Automatically mounts drives and can change all DOSBox options via XML setup, and can right click an EXE/COM/BAT and play it through DosBox by using the default configuration profile in "Right click and play" fashion.<br />
<br />
: '''Website''': http://www.turboirc.com/tdb<br />
<br />
<br />
<br />
* '''LaunchBox'''<br />
<br />
: '''Description: ''' LaunchBox was originally built as an attractive frontend to DOSBox, but has since expanded to support both modern PC games and emulated console platforms. DOSBox will continue to be a main focus for LaunchBox, as will emulation and PC gaming. LaunchBox aims to be the one-stop shop for gaming on your computer, for both modern and historical games.<br />
: '''Website''': http://www.launchbox-app.com<br />
<br />
=== Mac OS X Only ===<br />
<br />
<br />
<br />
* '''Boxer'''<br />
<br />
: '''Description: ''' Boxer makes it easy to run your favourite DOS games without editing configuration files, without typing command line parameters, without mounting folders, without learning a confusing frontend; without doing any more than clicking on a game in Finder.<br />
<br />
: '''Website''': http://boxer.washboardabs.net/<br />
<br />
<br />
<br />
* '''Petit dosbox'''<br />
<br />
: '''Description: ''' Petit dosbox is a very easy to use interface to help you running the emulator, and will keep your last configuration for the next time you use it.<br />
<br />
: '''Website''': http://web.jet.es/guilly/slouc/software_petitdosbox.html<br />
<br />
<br />
<br />
=== Linux Only ===<br />
<br />
<br />
<br />
* '''pyDOSBox'''<br />
<br />
: '''Description: ''' The program is still in alpha stage but usable.<br />
<br />
: '''Website''': http://www.panayotis.com/prog/scripts/pydosbox/index.html <br />
<br />
<br />
<br />
== Incomplete overview of discontinued Frontends ==<br />
<br />
<br />
* '''D-Fend''' - '''D'''OSBox-'''F'''ront'''end''' <br />
<br />
: The largest DOSBox Frontend availabe. This frontend has supports for all '''DOSBox''' features and allows you generate default profiles for your system. It's also the only frontend which supports the unsupported SVN features. Because of its profile system and its intelligent mount system it's great for newbies and people using the SVN version of '''DOSBox'''. *Now supports Screenshot viewing for each Game Profile*<br />
<br />
However recently Anthony announced officially that he stopped his work on D-Fend.<br />
<br />
: '''Website''': http://members.home.nl/mabus<br />
<br />
<br />
<br />
* '''DOSBOXer'''<br />
<br />
: Scott Duensing at Jaeger Technologies has created "DOSBOXer" for Windows. There is no mention of this software on his website anymore.<br />
<br />
: '''Website''': http://www.jaegertech.net/<br />
<br />
<br />
<br />
* '''Radnor'''<br />
<br />
: Sveinbjorn Thordarson has created the frontend "Radnor" for the MacOS X 10.3 or later version of DOSBox. <br />
<br />
: '''Website''': http://www.sveinbjorn.org/radnor</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Frontend_Comparison&diff=134541Frontend Comparison2014-12-30T20:49:37Z<p>Beresford: no update to dosblaster in over a year, changing status to not active</p>
<hr />
<div>{| class="sortable wikitable"<br />
!Name !!Programming Language !!Source Code !!Active !!Portable !!Multi Platform !!Notes<br />
|-<br />
|DOSBox Game Launcher || Java || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} ||<br />
|-<br />
|D-Fend Reloaded || Delphi || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} ||<br />
|-<br />
|Boxer || Object C || {{Yes}} || {{Yes}} || {{No}} || {{No}} ||<br />
|-<br />
|GR-Lida || C++ (QT) || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} ||<br />
|-<br />
|LaunchBox || .Net || {{No}} || {{Yes}} || {{Yes}} || {{No}} ||<br />
|-<br />
|AmpShell || .Net || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} ||<br />
|-<br />
|DosBlaster || .Net || {{Yes}} || {{No}} || {{No}} || {{No}} ||<br />
|-<br />
|D-Box || Java || {{Yes}} || {{No}} || {{No}} || {{Yes}} ||<br />
|-<br />
|DBoxFE || C++ (QT) || {{Yes}} || {{No}} || {{No}} || {{Yes}} ||<br />
|-<br />
|DOSBoxGui || Python || {{No}} || {{No}} || {{No}} || {{Yes}} || Download link is broken<br />
|-<br />
|CBoxRun || .Net || {{No}} || {{No}} || {{Yes}} || {{No}} ||<br />
|-<br />
|DBFrontend || Delphi || {{Yes}} || {{No}} || {{No}} || {{No}} || Run in Windows 98 Compatibility<br />
|-<br />
|D.O.G || Delphi || {{No}} || {{No}} || {{No}} || {{No}} ||<br />
|-<br />
|DOS Shell || .Net || {{No}} || {{No}} || {{Yes}} || {{No}} ||<br />
|-<br />
|Old Games Launcher || .Net || {{Yes}} || {{No}} || {{No}} || {{No}} ||<br />
|-<br />
|ScudoGR || || {{No}} || {{No}} || {{No}} || {{No}} || Website is down<br />
|-<br />
|Turbo Dos Box || .Net || {{No}} || {{No}} || {{No}} || {{No}} ||<br />
|-<br />
|Petit DOSBox || Object C || {{No}} || {{No}} || {{No}} || {{No}} || <br />
|-<br />
|pyDOSBox || Python || {{Yes}} || {{No}} || {{No}} || {{No}} ||<br />
|-<br />
|D-Fend || || {{No}} || {{No}} || {{No}} || {{No}} || Discontinued<br />
|-<br />
|DOSBOXer || || {{No}} || {{No}} || {{No}} || {{No}} || Discontinued<br />
|-<br />
|RadNor || Object C || {{No}} || {{No}} || {{No}} || {{No}} || Discontinued<br />
|}</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Frontend_Comparison&diff=134540Frontend Comparison2014-12-30T20:47:03Z<p>Beresford: added ampshell</p>
<hr />
<div>{| class="sortable wikitable"<br />
!Name !!Programming Language !!Source Code !!Active !!Portable !!Multi Platform !!Notes<br />
|-<br />
|DOSBox Game Launcher || Java || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} ||<br />
|-<br />
|D-Fend Reloaded || Delphi || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} ||<br />
|-<br />
|Boxer || Object C || {{Yes}} || {{Yes}} || {{No}} || {{No}} ||<br />
|-<br />
|GR-Lida || C++ (QT) || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} ||<br />
|-<br />
|LaunchBox || .Net || {{No}} || {{Yes}} || {{Yes}} || {{No}} ||<br />
|-<br />
|AmpShell || .Net || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} ||<br />
|-<br />
|DosBlaster || .Net || {{Yes}} || {{Yes}} || {{No}} || {{No}} ||<br />
|-<br />
|D-Box || Java || {{Yes}} || {{No}} || {{No}} || {{Yes}} ||<br />
|-<br />
|DBoxFE || C++ (QT) || {{Yes}} || {{No}} || {{No}} || {{Yes}} ||<br />
|-<br />
|DOSBoxGui || Python || {{No}} || {{No}} || {{No}} || {{Yes}} || Download link is broken<br />
|-<br />
|CBoxRun || .Net || {{No}} || {{No}} || {{Yes}} || {{No}} ||<br />
|-<br />
|DBFrontend || Delphi || {{Yes}} || {{No}} || {{No}} || {{No}} || Run in Windows 98 Compatibility<br />
|-<br />
|D.O.G || Delphi || {{No}} || {{No}} || {{No}} || {{No}} ||<br />
|-<br />
|DOS Shell || .Net || {{No}} || {{No}} || {{Yes}} || {{No}} ||<br />
|-<br />
|Old Games Launcher || .Net || {{Yes}} || {{No}} || {{No}} || {{No}} ||<br />
|-<br />
|ScudoGR || || {{No}} || {{No}} || {{No}} || {{No}} || Website is down<br />
|-<br />
|Turbo Dos Box || .Net || {{No}} || {{No}} || {{No}} || {{No}} ||<br />
|-<br />
|Petit DOSBox || Object C || {{No}} || {{No}} || {{No}} || {{No}} || <br />
|-<br />
|pyDOSBox || Python || {{Yes}} || {{No}} || {{No}} || {{No}} ||<br />
|-<br />
|D-Fend || || {{No}} || {{No}} || {{No}} || {{No}} || Discontinued<br />
|-<br />
|DOSBOXer || || {{No}} || {{No}} || {{No}} || {{No}} || Discontinued<br />
|-<br />
|RadNor || Object C || {{No}} || {{No}} || {{No}} || {{No}} || Discontinued<br />
|}</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=DOSBoxFrontends&diff=134539DOSBoxFrontends2014-12-30T20:45:04Z<p>Beresford: /* Windows Only */ added ampshell</p>
<hr />
<div>= Frontends for DOSBox =<br />
<br />
The following frontends will help you run, install and manage your DOS games. Some of them also support other emulators like ScummVM, Windows games, and console emulators. The current most popular frontends are, Boxer for MacOS X, D-Fend Reloaded for Windows, and DBGL which runs on multiple platforms.<br />
<br />
You can also have a look at the [[Frontend Comparison]] page.<br />
<br />
=== Multi Platform ===<br />
<br />
<br />
* '''DBGL''' - DOSBox Game Launcher<br />
<br />
: '''Description: '''An open source frontend for DOSBox, based largely upon the proven interface of D-Fend.<br />
<br />
: '''Platforms: ''' Windows, Linux, OS X<br />
<br />
: '''Website''': http://home.quicknet.nl/qn/prive/blankendaalr/dbgl/<br />
<br />
<br />
<br />
* '''D-Box'''<br />
<br />
: '''Description: ''' An open source frontend for DOSBOX. It tries to distinguish itself from alternatives by having "the right set of features", which means not too few, and not too many features. Includes a fancy "floppy flow" user interface.<br />
<br />
: '''Platforms: ''' Windows, Linux, OS X<br />
<br />
: '''Website''': https://code.google.com/p/dbox/<br />
<br />
<br />
<br />
* '''DBoxFE'''<br />
<br />
: '''Description: ''' DBoxFE creates and manages configuration files for DOSBox. You can create different profiles for your games, etc. Currently in beta.<br />
<br />
: '''Platforms: ''' Windows, Linux<br />
<br />
: '''Website''': http://developer.berlios.de/projects/dboxfe/<br />
<br />
<br />
<br />
* '''DOSBoxGui'''<br />
<br />
: '''Description: ''' A portable DOSBox frontend. Needs Tcl/Tk, which is a free, albeit big (20MB) software compiler that you will need to assemble the program for your operating system.<br />
<br />
: '''Platforms: ''' Windows, Linux<br />
<br />
: '''Website''': http://losfinkos.googlepages.com/dosboxgui<br />
<br />
<br />
<br />
* '''GR-lida'''<br />
<br />
: '''Description: ''' An open source frontend for DOSBox, ScummVM and VDMSound. It can display games using pictureflow, which is a clone of Apples cover flow.<br />
<br />
: '''Platforms: ''' Windows, Linux, OS X<br />
<br />
: '''Website''': http://www.gr-lida.org/ (Website is in Spanish, but the program works in additional languages, including English)<br />
<br />
=== Windows Only ===<br />
<br />
* '''AmpShell'''<br />
: '''Description: ''' The purpose of AmpShell is to make you run games in DOSBox with a simple double click. It saves the time and trouble you can have with DOS commands. Plus, it has a lot of other time-saving features.<br />
<br />
: '''Website''': http://ampshell.tuxfamily.org/<br />
<br />
<br />
* '''CBoxRun'''<br />
<br />
: '''Description: ''' A frontend that emphasizes ease of use. It can automatically download game information and screenshots from Wikipedia, and it has a nice [[dosbox.conf|config file]] editor with help for every field. Requires .NET 3.51.<br />
<br />
: '''Website''': http://cboxrun.wordpress.com/<br />
<br />
<br />
<br />
* '''DBFrontend''' - '''D'''OS'''B'''ox'''Frontend''' <br />
<br />
: '''Description: ''' An open source frontend with a simple interface which allows you to have thumbnails of screen shots so you can easy recognize the game you want to run.<br />
<br />
: '''Website''': http://www.ingoknito.de/produkte/dbfrontend/<br />
<br />
<br />
<br />
* '''D-Fend Reloaded''' - '''D'''OSBox-'''F'''ront'''end''' Reloaded<br />
<br />
: '''Description: ''' An open source frontend for DOSBox, ScummVM and Windows games. The development objective for D-Fend Reloaded was (besides 100% D-Fend compability) to make the program operation more simple with respect to DosBox beginners. Simultaneously more features for administration and configuration became available.<br />
<br />
: '''Website''': http://dfendreloaded.sourceforge.net/<br />
<br />
<br />
<br />
* '''D.O.G.'''<br />
<br />
: '''Description: ''' A frontend with additional features, such as loading games from zip files, and converting WAV files to MP3. Homepage looks out of date (last update was 2009), with last beta release being from 18-04-2010.<br />
<br />
: '''Website''': http://www.freewebs.com/erikgg/<br />
<br />
<br />
<br />
* '''DosBlaster'''<br />
<br />
: '''Description: ''' An open source frontend that offers a simplified view of the DOS games which can be manage easily. <br />
<br />
: '''Website''': http://dosblasterx.sourceforge.net/<br />
<br />
<br />
<br />
* '''DOSShell'''<br />
<br />
: '''Description: ''' Applications launcher, plus convenient Explorer-like entries manager.<br />
<br />
: '''Website''': http://www.loonies.narod.ru/dosshell.htm<br />
<br />
<br />
<br />
* '''Old Games Launcher'''<br />
<br />
: '''Description: ''' Direct Draw games launcher & Dosbox Frontend<br />
<br />
: '''Website''': https://oldgameslauncher.codeplex.com/<br />
<br />
<br />
<br />
* '''ScudoGR - ScummVM, Dosbox (and Windows) Game Runner'''<br />
<br />
: '''Description: ''' It's a simple interface to run games for DOSBox, ScummVM and Windows games. Games are created and managed by zip-files, which are easily importable by drag and drop. It uses several configuration files, it manages mounting/unmounting file (by dosbox 'imgmount' command or with daemon tools), and it's language-configurable.<br />
<br />
: '''Website''': http://www.scudogr.it<br />
<br />
<br />
<br />
* '''Turbo Dos Box'''<br />
<br />
: '''Description: ''' Very simple and small (~100KB no install needed) manager for configuration. Automatically mounts drives and can change all DOSBox options via XML setup, and can right click an EXE/COM/BAT and play it through DosBox by using the default configuration profile in "Right click and play" fashion.<br />
<br />
: '''Website''': http://www.turboirc.com/tdb<br />
<br />
<br />
<br />
* '''LaunchBox'''<br />
<br />
: '''Description: ''' LaunchBox was originally built as an attractive frontend to DOSBox, but has since expanded to support both modern PC games and emulated console platforms. DOSBox will continue to be a main focus for LaunchBox, as will emulation and PC gaming. LaunchBox aims to be the one-stop shop for gaming on your computer, for both modern and historical games.<br />
: '''Website''': http://www.launchbox-app.com<br />
<br />
=== Mac OS X Only ===<br />
<br />
<br />
<br />
* '''Boxer'''<br />
<br />
: '''Description: ''' Boxer makes it easy to run your favourite DOS games without editing configuration files, without typing command line parameters, without mounting folders, without learning a confusing frontend; without doing any more than clicking on a game in Finder.<br />
<br />
: '''Website''': http://boxer.washboardabs.net/<br />
<br />
<br />
<br />
* '''Petit dosbox'''<br />
<br />
: '''Description: ''' Petit dosbox is a very easy to use interface to help you running the emulator, and will keep your last configuration for the next time you use it.<br />
<br />
: '''Website''': http://web.jet.es/guilly/slouc/software_petitdosbox.html<br />
<br />
<br />
<br />
=== Linux Only ===<br />
<br />
<br />
<br />
* '''pyDOSBox'''<br />
<br />
: '''Description: ''' The program is still in alpha stage but usable.<br />
<br />
: '''Website''': http://www.panayotis.com/prog/scripts/pydosbox/index.html <br />
<br />
<br />
<br />
== Incomplete overview of discontinued Frontends ==<br />
<br />
<br />
* '''D-Fend''' - '''D'''OSBox-'''F'''ront'''end''' <br />
<br />
: The largest DOSBox Frontend availabe. This frontend has supports for all '''DOSBox''' features and allows you generate default profiles for your system. It's also the only frontend which supports the unsupported SVN features. Because of its profile system and its intelligent mount system it's great for newbies and people using the SVN version of '''DOSBox'''. *Now supports Screenshot viewing for each Game Profile*<br />
<br />
However recently Anthony announced officially that he stopped his work on D-Fend.<br />
<br />
: '''Website''': http://members.home.nl/mabus<br />
<br />
<br />
<br />
* '''DOSBOXer'''<br />
<br />
: Scott Duensing at Jaeger Technologies has created "DOSBOXer" for Windows. There is no mention of this software on his website anymore.<br />
<br />
: '''Website''': http://www.jaegertech.net/<br />
<br />
<br />
<br />
* '''Radnor'''<br />
<br />
: Sveinbjorn Thordarson has created the frontend "Radnor" for the MacOS X 10.3 or later version of DOSBox. <br />
<br />
: '''Website''': http://www.sveinbjorn.org/radnor</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Building_DOSBox_with_MinGW&diff=134538Building DOSBox with MinGW2014-12-30T19:48:39Z<p>Beresford: /* Enabling the debugger (You probably don't want this) */ change backslash to forward slash</p>
<hr />
<div>== Building your own version of DOSBox ==<br />
<br />
MinGW is the development environment that this page will show you how to use, an alternative is to use [[Building_DOSBox_with_Visual_C_2008_Express|Microsoft Visual Studio]]<br />
<br />
This page will guide you through setting up MinGW to compile a current (SVN/CVS) version of DOSBox. Because of updates to compilers and libraries, this guide will not work with the 0.74 (the last official release, which is currently over 4 years old) source files.<br />
<br />
== Installing MinGW ==<br />
* Download mingw-get-setup.exe from http://sourceforge.net/projects/mingw/<br />
* Run the installer, choosing the defaults<br />
* Once the '''MinGW Installation Manager''' application starts, select<br />
** mingw-developer-toolkit (msys-base should be automatically added)<br />
** mingw32-base<br />
** mingw32-gcc-g++<br />
* On the installation menu, apply changes, and confirm that you want to apply the changes<br />
<br />
The installation manager is going to download a bunch of files, and at the end, start installing them. Once this is done, you can close the dialog box as well as the installation manager.<br />
<br />
Well done, MinGW is now installed! Let's start it up.<br />
<br />
* Browse to '''C:\MinGW\msys\1.0'''<br />
* Run '''MSYS.BAT'''<br />
<br />
This will start up a DOS prompt like screen, lets mount the base path<br />
mount 'c:\MinGW' /mingw<br />
<br />
You have now completed this section, lets move on to adding the SDL libraries to MinGW.<br />
<br />
== Adding the SDL libraries to MinGW ==<br />
* Download the pre compiled SDL development libraries from here http://www.libsdl.org/release/SDL-devel-1.2.15-mingw32.tar.gz<br />
* Copy the downloaded file to your MSYS home folder, it's going to be something like '''C:\MinGW\msys\1.0\home\Administrator'''<br />
* Switch back to the MSYS command prompt we started earlier<br />
* Lets extract the downloaded files<br />
tar xvf SDL-devel-1.2.15-mingw32.tar.gz<br />
* And now add the files to MinGW<br />
cd SDL-1.2.15<br />
make install-sdl prefix=/mingw<br />
cd ..<br />
<br />
Cool, the SDL libraries have been added to MinGW, onto the next section.<br />
<br />
== Adding Direct Draw support to DOSBox (Optional) ==<br />
If you want to give DOSBox the option to use the DDRAW output option, then we need to add a couple of extra libraries to MinGW<br />
* Download the following file, http://www.libsdl.org/extras/win32/common/directx-devel.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the files (the -C parameter, tells tar where to extract the files to)<br />
tar xvf directx-devel.tar.gz -C /mingw<br />
<br />
== Adding networking support to DOSBox (Optional) ==<br />
These steps show you how to add the SDL_net libraries to MinGW, which enable networking and modem for DOSBox. If you aren't going to be using DOSBox for multi player games, then you can probably skip this step.<br />
* Download the SDL_net source files from https://www.libsdl.org/projects/SDL_net/release/SDL_net-1.2.8.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file<br />
tar xvf SDL_net-1.2.8.tar.gz<br />
* Lets configure the libraries<br />
cd SDL_net-1.2.8<br />
./configure --prefix=/mingw<br />
* And now compile them<br />
make<br />
* And then install them (copy the files)<br />
make install<br />
cd ..<br />
<br />
== Adding screenshot support (Optional) ==<br />
This one is a bit tricky because it relies on two libraries, zlib (libpng needs these libraries), and libpng. We are also going to be compiling the libraries statically to keep external DLL's to a minimum.<br />
* Download zlib from here http://sourceforge.net/projects/libpng/files/zlib/1.2.8/zlib-1.2.8.tar.xz/download<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file<br />
tar xvf zlib-1.2.8.tar.gz<br />
* Lets build the static library<br />
cd zlib-1.2.8<br />
make -f win32/Makefile.gcc<br />
* And now copy the files to /mingw<br />
cp libz.a /mingw/lib/<br />
cp zlib.h zconf.h /mingw/include/<br />
cd ..<br />
Cool, that wasn't too hard, onto libpng<br />
* Download libpng from here http://sourceforge.net/projects/libpng/files/libpng16/1.6.13/libpng-1.6.13.tar.gz/download<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file <br />
tar xvf libpng-1.6.13.tar.gz<br />
* Configure the library<br />
cd libpng-1.6.13<br />
./configure --disable-shared --prefix=/mingw<br />
* And now to compile and install the files<br />
make<br />
make install<br />
cd ..<br />
<br />
== Adding support for compressed audio on diskimages (Optional) ==<br />
This is for cue/bin cdrom images with compressed (ogg) audio tracks. We will be adding the libvorbis, libogg, and sdl_sound libraries. <br />
* Download libogg from here http://downloads.xiph.org/releases/ogg/libogg-1.3.2.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file <br />
tar xvf libogg-1.3.2.tar.gz<br />
* Configure the library, disabling shared library files<br />
cd libogg-1.3.2<br />
./configure --disable-shared --prefix=/mingw<br />
* Compile and install the library files<br />
make<br />
make install<br />
cd ..<br />
<br />
* Download libvorbis from here http://downloads.xiph.org/releases/vorbis/libvorbis-1.3.4.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file <br />
tar xvf libvorbis-1.3.4.tar.gz<br />
* Configure the library, disabling shared library files<br />
cd libvorbis-1.3.4<br />
./configure --disable-shared --prefix=/mingw<br />
* Compile and install the library files<br />
make<br />
make install<br />
cd ..<br />
<br />
* Download sdl_sound from here https://www.icculus.org/SDL_sound/downloads/SDL_sound-1.0.3.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file <br />
tar xvf SDL_sound-1.0.3<br />
* Unfortunately sdl_sound isn't going to compile on MinGW so we are going to have to edit some of the source files.<br />
* Using something like Notepad++ (or Wordpad in a pinch), open up '''SDL_sound-1.0.3\decoders\mpglib\mpg123_sdlsound.h'''<br />
* Replace line 8<br />
#include <math.h><br />
* With the following<br />
# define M_PI 3.14159265358979323846<br />
# define M_SQRT2 1.41421356237309504880<br />
# define REAL_IS_FLOAT<br />
# define NEW_DCT9<br />
<br />
# define random rand<br />
# define srandom srand<br />
<br />
* Using something like Notepad++ (or Wordpad in a pinch), open up '''SDL_sound-1.0.3\decoders\timidity\tables.h'''<br />
* Comment out line 23 with two //<br />
//#include <math.h><br />
* The hard part is done, lets configure and compile<br />
cd SDL_sound-1.0.3<br />
./configure --disable-shared --prefix=/mingw LIBS="-lvorbisfile -lvorbis -logg"<br />
make<br />
make install<br />
cd ..<br />
<br />
== Enabling the debugger (You probably don't want this) ==<br />
The debugger is mainly for developers of DOSBox, so they can find out why a game isn't working.<br />
* Download the PDCurses source files from http://sourceforge.net/projects/pdcurses/files/pdcurses/3.4/PDCurses-3.4.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file<br />
tar xvf PDCurses-3.4.tar.gz<br />
* Compile the library<br />
cd PDCurses-3.4/win32<br />
make -f gccwin32.mak DLL=N<br />
* And now copy the files to your /mingw folders<br />
cp pdcurses.a /mingw/lib/libpdcurses.a<br />
cd ..<br />
cp curses.h panel.h /mingw/include/<br />
cd ..<br />
<br />
== Compiling DOSBox ==<br />
* Download the latest official DOSBox SVN source files from here: http://source.dosbox.com/dosboxsvn.tgz<br />
(There are also enhanced SVN versions containing additional fixes and/or features that are not officially part of DOSBox, see [[SVN Builds]] for more details)<br />
* Copy the file to your MSYS home folder<br />
* Extract the file<br />
tar xvf dosboxsvn.tgz<br />
* Let's configure DOSBox, and tell it to use the static C library (-static-libgcc) and C++ library (-static-libstdc++) and stripping the final EXE of debug information (-s)<br />
cd dosbox<br />
./autogen.sh<br />
./configure --enable-core-inline LDFLAGS="-static-libgcc -static-libstdc++ -s"<br />
* For SDL_sound support, you have to extra some extra parameters so that the configure command knows where to find the audio library files (LIBS="-lvorbisfile.....)<br />
./configure --enable-core-inline LDFLAGS="-static-libgcc -static-libstdc++ -s" LIBS="-lvorbisfile -lvorbis -logg"<br />
* If you want to enable debugging (you probably don't)<br />
./configure --enable-core-inline LDFLAGS="-static-libgcc -static-libstdc++ -s" LIBS="-lvorbisfile -lvorbis -logg" --enable-debug<br />
* And now for compiling DOSBox<br />
make<br />
* The last step is to gather all the files together in a folder<br />
** Create a folder with a name of your choosing<br />
** Copy the dosbox.exe file located under the '''dosbox\src''' folder, e.g. '''C:\MinGW\msys\1.0\home\Administrator\dosbox\src''' to the folder you created<br />
** Copy the SDL.dll file located under '''SDL-1.2.15\bin''', e.g. '''C:\MinGW\msys\1.0\home\Administrator\SDL-1.2.15\bin''' to the folder you created<br />
** Optionally, copy the SDL_net.dll file located under '''SDL_net-1.2.8\.libs''', e.g. '''C:\MinGW\msys\1.0\home\Administrator\SDL_net-1.2.8\.libs''' to the folder you created<br />
<br />
Start up DOSBox, and see if it works.</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Building_DOSBox_with_MinGW&diff=134537Building DOSBox with MinGW2014-12-30T19:35:24Z<p>Beresford: added instructions for enabling debug</p>
<hr />
<div>== Building your own version of DOSBox ==<br />
<br />
MinGW is the development environment that this page will show you how to use, an alternative is to use [[Building_DOSBox_with_Visual_C_2008_Express|Microsoft Visual Studio]]<br />
<br />
This page will guide you through setting up MinGW to compile a current (SVN/CVS) version of DOSBox. Because of updates to compilers and libraries, this guide will not work with the 0.74 (the last official release, which is currently over 4 years old) source files.<br />
<br />
== Installing MinGW ==<br />
* Download mingw-get-setup.exe from http://sourceforge.net/projects/mingw/<br />
* Run the installer, choosing the defaults<br />
* Once the '''MinGW Installation Manager''' application starts, select<br />
** mingw-developer-toolkit (msys-base should be automatically added)<br />
** mingw32-base<br />
** mingw32-gcc-g++<br />
* On the installation menu, apply changes, and confirm that you want to apply the changes<br />
<br />
The installation manager is going to download a bunch of files, and at the end, start installing them. Once this is done, you can close the dialog box as well as the installation manager.<br />
<br />
Well done, MinGW is now installed! Let's start it up.<br />
<br />
* Browse to '''C:\MinGW\msys\1.0'''<br />
* Run '''MSYS.BAT'''<br />
<br />
This will start up a DOS prompt like screen, lets mount the base path<br />
mount 'c:\MinGW' /mingw<br />
<br />
You have now completed this section, lets move on to adding the SDL libraries to MinGW.<br />
<br />
== Adding the SDL libraries to MinGW ==<br />
* Download the pre compiled SDL development libraries from here http://www.libsdl.org/release/SDL-devel-1.2.15-mingw32.tar.gz<br />
* Copy the downloaded file to your MSYS home folder, it's going to be something like '''C:\MinGW\msys\1.0\home\Administrator'''<br />
* Switch back to the MSYS command prompt we started earlier<br />
* Lets extract the downloaded files<br />
tar xvf SDL-devel-1.2.15-mingw32.tar.gz<br />
* And now add the files to MinGW<br />
cd SDL-1.2.15<br />
make install-sdl prefix=/mingw<br />
cd ..<br />
<br />
Cool, the SDL libraries have been added to MinGW, onto the next section.<br />
<br />
== Adding Direct Draw support to DOSBox (Optional) ==<br />
If you want to give DOSBox the option to use the DDRAW output option, then we need to add a couple of extra libraries to MinGW<br />
* Download the following file, http://www.libsdl.org/extras/win32/common/directx-devel.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the files (the -C parameter, tells tar where to extract the files to)<br />
tar xvf directx-devel.tar.gz -C /mingw<br />
<br />
== Adding networking support to DOSBox (Optional) ==<br />
These steps show you how to add the SDL_net libraries to MinGW, which enable networking and modem for DOSBox. If you aren't going to be using DOSBox for multi player games, then you can probably skip this step.<br />
* Download the SDL_net source files from https://www.libsdl.org/projects/SDL_net/release/SDL_net-1.2.8.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file<br />
tar xvf SDL_net-1.2.8.tar.gz<br />
* Lets configure the libraries<br />
cd SDL_net-1.2.8<br />
./configure --prefix=/mingw<br />
* And now compile them<br />
make<br />
* And then install them (copy the files)<br />
make install<br />
cd ..<br />
<br />
== Adding screenshot support (Optional) ==<br />
This one is a bit tricky because it relies on two libraries, zlib (libpng needs these libraries), and libpng. We are also going to be compiling the libraries statically to keep external DLL's to a minimum.<br />
* Download zlib from here http://sourceforge.net/projects/libpng/files/zlib/1.2.8/zlib-1.2.8.tar.xz/download<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file<br />
tar xvf zlib-1.2.8.tar.gz<br />
* Lets build the static library<br />
cd zlib-1.2.8<br />
make -f win32/Makefile.gcc<br />
* And now copy the files to /mingw<br />
cp libz.a /mingw/lib/<br />
cp zlib.h zconf.h /mingw/include/<br />
cd ..<br />
Cool, that wasn't too hard, onto libpng<br />
* Download libpng from here http://sourceforge.net/projects/libpng/files/libpng16/1.6.13/libpng-1.6.13.tar.gz/download<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file <br />
tar xvf libpng-1.6.13.tar.gz<br />
* Configure the library<br />
cd libpng-1.6.13<br />
./configure --disable-shared --prefix=/mingw<br />
* And now to compile and install the files<br />
make<br />
make install<br />
cd ..<br />
<br />
== Adding support for compressed audio on diskimages (Optional) ==<br />
This is for cue/bin cdrom images with compressed (ogg) audio tracks. We will be adding the libvorbis, libogg, and sdl_sound libraries. <br />
* Download libogg from here http://downloads.xiph.org/releases/ogg/libogg-1.3.2.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file <br />
tar xvf libogg-1.3.2.tar.gz<br />
* Configure the library, disabling shared library files<br />
cd libogg-1.3.2<br />
./configure --disable-shared --prefix=/mingw<br />
* Compile and install the library files<br />
make<br />
make install<br />
cd ..<br />
<br />
* Download libvorbis from here http://downloads.xiph.org/releases/vorbis/libvorbis-1.3.4.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file <br />
tar xvf libvorbis-1.3.4.tar.gz<br />
* Configure the library, disabling shared library files<br />
cd libvorbis-1.3.4<br />
./configure --disable-shared --prefix=/mingw<br />
* Compile and install the library files<br />
make<br />
make install<br />
cd ..<br />
<br />
* Download sdl_sound from here https://www.icculus.org/SDL_sound/downloads/SDL_sound-1.0.3.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file <br />
tar xvf SDL_sound-1.0.3<br />
* Unfortunately sdl_sound isn't going to compile on MinGW so we are going to have to edit some of the source files.<br />
* Using something like Notepad++ (or Wordpad in a pinch), open up '''SDL_sound-1.0.3\decoders\mpglib\mpg123_sdlsound.h'''<br />
* Replace line 8<br />
#include <math.h><br />
* With the following<br />
# define M_PI 3.14159265358979323846<br />
# define M_SQRT2 1.41421356237309504880<br />
# define REAL_IS_FLOAT<br />
# define NEW_DCT9<br />
<br />
# define random rand<br />
# define srandom srand<br />
<br />
* Using something like Notepad++ (or Wordpad in a pinch), open up '''SDL_sound-1.0.3\decoders\timidity\tables.h'''<br />
* Comment out line 23 with two //<br />
//#include <math.h><br />
* The hard part is done, lets configure and compile<br />
cd SDL_sound-1.0.3<br />
./configure --disable-shared --prefix=/mingw LIBS="-lvorbisfile -lvorbis -logg"<br />
make<br />
make install<br />
cd ..<br />
<br />
== Enabling the debugger (You probably don't want this) ==<br />
The debugger is mainly for developers of DOSBox, so they can find out why a game isn't working.<br />
* Download the PDCurses source files from http://sourceforge.net/projects/pdcurses/files/pdcurses/3.4/PDCurses-3.4.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file<br />
tar xvf PDCurses-3.4.tar.gz<br />
* Compile the library<br />
cd PDCurses-3.4\win32<br />
make -f gccwin32.mak DLL=N<br />
* And now copy the files to your /mingw folders<br />
cp pdcurses.a /mingw/lib/libpdcurses.a<br />
cd ..<br />
cp curses.h panel.h /mingw/include/<br />
cd ..<br />
<br />
== Compiling DOSBox ==<br />
* Download the latest official DOSBox SVN source files from here: http://source.dosbox.com/dosboxsvn.tgz<br />
(There are also enhanced SVN versions containing additional fixes and/or features that are not officially part of DOSBox, see [[SVN Builds]] for more details)<br />
* Copy the file to your MSYS home folder<br />
* Extract the file<br />
tar xvf dosboxsvn.tgz<br />
* Let's configure DOSBox, and tell it to use the static C library (-static-libgcc) and C++ library (-static-libstdc++) and stripping the final EXE of debug information (-s)<br />
cd dosbox<br />
./autogen.sh<br />
./configure --enable-core-inline LDFLAGS="-static-libgcc -static-libstdc++ -s"<br />
* For SDL_sound support, you have to extra some extra parameters so that the configure command knows where to find the audio library files (LIBS="-lvorbisfile.....)<br />
./configure --enable-core-inline LDFLAGS="-static-libgcc -static-libstdc++ -s" LIBS="-lvorbisfile -lvorbis -logg"<br />
* If you want to enable debugging (you probably don't)<br />
./configure --enable-core-inline LDFLAGS="-static-libgcc -static-libstdc++ -s" LIBS="-lvorbisfile -lvorbis -logg" --enable-debug<br />
* And now for compiling DOSBox<br />
make<br />
* The last step is to gather all the files together in a folder<br />
** Create a folder with a name of your choosing<br />
** Copy the dosbox.exe file located under the '''dosbox\src''' folder, e.g. '''C:\MinGW\msys\1.0\home\Administrator\dosbox\src''' to the folder you created<br />
** Copy the SDL.dll file located under '''SDL-1.2.15\bin''', e.g. '''C:\MinGW\msys\1.0\home\Administrator\SDL-1.2.15\bin''' to the folder you created<br />
** Optionally, copy the SDL_net.dll file located under '''SDL_net-1.2.8\.libs''', e.g. '''C:\MinGW\msys\1.0\home\Administrator\SDL_net-1.2.8\.libs''' to the folder you created<br />
<br />
Start up DOSBox, and see if it works.</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Building_DOSBox_with_MinGW&diff=134536Building DOSBox with MinGW2014-12-30T07:00:06Z<p>Beresford: added correct steps for compiling compressed audio on diskimages</p>
<hr />
<div>== Building your own version of DOSBox ==<br />
<br />
MinGW is the development environment that this page will show you how to use, an alternative is to use [[Building_DOSBox_with_Visual_C_2008_Express|Microsoft Visual Studio]]<br />
<br />
This page will guide you through setting up MinGW to compile a current (SVN/CVS) version of DOSBox. Because of updates to compilers and libraries, this guide will not work with the 0.74 (the last official release, which is currently over 4 years old) source files.<br />
<br />
== Installing MinGW ==<br />
* Download mingw-get-setup.exe from http://sourceforge.net/projects/mingw/<br />
* Run the installer, choosing the defaults<br />
* Once the '''MinGW Installation Manager''' application starts, select<br />
** mingw-developer-toolkit (msys-base should be automatically added)<br />
** mingw32-base<br />
** mingw32-gcc-g++<br />
* On the installation menu, apply changes, and confirm that you want to apply the changes<br />
<br />
The installation manager is going to download a bunch of files, and at the end, start installing them. Once this is done, you can close the dialog box as well as the installation manager.<br />
<br />
Well done, MinGW is now installed! Let's start it up.<br />
<br />
* Browse to '''C:\MinGW\msys\1.0'''<br />
* Run '''MSYS.BAT'''<br />
<br />
This will start up a DOS prompt like screen, lets mount the base path<br />
mount 'c:\MinGW' /mingw<br />
<br />
You have now completed this section, lets move on to adding the SDL libraries to MinGW.<br />
<br />
== Adding the SDL libraries to MinGW ==<br />
* Download the pre compiled SDL development libraries from here http://www.libsdl.org/release/SDL-devel-1.2.15-mingw32.tar.gz<br />
* Copy the downloaded file to your MSYS home folder, it's going to be something like '''C:\MinGW\msys\1.0\home\Administrator'''<br />
* Switch back to the MSYS command prompt we started earlier<br />
* Lets extract the downloaded files<br />
tar xvf SDL-devel-1.2.15-mingw32.tar.gz<br />
* And now add the files to MinGW<br />
cd SDL-1.2.15<br />
make install-sdl prefix=/mingw<br />
cd ..<br />
<br />
Cool, the SDL libraries have been added to MinGW, onto the next section.<br />
<br />
== Adding Direct Draw support to DOSBox (Optional) ==<br />
If you want to give DOSBox the option to use the DDRAW output option, then we need to add a couple of extra libraries to MinGW<br />
* Download the following file, http://www.libsdl.org/extras/win32/common/directx-devel.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the files (the -C parameter, tells tar where to extract the files to)<br />
tar xvf directx-devel.tar.gz -C /mingw<br />
<br />
== Adding networking support to DOSBox (Optional) ==<br />
These steps show you how to add the SDL_net libraries to MinGW, which enable networking and modem for DOSBox. If you aren't going to be using DOSBox for multi player games, then you can probably skip this step.<br />
* Download the SDL_net source files from https://www.libsdl.org/projects/SDL_net/release/SDL_net-1.2.8.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file<br />
tar xvf SDL_net-1.2.8.tar.gz<br />
* Lets configure the libraries<br />
cd SDL_net-1.2.8<br />
./configure --prefix=/mingw<br />
* And now compile them<br />
make<br />
* And then install them (copy the files)<br />
make install<br />
cd ..<br />
<br />
== Adding screenshot support (Optional) ==<br />
This one is a bit tricky because it relies on two libraries, zlib (libpng needs these libraries), and libpng. We are also going to be compiling the libraries statically to keep external DLL's to a minimum.<br />
* Download zlib from here http://sourceforge.net/projects/libpng/files/zlib/1.2.8/zlib-1.2.8.tar.xz/download<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file<br />
tar xvf zlib-1.2.8.tar.gz<br />
* Lets build the static library<br />
cd zlib-1.2.8<br />
make -f win32/Makefile.gcc<br />
* And now copy the files to /mingw<br />
cp libz.a /mingw/lib/<br />
cp zlib.h zconf.h /mingw/include/<br />
cd ..<br />
Cool, that wasn't too hard, onto libpng<br />
* Download libpng from here http://sourceforge.net/projects/libpng/files/libpng16/1.6.13/libpng-1.6.13.tar.gz/download<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file <br />
tar xvf libpng-1.6.13.tar.gz<br />
* Configure the library<br />
cd libpng-1.6.13<br />
./configure --disable-shared --prefix=/mingw<br />
* And now to compile and install the files<br />
make<br />
make install<br />
cd ..<br />
<br />
== Adding support for compressed audio on diskimages (Optional) ==<br />
This is for cue/bin cdrom images with compressed (ogg) audio tracks. We will be adding the libvorbis, libogg, and sdl_sound libraries. <br />
* Download libogg from here http://downloads.xiph.org/releases/ogg/libogg-1.3.2.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file <br />
tar xvf libogg-1.3.2.tar.gz<br />
* Configure the library, disabling shared library files<br />
cd libogg-1.3.2<br />
./configure --disable-shared --prefix=/mingw<br />
* Compile and install the library files<br />
make<br />
make install<br />
cd ..<br />
<br />
* Download libvorbis from here http://downloads.xiph.org/releases/vorbis/libvorbis-1.3.4.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file <br />
tar xvf libvorbis-1.3.4.tar.gz<br />
* Configure the library, disabling shared library files<br />
cd libvorbis-1.3.4<br />
./configure --disable-shared --prefix=/mingw<br />
* Compile and install the library files<br />
make<br />
make install<br />
cd ..<br />
<br />
* Download sdl_sound from here https://www.icculus.org/SDL_sound/downloads/SDL_sound-1.0.3.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file <br />
tar xvf SDL_sound-1.0.3<br />
* Unfortunately sdl_sound isn't going to compile on MinGW so we are going to have to edit some of the source files.<br />
* Using something like Notepad++ (or Wordpad in a pinch), open up '''SDL_sound-1.0.3\decoders\mpglib\mpg123_sdlsound.h'''<br />
* Replace line 8<br />
#include <math.h><br />
* With the following<br />
# define M_PI 3.14159265358979323846<br />
# define M_SQRT2 1.41421356237309504880<br />
# define REAL_IS_FLOAT<br />
# define NEW_DCT9<br />
<br />
# define random rand<br />
# define srandom srand<br />
<br />
* Using something like Notepad++ (or Wordpad in a pinch), open up '''SDL_sound-1.0.3\decoders\timidity\tables.h'''<br />
* Comment out line 23 with two //<br />
//#include <math.h><br />
* The hard part is done, lets configure and compile<br />
cd SDL_sound-1.0.3<br />
./configure --disable-shared --prefix=/mingw LIBS="-lvorbisfile -lvorbis -logg"<br />
make<br />
make install<br />
cd ..<br />
<br />
== Compiling DOSBox ==<br />
* Download the latest official DOSBox SVN source files from here: http://source.dosbox.com/dosboxsvn.tgz<br />
(There are also enhanced SVN versions containing additional fixes and/or features that are not officially part of DOSBox, see [[SVN Builds]] for more details)<br />
* Copy the file to your MSYS home folder<br />
* Extract the file<br />
tar xvf dosboxsvn.tgz<br />
* Let's configure DOSBox, and tell it to use the static C library (-static-libgcc) and C++ library (-static-libstdc++) and stripping the final EXE of debug information (-s)<br />
cd dosbox<br />
./autogen.sh<br />
./configure LDFLAGS="-static-libgcc -static-libstdc++ -s"<br />
* For SDL_sound support, you have to extra some extra parameters so that the configure command knows where to find the audio library files (LIBS="-lvorbisfile.....)<br />
./configure LDFLAGS="-static-libgcc -static-libstdc++ -s" LIBS="-lvorbisfile -lvorbis -logg"<br />
* And now for compiling DOSBox<br />
make<br />
* The last step is to gather all the files together in a folder<br />
** Create a folder with a name of your choosing<br />
** Copy the dosbox.exe file located under the '''dosbox\src''' folder, e.g. '''C:\MinGW\msys\1.0\home\Administrator\dosbox\src''' to the folder you created<br />
** Copy the SDL.dll file located under '''SDL-1.2.15\bin''', e.g. '''C:\MinGW\msys\1.0\home\Administrator\SDL-1.2.15\bin''' to the folder you created<br />
** Optionally, copy the SDL_net.dll file located under '''SDL_net-1.2.8\.libs''', e.g. '''C:\MinGW\msys\1.0\home\Administrator\SDL_net-1.2.8\.libs''' to the folder you created<br />
<br />
Start up DOSBox, and see if it works.</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Building_DOSBox_with_MinGW&diff=134535Building DOSBox with MinGW2014-12-30T06:46:38Z<p>Beresford: Undo revision 134534 by Beresford (talk)</p>
<hr />
<div>== Building your own version of DOSBox ==<br />
<br />
MinGW is the development environment that this page will show you how to use, an alternative is to use [[Building_DOSBox_with_Visual_C_2008_Express|Microsoft Visual Studio]]<br />
<br />
This page will guide you through setting up MinGW to compile a current (SVN/CVS) version of DOSBox. Because of updates to compilers and libraries, this guide will not work with the 0.74 (the last official release, which is currently over 4 years old) source files.<br />
<br />
== Installing MinGW ==<br />
* Download mingw-get-setup.exe from http://sourceforge.net/projects/mingw/<br />
* Run the installer, choosing the defaults<br />
* Once the '''MinGW Installation Manager''' application starts, select<br />
** mingw-developer-toolkit (msys-base should be automatically added)<br />
** mingw32-base<br />
** mingw32-gcc-g++<br />
* On the installation menu, apply changes, and confirm that you want to apply the changes<br />
<br />
The installation manager is going to download a bunch of files, and at the end, start installing them. Once this is done, you can close the dialog box as well as the installation manager.<br />
<br />
Well done, MinGW is now installed! Let's start it up.<br />
<br />
* Browse to '''C:\MinGW\msys\1.0'''<br />
* Run '''MSYS.BAT'''<br />
<br />
This will start up a DOS prompt like screen, lets mount the base path<br />
mount 'c:\MinGW' /mingw<br />
<br />
You have now completed this section, lets move on to adding the SDL libraries to MinGW.<br />
<br />
== Adding the SDL libraries to MinGW ==<br />
* Download the pre compiled SDL development libraries from here http://www.libsdl.org/release/SDL-devel-1.2.15-mingw32.tar.gz<br />
* Copy the downloaded file to your MSYS home folder, it's going to be something like '''C:\MinGW\msys\1.0\home\Administrator'''<br />
* Switch back to the MSYS command prompt we started earlier<br />
* Lets extract the downloaded files<br />
tar xvf SDL-devel-1.2.15-mingw32.tar.gz<br />
* And now add the files to MinGW<br />
cd SDL-1.2.15<br />
make install-sdl prefix=/mingw<br />
cd ..<br />
<br />
Cool, the SDL libraries have been added to MinGW, onto the next section.<br />
<br />
== Adding Direct Draw support to DOSBox (Optional) ==<br />
If you want to give DOSBox the option to use the DDRAW output option, then we need to add a couple of extra libraries to MinGW<br />
* Download the following file, http://www.libsdl.org/extras/win32/common/directx-devel.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the files (the -C parameter, tells tar where to extract the files to)<br />
tar xvf directx-devel.tar.gz -C /mingw<br />
<br />
== Adding networking support to DOSBox (Optional) ==<br />
These steps show you how to add the SDL_net libraries to MinGW, which enable networking and modem for DOSBox. If you aren't going to be using DOSBox for multi player games, then you can probably skip this step.<br />
* Download the SDL_net source files from https://www.libsdl.org/projects/SDL_net/release/SDL_net-1.2.8.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file<br />
tar xvf SDL_net-1.2.8.tar.gz<br />
* Lets configure the libraries<br />
cd SDL_net-1.2.8<br />
./configure --prefix=/mingw<br />
* And now compile them<br />
make<br />
* And then install them (copy the files)<br />
make install<br />
cd ..<br />
<br />
== Adding screenshot support (Optional) ==<br />
This one is a bit tricky because it relies on two libraries, zlib (libpng needs these libraries), and libpng. We are also going to be compiling the libraries statically to keep external DLL's to a minimum.<br />
* Download zlib from here http://sourceforge.net/projects/libpng/files/zlib/1.2.8/zlib-1.2.8.tar.xz/download<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file<br />
tar xvf zlib-1.2.8.tar.gz<br />
* Lets build the static library<br />
cd zlib-1.2.8<br />
make -f win32/Makefile.gcc<br />
* And now copy the files to /mingw<br />
cp libz.a /mingw/lib/<br />
cp zlib.h zconf.h /mingw/include/<br />
cd ..<br />
Cool, that wasn't too hard, onto libpng<br />
* Download libpng from here http://sourceforge.net/projects/libpng/files/libpng16/1.6.13/libpng-1.6.13.tar.gz/download<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file <br />
tar xvf libpng-1.6.13.tar.gz<br />
* Configure the library<br />
cd libpng-1.6.13<br />
./configure --disable-shared --prefix=/mingw<br />
* And now to compile and install the files<br />
make<br />
make install<br />
cd ..<br />
<br />
== Compiling DOSBox ==<br />
* Download the latest official DOSBox SVN source files from here: http://source.dosbox.com/dosboxsvn.tgz<br />
(There are also enhanced SVN versions containing additional fixes and/or features that are not officially part of DOSBox, see [[SVN Builds]] for more details)<br />
* Copy the file to your MSYS home folder<br />
* Extract the file<br />
tar xvf dosboxsvn.tgz<br />
* Let's configure it<br />
cd dosbox<br />
./autogen.sh<br />
./configure LDFLAGS="-static-libgcc -static-libstdc++ -s"<br />
* And now for compiling DOSBox<br />
make<br />
* The last step is to gather all the files together in a folder<br />
** Create a folder with a name of your choosing<br />
** Copy the dosbox.exe file located under the '''dosbox\src''' folder, e.g. '''C:\MinGW\msys\1.0\home\Administrator\dosbox\src''' to the folder you created<br />
** Copy the SDL.dll file located under '''SDL-1.2.15\bin''', e.g. '''C:\MinGW\msys\1.0\home\Administrator\SDL-1.2.15\bin''' to the folder you created<br />
** Optionally, copy the SDL_net.dll file located under '''SDL_net-1.2.8\.libs''', e.g. '''C:\MinGW\msys\1.0\home\Administrator\SDL_net-1.2.8\.libs''' to the folder you created<br />
<br />
Start up DOSBox, and see if it works.</div>Beresfordhttps://www.dosbox.com/wiki/index.php?title=Building_DOSBox_with_MinGW&diff=134534Building DOSBox with MinGW2014-12-30T06:44:48Z<p>Beresford: Reverted edits by Beresford (talk) to last revision by Wengier</p>
<hr />
<div>== Building your own version of DOSBox ==<br />
<br />
MinGW is the development environment that this page will show you how to use, an alternative is to use [[Building_DOSBox_with_Visual_C_2008_Express|Microsoft Visual Studio]]<br />
<br />
This page will guide you through setting up MinGW to compile a current (SVN/CVS) version of DOSBox. Because of updates to compilers and libraries, this guide will not work with the 0.74 (the last official release, which is currently over 4 years old) source files.<br />
<br />
== Installing MinGW ==<br />
* Download mingw-get-setup.exe from http://sourceforge.net/projects/mingw/<br />
* Run the installer, choosing the defaults<br />
* Once the '''MinGW Installation Manager''' application starts, select<br />
** mingw-developer-toolkit (msys-base should be automatically added)<br />
** mingw32-base<br />
** mingw32-gcc-g++<br />
* On the installation menu, apply changes, and confirm that you want to apply the changes<br />
<br />
The installation manager is going to download a bunch of files, and at the end, start installing them. Once this is done, you can close the dialog box as well as the installation manager.<br />
<br />
Well done, MinGW is now installed! Let's start it up.<br />
<br />
* Browse to '''C:\MinGW\msys\1.0'''<br />
* Run '''MSYS.BAT'''<br />
<br />
This will start up a DOS prompt like screen, lets mount the base path<br />
mount 'c:\MinGW' /mingw<br />
<br />
You have now completed this section, lets move on to adding the SDL libraries to MinGW.<br />
<br />
== Adding the SDL libraries to MinGW ==<br />
* Download the pre compiled SDL development libraries from here http://www.libsdl.org/release/SDL-devel-1.2.15-mingw32.tar.gz<br />
* Copy the downloaded file to your MSYS home folder, it's going to be something like '''C:\MinGW\msys\1.0\home\Administrator'''<br />
* Switch back to the MSYS command prompt we started earlier<br />
* Lets extract the downloaded files<br />
tar xvf SDL-devel-1.2.15-mingw32.tar.gz<br />
* And now add the files to MinGW<br />
cd SDL-1.2.15<br />
make install-sdl --prefix=/mingw<br />
cd ..<br />
<br />
Cool, the SDL libraries have been added to MinGW, onto the next section.<br />
<br />
== Adding Direct Draw support to DOSBox (Optional) ==<br />
If you want to give DOSBox the option to use the DDRAW output option, then we need to add a couple of extra libraries to MinGW<br />
* Download the following file, http://www.libsdl.org/extras/win32/common/directx-devel.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the files (the -C parameter, tells tar where to extract the files to)<br />
tar xvf directx-devel.tar.gz -C /mingw<br />
<br />
== Adding SDL_net libraries to MinGW (Optional) ==<br />
SDL_net gives DOSBox networking support, if you aren't going to be using DOSBox for multi player games, then you can probably skip this step.<br />
* Download the SDL_net source files from https://www.libsdl.org/projects/SDL_net/release/SDL_net-1.2.8.tar.gz<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file<br />
tar xvf SDL_net-1.2.8.tar.gz<br />
* Lets configure the libraries<br />
cd SDL_net-1.2.8<br />
./configure --prefix=/mingw<br />
* And now compile them<br />
make<br />
* And then install them (copy the files)<br />
make install<br />
cd ..<br />
<br />
== Adding screenshot support (Optional) ==<br />
This one is a bit tricky because it relies on two libraries, zlib (libpng needs these libraries), and libpng. We are also going to be compiling the libraries statically to keep external DLL's to a minimum.<br />
* Download zlib from here http://sourceforge.net/projects/libpng/files/zlib/1.2.8/zlib-1.2.8.tar.xz/download<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file<br />
tar xvf zlib-1.2.8.tar.gz<br />
* Lets build the static library<br />
cd zlib-1.2.8<br />
make -f win32/Makefile.gcc<br />
* And now copy the files to /mingw<br />
cp libz.a /mingw/lib/<br />
cp zlib.h zconf.h /mingw/include/<br />
cd ..<br />
Cool, that wasn't too hard, onto libpng<br />
* Download libpng from here http://sourceforge.net/projects/libpng/files/libpng16/1.6.13/libpng-1.6.13.tar.gz/download<br />
* Copy the downloaded file to your MSYS home folder<br />
* Switch to the MSYS command prompt<br />
* Extract the file <br />
tar xvf libpng-1.6.13.tar.gz<br />
* Configure the library<br />
cd libpng-1.6.13<br />
./configure --disable-shared --prefix=/mingw<br />
* And now to compile and install the files<br />
make<br />
make install<br />
cd ..<br />
<br />
== Compiling DOSBox ==<br />
* Download the latest official DOSBox SVN source files from here: http://source.dosbox.com/dosboxsvn.tgz<br />
(There are also enhanced SVN versions containing additional fixes and/or features that are not officially part of DOSBox, see [[SVN Builds]] for more details)<br />
* Copy the file to your MSYS home folder<br />
* Extract the file<br />
tar xvf dosboxsvn.tgz<br />
* Let's configure it<br />
cd dosbox<br />
./autogen.sh<br />
./configure LDFLAGS="-static-libgcc -static-libstdc++ -s"<br />
* And now for compiling DOSBox<br />
make<br />
* The last step is to gather all the files together in a folder<br />
** Create a folder with a name of your choosing<br />
** Copy the dosbox.exe file located under the '''dosbox\src''' folder, e.g. '''C:\MinGW\msys\1.0\home\Administrator\dosbox\src''' to the folder you created<br />
** Copy the SDL.dll file located under '''SDL-1.2.15\bin''', e.g. '''C:\MinGW\msys\1.0\home\Administrator\SDL-1.2.15\bin''' to the folder you created<br />
** Optionally, copy the SDL_net.dll file located under '''SDL_net-1.2.8\.libs''', e.g. '''C:\MinGW\msys\1.0\home\Administrator\SDL_net-1.2.8\.libs''' to the folder you created<br />
<br />
Start up DOSBox, and see if it works.</div>Beresford