DOSBox

---

title: "DOSBox" type: doc version: 1 created: 2026-02-28 author: "Wikipedia contributors" status: active scope: public tags: ["2002-software", "beos-software", "cross-platform-free-software", "dos-emulators", "free-software-programmed-in-c++", "free-software-that-uses-sdl", "macos-emulation-software", "linux-emulation-software", "portable-software", "risc-os-emulation-software", "solaris-software", "windows-emulation-software", "x86-emulators", "free-emulation-software", "software-using-the-gnu-general-public-license"] description: "Free MS-DOS emulator" topic_path: "technology/operating-systems" source: "https://en.wikipedia.org/wiki/DOSBox" license: "CC BY-SA 4.0" wikipedia_page_id: 0 wikipedia_revision_id: 0

::summary Free MS-DOS emulator ::

::data[format=table title="Infobox software"]

Field	Value
name	DOSBox
logo	DOSBox icon.png
logo alt	The icon is a tan square crate with a medium brown framework containing five yellow letters perpendicularly arranged to form two words: DOS horizontally and BOX vertically. Passing behind the 'O' are two darker tan struts diagonally placed in the framework.
logo caption	DOSBox icon
screenshot	DOSBox v0.74-3 ENG 20210129 15 02 07.png
screenshot alt	A command-line interface with a blue text box, followed by a command line. The text box contains text welcoming the user, providing DOSBox instructions, and linking the URL to the official website.
caption	DOSBox 0.74-3 opening screen
author	Peter "Qbix" Veenstra, Sjoerd "Harekiet" van der Berg
developer	The DOSBox Team
repo
programming language	C++
released
latest release version
latest release date
latest preview version
operating system	BeOS, FreeBSD, Linux (Debian, Fedora, Gentoo), macOS, RISC OS, Solaris, Windows
language	English (but allows for alternative keyboard layouts)
genre	Virtual machine, emulator
license	GPL-2.0-or-later
website
::

| name = DOSBox | logo = DOSBox icon.png | logo alt = The icon is a tan square crate with a medium brown framework containing five yellow letters perpendicularly arranged to form two words: DOS horizontally and BOX vertically. Passing behind the 'O' are two darker tan struts diagonally placed in the framework. | logo caption = DOSBox icon | screenshot = DOSBox v0.74-3 ENG 20210129 15 02 07.png | screenshot alt = A command-line interface with a blue text box, followed by a command line. The text box contains text welcoming the user, providing DOSBox instructions, and linking the URL to the official website. | caption = DOSBox 0.74-3 opening screen | author = Peter "Qbix" Veenstra, Sjoerd "Harekiet" van der Berg | developer = The DOSBox Team | repo = | programming language = C++ | released = | latest release version = | latest release date = | latest preview version = | latest preview date = | operating system = BeOS, FreeBSD, Linux (Debian, Fedora, Gentoo), macOS, RISC OS, Solaris, Windows
| language = English (but allows for alternative keyboard layouts) | genre = Virtual machine, emulator | license = GPL-2.0-or-later | website =

DOSBox is a free and open-source MS-DOS emulator. It supports running programs primarily video games that are otherwise inaccessible since hardware for running a compatible disk operating system (DOS) is obsolete and generally unavailable today. It was first released in 2002, when DOS technology was becoming obsolete. Its adoption for running DOS games is relatively widespread, partly because of its use in commercial re-releases of games.

Development

Before Windows XP, consumer-oriented versions of Windows were based on MS-DOS. Windows 3.0 and its updates were operating environments that ran on top of MS-DOS, and the Windows 9x series consisted of operating systems that were still based on MS-DOS. These versions of Windows could run DOS applications. Conversely, the Windows NT operating systems were not based on DOS. A member of the series, Windows XP, debuted on October 25, 2001; this version of Windows became the first consumer-oriented version of Windows to not use DOS. Although Windows XP could emulate DOS, it could not run many of its applications as they ran only in real mode to directly access the computer's hardware, and Windows XP's protected mode prevented such direct access for security reasons. MS-DOS continued to receive support until the end of 2001, and all support for any DOS-based Windows operating system ended on July 11, 2006.

The development of DOSBox began around the launch of Windows 2000—a Windows NT system—when its creators, Dutch programmers Peter Veenstra and Sjoerd van der Berg, discovered that the operating system had dropped much of its support for DOS software. The two knew of solutions at the time, but they could not run the applications in windowed mode or scale the graphics. The project was first uploaded to SourceForge and released for beta testing on July 22, 2002.

