http://www.dosbox.com/wiki/api.php?action=feedcontributions&user=Mapto&feedformat=atomDOSBoxWiki - User contributions [en]2024-03-28T12:32:53ZUser contributionsMediaWiki 1.34.1http://www.dosbox.com/wiki/index.php?title=Dosbox.conf&diff=3218Dosbox.conf2009-12-04T19:24:09Z<p>Mapto: /* Linux */</p>
<hr />
<div>'''dosbox.conf''' is a configuration file that DOSBox can use globally and/or locally per game (and settings that are left out are taken from the global file). It contains various system settings and initialization values that define your emulated environment. Everything can be controlled by editing this file or if you like through more graphically oriented [[DOSBoxFrontends|Front Ends]]. You can also [[Dosbox.conf#Creation and Location |create]] separate '''dosbox.conf''' files for multiple host environments (which is helpful in playing various DOS games that expect various types of hardware).<br />
<br />
The configuration file is broken into separate [[Dosbox.conf#Sections |sections]] which contain section settings. Many of these settings do not need to be fully understood to configure DOSBox, but it is helpful to know where to look. You should also be aware that anything to the right of the '''#''' to the end of the line is considered a comment as is totally ignored by DOSBox when it loads.<br />
<br />
== Creation and Location ==<br />
Depending on the version or host OS, the dosbox.conf file is located either inside the [[user profile folder]] or inside the same folder as the [[DOSBox binary]].<br />
<br />
=== Windows Vista ===<br />
Dosbox.conf is created automatically in the Windows [[user profile folder]] (e.g. ''{system drive}'':\Users\''{username}''\AppData\Local\DOSBox\. For version 0.73 it is named ''dosbox-0.73.conf''. The location is indicated by the DOSBox Status Window upon startup.<br />
<br />
===Linux===<br />
For Linux the configfile is created on the first run in ~/.dosbox/<br />
The name is dosbox-version.conf where version is currently 0.73<br />
<br />
On Ubuntu in the dosbox man file it is written:<br />
Configuration and language files use a format similar to Windows .ini<br />
files. First ~/.dosboxrc (if present) will be loaded. If no config‐<br />
file is specified at the commandline, a file named dosbox.conf (if<br />
present in the current directory) will be loaded automatically after‐<br />
wards. If a configfile is specified at the commandline that one will be<br />
used instead.<br />
<br />
===Mac OS X===<br />
If you are using Mac OS X, a preferences file will be created for you on the first time you run DOSBox (as of version 0.73). This file contains the same system settings and initialization values as the '''dosbox.conf''' file on other systems.<br />
<br />
It can be found (and modified) at '''<tt>~/Library/Preferences/DOSBox 0.73 Preferences</tt>''', where ~/ is your [[home folder]] (usually <tt>/Macintosh HD/Users/''username''/</tt>). The exact folder name in the [http://en.wikipedia.org/wiki/Finder_(software) Finder] may vary, depending on the language you use for OS X.<br />
<br />
== Sections ==<br />
<br />
=== [sdl] ===<br />
{{:Configuration:SDL}}<br />
<br />
=== [dosbox] ===<br />
{{:Configuration:DOSBox}}<br />
<br />
=== [render] ===<br />
{{:Configuration:RENDER}}<br />
<br />
=== [cpu] ===<br />
{{:Configuration:CPU}}<br />
<br />
=== [mixer] ===<br />
{{:Configuration:Mixer}}(see [[Sound]])<br />
:Here you can define the quality of emulated audio.<br />
<br />
=== [midi] ===<br />
{{:Configuration:MIDI}} (see [[Sound]])<br />
:Here you can define any MIDI related settings. The term MIDI is commonly used to refer to background music found in games, but specifically it refers to synthesizer audio (which can be passed directly from emulated games to modern hardware.<br />
<br />
=== [sblaster] ===<br />
{{:Configuration:SBlaster}}(see [[Sound]])<br />
:Sound Blaster related settings.<br />
<br />
=== [gus] ===<br />
{{:Configuration:GUS}} (see [[Sound]])<br />
:Gravis Ultra Sound related settings.<br />
<br />
=== [speaker] ===<br />
{{:Configuration:PCSpeaker}} (see [[Sound]])<br />
:PC Speaker related settings.<br />
<br />
=== [joystick] ===<br />
{{:Configuration:Joystick}} (see [[Sound]])<br />
:Joystick related settings.<br />
<br />
=== [serial] ===<br />
{{:Configuration:SerialPort}}<br />
<br />
=== [dos] ===<br />
{{:Configuration:DOS}}<br />
<br />
=== [ipx] ===<br />
{{:Configuration:IPX}}<br />
:[[IPX|IPX Networking]] related settings.<br />
<br />
=== [autoexec] ===<br />
{{:Configuration:AUTOEXEC}}<br />
<br />
==Recommendations==<br />
<br />
Different games will naturally work best with different configuration settings. Something to consider is to define a conf file for each game that will set the appropriate configurations and start the game for you. Then, create a shortcut such as DOSBox.exe -conf "DOSbox-GameName.conf" so that you can start your game in the least possible number of steps.</div>Mapto