Difference between revisions of "DOSBox"

From ArchWiki
Jump to: navigation, search
(added tip to free trapped focus)
m (Style fixes.)
Line 6: Line 6:
 
[http://www.dosbox.com/ DOSBox] is an x86 PC DOS-emulator for running old DOS games or programs.
 
[http://www.dosbox.com/ DOSBox] is an x86 PC DOS-emulator for running old DOS games or programs.
  
==Installation==
+
== Installation ==
[[pacman|Install]] {{Pkg|dosbox}}, available in the [[Official Repositories]].
+
  
==Configuration==
+
[[pacman|Install]] {{Pkg|dosbox}} from the [[official repositories]].
No initial configuration is needed, however the official DOSBox Manual refers to a configuration file named "dosbox.conf". By default that file exists in your '''~/.dosbox''' folder.
+
  
You can also make a new configuration file on a per-application basis by copying dosbox.conf from ~/.dosbox to the directory where your DOS app resides and modifying the settings accordingly. You can also create a a config file automatically as follows:
+
== Configuration ==
  
To create the file, simply run {{ic|dosbox}} without any parameters inside your desired application's folder:
+
No initial configuration is needed, however the official DOSBox manual refers to a configuration file named ''dosbox.conf''. By default that file exists in your {{ic|~/.dosbox}} folder.
 +
 
 +
You can also make a new configuration file on a per-application basis by copying ''dosbox.conf'' from {{ic|~/.dosbox}} to the directory where your DOS app resides and modifying the settings accordingly. You can also create a a config file automatically: simply run {{ic|dosbox}} without any parameters inside your desired application's folder:
 
  $ dosbox
 
  $ dosbox
  
 
Then at the DOS prompt, type:
 
Then at the DOS prompt, type:
  '''Z:\>''' config -wc dosbox.conf
+
  Z:\> config -wc dosbox.conf
  
The configuration file "dosbox.conf" will then be saved in the current directory. Go in a change whatever settings you need.
+
The configuration file ''dosbox.conf'' will then be saved in the current directory. Go in a change whatever settings you need.
  
The configuration options are described in the official DosBox wiki: http://www.dosbox.com/wiki/Dosbox.conf
+
The configuration options are described in the official DosBox wiki: http://www.dosbox.com/wiki/Dosbox.conf.
  
==Usage==
+
== Usage ==
A simple way to run dosbox is to place your DOS game (or its setup files) into a directory and then run dosbox with the directory path appended. For example:
+
 
 +
A simple way to run DOSBox is to place your DOS game (or its setup files) into a directory and then run dosbox with the directory path appended. For example:
 
  $ dosbox ./game-folder/
 
  $ dosbox ./game-folder/
  
You should now have a DOS prompt whose working directory is the one specified above. From there, you can execute the desired program(s):
+
You should now have a DOS prompt whose working directory is the one specified above. From there, you can execute the desired programs:
 +
 
 +
C:\> SETUP.EXE
  
'''C:\>''' SETUP.EXE
+
== Tips ==
  
==Tips==
+
If dosbox traps your focus, use {{ic|CTRL+F10}} to free it.
If dosbox traps your focus, use CTRL-F10 to free it.
+
  
==See also==
+
== See also ==
For more information visit the official DOSBox site: http://www.dosbox.com/
+
  
[http://www.abandonia.com/ Abandonia] - A large repository of old and abandoned DOS games
+
* http://www.dosbox.com/ - The official DOSBox site.
[http://www.dosgames.com/ DosGames.com] - A large repository of DOS games
+
* http://www.abandonia.com/ - Abandonia: large repository of old and abandoned DOS games.
 +
* http://www.dosgames.com/ - DosGames.com: large repository of DOS games.

Revision as of 11:13, 10 September 2013

DOSBox is an x86 PC DOS-emulator for running old DOS games or programs.

Installation

Install dosbox from the official repositories.

Configuration

No initial configuration is needed, however the official DOSBox manual refers to a configuration file named dosbox.conf. By default that file exists in your ~/.dosbox folder.

You can also make a new configuration file on a per-application basis by copying dosbox.conf from ~/.dosbox to the directory where your DOS app resides and modifying the settings accordingly. You can also create a a config file automatically: simply run dosbox without any parameters inside your desired application's folder:

$ dosbox

Then at the DOS prompt, type:

Z:\> config -wc dosbox.conf

The configuration file dosbox.conf will then be saved in the current directory. Go in a change whatever settings you need.

The configuration options are described in the official DosBox wiki: http://www.dosbox.com/wiki/Dosbox.conf.

Usage

A simple way to run DOSBox is to place your DOS game (or its setup files) into a directory and then run dosbox with the directory path appended. For example:

$ dosbox ./game-folder/

You should now have a DOS prompt whose working directory is the one specified above. From there, you can execute the desired programs:

C:\> SETUP.EXE

Tips

If dosbox traps your focus, use CTRL+F10 to free it.

See also