Features

DOSBox is a command-line program, configured either by a set of command-line arguments or by editing a plain text configuration file. For ease of use, several graphical front ends have been developed by the user community.

While the DOSBox project hopes that one day the emulator will run all programs ever made for the PC, the goal is not yet reached, and as of the latest version the primary focus has been on DOS gaming. The basic version does not support long filenames, most versions of DOS do not support them, and filenames must follow the 8.3 name.extension pattern: a maximum of 8 characters for the name and up to 3 characters for the extension. Otherwise, filenames will be altered to fit the pattern.

There are versions available on the DOSBox website that support long filenames, at the cost of possible incompatibility with some older programs. The focus of the vanilla version is on gaming, and features such as support for Ctrl-Break may be missing. Some of the alternative versions support features not present in the vanilla version such as APM power off, direct parallel port passthrough for printing, and support for East Asian characters. Because DOSBox accesses the host computer's file system, there thus is a risk of DOS malware exploiting the emulator's security vulnerabilities and causing damage to the host machine, although these vulnerabilities continue to be patched with new DOSBox updates.

Users can also capture screenshots and record videos of DOS sessions, although a codec is required to play the videos. It is also possible to record OPL sound card and MIDI commands, as well as save sound output on a WAV file. Keyboard keys and the buttons of a game controller can be mapped to other keys and combinations thereof.

OS emulation

DOSBox is a full-system emulator that provides BIOS interrupts and contains its own internal DOS-like shell. This means that it can be used without owning a license to any real DOS operating system. Most commands that are found in COMMAND.COM are supported, but many of the more advanced commands found in the latest MS-DOS versions are not. In addition to its internal shell, it also supports running image files of games and software originally intended to start without any operating system. Besides emulating DOS, users can also run Windows 1.0 to 3.11 and applications designed for them, as well as versions of Windows within the Windows 9x family.

When the DOSBox application is opened, it automatically mounts to a virtual, permanent Z: drive that stores DOSBox commands and utilities. The reasons for the virtual drive are related to security, but the user can mount a different drive letter in the emulator to a directory, image file, floppy disk drive, or CD-ROM drive on the host to access its data. A configuration file and its AUTOEXEC section can be used to respectively configure DOSBox settings and execute DOS commands at startup.

Hardware emulation

DOSBox is capable of running DOS programs that require the CPU to be in real mode or protected mode. Since DOSBox can emulate its CPU by interpretation, the environment it emulates is completely independent of the host CPU. On systems which provide the x86, ARM, or other RISC instruction sets, however, DOSBox can use dynamic instruction translation to accelerate execution.

DOSBox uses the Simple DirectMedia Layer external library to handle graphics, audio, and input devices. Graphically, it can use the DirectDraw or OpenGL APIs, and can also use bilinear interpolation and scale graphics for computers with modern displays. Graphical emulation includes text mode, Hercules, CGA, EGA, VGA, VESA, S3 Trio 64, and Tandy. Sound emulation includes the PC speaker, AdLib, Gravis Ultrasound, Sound Blaster, Disney Sound Source, Tandy, and MPU-401. However, because DOSBox does not come packaged with Gravis Ultrasound drivers, they need to be installed separately for full support.

DOSBox can simulate serial null modems using the TCP/IP protocol and IPX network tunneling, which allows for DOS multiplayer games using one of them to be played over local area networks or the Internet. It can also simulate the PC joystick port, with limited options being to emulate one joystick with four axes and four buttons; one gamepad with two axes and six buttons; two joysticks each with two axes and two buttons; a Thrustmaster Flight Control System joystick that has three axes, four buttons, and a hat switch; and a CH Flightstick with four axes, six buttons that can be pressed only one at a time, and a hat switch. Newer joysticks and gamepads will need to use one of these configurations to function.

Reception

DOSBox has become the de facto standard for running DOS games. Rock, Paper, Shotgun positively remarked on the project's continual reception of updates, its influence on PC gaming, and some front ends designed to facilitate using it. Freelance writer Michael Reed lauded the quality of scaled graphics and the project's overall focus on compatibility and accurate emulation, but criticized the lack of both save states and user-friendly control over the emulator during runtime, even with the front ends available at the time of his review. DOSBox was named SourceForge's Project of the Month in May 2009 and again in January 2013, making it the first project in the website's history to receive two Project of the Month awards. On the SourceForge website, it reached 10 million downloads on July 21, 2008, and was downloaded more than 25 million times as of October 2015.

Usage

Since January 2011, the developers of the Wine compatibility layer have integrated DOSBox into Wine to facilitate running DOS programs that are not supported natively by the Wine Virtual DOS machine.

Since January 2015, the Internet Archive has added thousands of DOS games to its software library. , the DOS library contained 6,934 games. The collection is provided for "scholarship and research purposes only".

Forks

• Em-DOSBox uses Emscripten to convert the emulator's C++ code to JavaScript, making the games playable in a web browser.
• DOSBox-X aims to be compatible with all pre-2000 DOS and Windows 9x based hardware scenarios.
• DOSBox Staging aims to be a modern continuation of DOSBox; with modern coding practices and advanced features.
• DOSBox Pure is a libretro core that implements DOSBox, with some additional features such as state saving and rewind.
• jDOSBox{{cite web |title=jDOSBox |url=https://github.com/Tennessene/jDOSBox |website=github.com/Tennessene/jDOSBox}} is a pure Java x86 emulator based on DOSBox. It was created to run all DOS games as well as DOSBox, but in the browser (before Java applets were discontinued). In addition, it will boot up Windows 95/98, Windows NT 4.0, Windows XP, ReactOS and some flavors of Linux such as DSL.{{cite web |title=Status - jDosbox |url=https://jdosbox.sourceforge.net/cms |website=jdosbox.sourceforge.net/cms|archive-url=https://web.archive.org/web/20190304011952/http://jdosbox.sourceforge.net/cms |archive-date=March 4, 2019

Commercial

DOSBox has also been both the most used DOS emulator and, because of the straightforward process of making the games work on modern computers, the most popular emulation software for developers re-releasing legacy versions of their games. id Software has used DOSBox to re-release vintage games such as Wolfenstein 3D and Commander Keen on Valve's Steam. In the process, it was reported they violated the program's license, the GNU GPL, by not packaging the license text; the breach, which was reported as an oversight, was promptly resolved. Activision Blizzard has also used it to re-release Sierra Entertainment's DOS games. LucasArts used it to rerelease Star Wars: Dark Forces and Star Wars: TIE Fighter for modern machines on Steam and GOG.com. 2K Games producer Jason Bergman stated the company used DOSBox for Steam rereleases of certain installments of the XCOM series. Bethesda Softworks has recommended DOSBox and provided a link to the DOSBox website on the downloads page for The Elder Scrolls: Arena and The Elder Scrolls II: Daggerfall. It also included DOSBox with both games in The Elder Scrolls Anthology release.

Electronic Arts' Origin client uses DOSBox for the platform's DOS games, and SimCity 2000.

References

Sources

References

1. "DOSBox (old homepage)".
2. "DOSBox, an x86 emulator with DOS".
3. Hoffman, Chris. (May 11, 2014). "PCs Before Windows: What Using MS-DOS Was Actually Like". How-To Geek.
4. Regan, Patrick. (March 8, 2011). "MCTS 70-680 Exam Cram: Microsoft Windows 7, Configuring". [[Pearson Education]].
5. (December 2010). "Microsoft Windows 7 in Depth". [[Que Publishing]].
6. Thurrott, Paul. (April 12, 2006). "Finally, Windows 98/Me Move Towards Retirement". [[Informa]].
7. "Project of the Month, May 2009".
8. Váša, Kryštof. (2013). "Modular Objective-C Run-Time Library". [[Charles University]].
9. (October 4, 2010). "MCTS Guide to Microsoft Windows 7 (Exam # 70-680)". [[Cengage Learning]].
10. "DOSBox Enhanced SVN builds". DOSBox.
11. Ramírez García, Aníbal. (May 2012). "Diseño e implementación de un Sistema Operativo para fines didácticos". [[Charles III University of Madrid]].
12. (November 3, 2006). "Virtualization: From the Desktop to the Enterprise". [[Apress]].
13. Bartel, Alexandre. (October 24, 2019). "DOS Software Security: Is there Anyone Left to Patch a 25-year old Vulnerability?". [[Hack.lu]].
14. Hietala, Otto. (April 26, 2011). "Developing a Game Engine With SDL". [[Kajaani University of Applied Sciences]].
15. (March 2011). "Proceedings of the 42nd ACM technical symposium on Computer science education". [[Association for Computing Machinery]].
16. Konstantelos, Leo. (July 1, 2010). "Preservation of Dynamic & Interactive Content by use of Binary Translation and Virtualisation – a Methodology for Experimentation". [[Humanities Advanced Technology and Information Institute]].
17. Barbera, Diego. (February 15, 2019). "Videogiochi vintage, i migliori emulatori per pc, Mac e Linux". [[TechRadar]].
18. Haines, Nathan. (August 25, 2017). "Beginning Ubuntu for Windows and Mac Users: Start your Journey into Free and Open Source Software". [[Apress]].
19. Koldyrkaev, Nikolay. (January 2008). "Apple Virtualization".
20. (2008-04-30). "Interview with Qbix".
21. Hoffman, Chris. (2015-10-05). "How To Use DOSBox To Run DOS Games and Old Apps".
22. Wolski, David. (June 3, 2020). "DOS-Box: Spiele-Klassiker in Linux wiederbeleben". [[PC-Welt]].
23. Bikoulis, Alexandros. (October 2, 2018). "Flatrate-Gaming à la EA".
24. (August 31, 2010). "Preserving Virtual Worlds Final Report". [[University of Illinois]].
25. Castle, Alex. (August 2010). "Run All Your Old Games Using DOSBox".
26. Edwards, Benj. (June 6, 2020). "How the Gravis PC GamePad Transformed PC Gaming in the '90s". How-To Geek.
27. Aamoth, Doug. (May 9, 2014). "5 Great No-Fuss Sites for Finding Classic Computer Games".
28. Meer, Alec. (May 28, 2009). "DOSBox, We Salute You". [[Rock, Paper, Shotgun]].
29. Reed, Michael. (June 5, 2008). "DOSBox, a multiplatform PC emulator". [[Free Software Magazine]].
30. "Project of the Month, January 2013".
31. Rosenthal, David S. H.. (October 2015). "Emulation & Virtualization as Preservation Strategies". The Andrew W. Mellon Foundation.
32. Pošvic, Kamil. (January 24, 2011). "Wine začíná implementovat DOSBox". Root.cz.
33. Carpenter, Nicole. (October 15, 2019). "Nearly 7,000 games available in MS-DOS archive, including the original goose game". [[Polygon (website).
34. (2014-12-31). "Internet Archive's Terms of Use, Privacy Policy, and Copyright Policy".
35. Machkovech, Sam. (January 6, 2015). "Over 2,300 MS-DOS games now completely free to play at Internet Archive". [[Ars Technica]].
36. "DOSBox ported to Emscripten".
37. (December 2013). "Comparison of DC and MC/DC code coverages". [[Eötvös Loránd University]].
38. (August 14–17, 2017). "Proceedings of the 12th International Conference on the Foundations of Digital Games". [[Association for Computing Machinery]].
39. "DOSBox-X - Accurate DOS emulation for Windows, Linux, macOS, and DOS".
40. (18 December 2022). "joncampbell123/dosbox-x".
41. "DOSBox - Emulation General Wiki".
42. "DOSBox Staging".
43. "DOSBox Pure".
44. (June 29, 2014). "jDosbox".
45. Au, Alan. (June 7, 2011). "Everything Good Old is New Again".
46. Orland, Kyle. (March 20, 2016). "How the demonization of emulation devalues gaming's heritage". [[Ars Technica]].
47. Purchese, Rob. (2007-08-07). "id sorts GPL Steam issue". [[Eurogamer]].
48. Dasgupta, Julian. (July 23, 2009). "Activision Blizzard: Veröffentlicht Sierra-Oldies". [[4Players]].
49. Hefford, Hayden. (November 13, 2019). "The 10 best Star Wars games on PC". [[Rock, Paper, Shotgun]].
50. Bergman, Jason. (2008-09-04). "Comments-morning discussion". [[Shacknews]].
51. Haynes, Jeff. (July 9, 2009). "Bethesda's Free Daggerfall". [[IGN]].
52. Peel, Jeremy. (September 17, 2014). "The Elder Scrolls Anthology is a cross-section of PC gaming history, now available in Europe". [[PCGamesN]].
53. Chalk, Andy. (March 3, 2015). "The original Syndicate is Origin's new On the House freebie". [[PC Gamer]].
54. Walker, John. (December 10, 2014). "Sim City 2000 Is 20 Years Old And Free". [[Rock, Paper, Shotgun]].

::callout[type=info title="Wikipedia Source"] This article was imported from Wikipedia and is available under the Creative Commons Attribution-ShareAlike 4.0 License. Content has been adapted to SurfDoc format. Original contributors can be found on the article history page. ::