mothcompute
/
com32
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
com32/dosbox-x.conf

1294 lines
97 KiB
Plaintext
Raw Permalink Normal View History

initial commit
2024-01-10 11:13:45 -08:00
# This is the configuration file for DOSBox-X 2023.05.01. (Please use the latest version of DOSBox-X)
# Lines starting with a # are comment lines and are ignored by DOSBox-X.
# They are used to (briefly) document the effect of each option.
# To write out ALL options, use command 'config -all' with -wc or -writeconf options.
[sdl]
# fullscreen: Start DOSBox-X directly in fullscreen. (Press [F11/F12]+F to go back)
# fulldouble: Use double buffering in fullscreen. It can reduce screen flickering, but it can also result in a slow DOSBox-X.
# fullresolution: What resolution to use for fullscreen: original, desktop or a fixed size (e.g. 1024x768).
# Using your monitor's native resolution with aspect=true might give the best results.
# If you end up with small window on a large screen, try an output different from surface.
# windowresolution: Scale the window to this size IF the output device supports hardware scaling.
# (output=surface does not!)
# windowposition: Set the window position at startup in the positionX,positionY format (e.g.: 1300,200).
# The window will be centered with "," (or empty), and will be in the original position with "-".
# display: Specify a screen/display number to use for a multi-screen setup (0 = default).
# output: What video system to use for output (openglnb = OpenGL nearest; openglpp = OpenGL perfect; ttf = TrueType font output).
# Possible values: default, surface, overlay, ttf, opengl, openglnb, openglhq, openglpp, ddraw, direct3d.
# videodriver: Forces a video driver (e.g. windib/windows, directx, x11, fbcon, dummy, etc) for the SDL library to use.
# transparency: Set the transparency of the DOSBox-X screen (both windowed and full-screen modes, on SDL2 and Windows SDL1 builds).
# The valid value is from 0 (no transparency, the default setting) to 90 (high transparency).
# maximize: If set, the DOSBox-X window will be maximized at start (SDL2 and Windows SDL1 builds only; use fullscreen for TTF output).
# autolock: Mouse will automatically lock, if you click on the screen. (Press CTRL-F10 to unlock)
# autolock_feedback: Autolock status feedback type, i.e. visual, auditive, none.
# Possible values: none, beep, flash.
# middle_unlock: Whether you can press the middle mouse button to unlock the mouse when the mouse has been locked.
# If set to "manual", it works only with "autolock=false"; if set to "auto", it works only with "autolock=true".
# Possible values: none, manual, auto, both.
# clip_mouse_button: Select the mouse button or use arrow keys for the shared clipboard copy/paste function.
# The default mouse button is "right", which means using the right mouse button to select text, copy to and paste from the host clipboard.
# Set to "middle" to use the middle mouse button, "arrows" to use arrow keys instead of a mouse button, or "none" to disable this feature.
# For "arrows", press Home key (or Fn+Shift+Left on Mac laptops) to start selection, and End key (or Fn+Shift+Right on Mac laptops) to end selection.
# Possible values: none, middle, right, arrows.
# clip_key_modifier: Change the keyboard modifier for the shared clipboard copy/paste function using a mouse button or arrow keys.
# The default modifier is "shift" (both left and right shift keys). Set to "none" if no modifier is desired.
# Possible values: none, ctrl, lctrl, rctrl, alt, lalt, ralt, shift, lshift, rshift, ctrlalt, ctrlshift, altshift, lctrlalt, lctrlshift, laltshift, rctrlalt, rctrlshift, raltshift.
# clip_paste_bios: Specify whether to use BIOS keyboard functions for the clipboard pasting instead of the keystroke method.
# For pasting clipboard text into Windows 3.x/9x applications (e.g. Notepad), make sure to use the keystroke method.
# Possible values: true, false, 1, 0, default.
# clip_paste_speed: Set keyboard speed for pasting text from the shared clipboard.
# If the default setting of 30 causes lost keystrokes, increase the number.
# Or experiment with decreasing the number for applications that accept keystrokes quickly.
# sensitivity: Mouse sensitivity. The optional second parameter specifies vertical sensitivity (e.g. 100,-50).
# usesystemcursor: Use the mouse cursor of the host system instead of drawing a DOS mouse cursor. Activated when the mouse is not locked.
# mouse_emulation: When is mouse emulated ?
# integration: when not locked
# locked: when locked
# always: every time
# never: at no time
# If disabled, the mouse position in DOSBox-X is exactly where the host OS reports it.
# When using a high DPI mouse, the emulation of mouse movement can noticeably reduce the
# sensitiveness of your device, i.e. the mouse is slower but more precise.
# Possible values: integration, locked, always, never.
# mouse_wheel_key: Convert mouse wheel movements into keyboard presses such as arrow keys.
# 0: disabled; 1: up/down arrows; 2: left/right arrows; 3: PgUp/PgDn keys.
# 4: Ctrl+up/down arrows; 5: Ctrl+left/right arrows; 6: Ctrl+PgUp/PgDn keys.
# 7: Ctrl+W/Z, as supported by text editors like WordStar and MS-DOS EDIT.
# Putting a minus sign in front will disable the conversion for guest systems.
# waitonerror: Wait before closing the console if DOSBox-X has an error.
# priority: Priority levels for DOSBox-X. Second entry behind the comma is for when DOSBox-X is not focused/minimized.
# pause is only valid for the second entry.
# Possible values: lowest, lower, normal, higher, highest, pause.
# mapperfile: File used to load/save the key/event mappings from. Resetmapper only works with the default value.
# usescancodes: Avoid usage of symkeys, in favor of scancodes. Might not work on all operating systems.
# If set to "auto" (default), it is enabled when using non-US keyboards in SDL1 builds.
# Possible values: true, false, 1, 0, auto.
# overscan: Width of the overscan border (0 to 10) for the "surface" output.
# titlebar: Change the string displayed in the DOSBox-X title bar.
# showbasic: If set, DOSBox-X will show basic information including the DOSBox-X version number and current running speed in the title bar.
# showdetails: If set, DOSBox-X will show the cycles count (FPS) and emulation speed relative to realtime in the title bar.
# showmenu: Whether to show the menu bar (if supported). Default true.
#
# Advanced options (see full configuration reference file [dosbox-x.reference.full.conf] for more details):
# -> mapperfile_sdl1; mapperfile_sdl2; forcesquarecorner
#
fullscreen = false
fulldouble = false
fullresolution = desktop
windowresolution = original
windowposition = -
display = 0
output = default
videodriver =
transparency = 0
maximize = false
autolock = false
autolock_feedback = beep
middle_unlock = manual
clip_mouse_button = right
clip_key_modifier = shift
clip_paste_bios = default
clip_paste_speed = 30
sensitivity = 100
usesystemcursor = false
mouse_emulation = locked
mouse_wheel_key = -1
waitonerror = true
priority = higher,normal
mapperfile = mapper-dosbox-x.map
usescancodes = auto
overscan = 0
titlebar =
showbasic = true
showdetails = false
showmenu = true
[log]
# logfile: file where the log messages will be saved to
# debuggerrun: The run mode when the DOSBox-X Debugger starts.
# Possible values: debugger, normal, watch.
#
# Advanced options (see full configuration reference file [dosbox-x.reference.full.conf] for more details):
# -> vga; vgagfx; vgamisc; int10; sblaster; dma_control; fpu; cpu; paging; fcb; files; ioctl; exec; dosmisc; pit; keyboard; pic; mouse; bios; gui; misc; io; pci; sst; int21; fileio
#
logfile =
debuggerrun = debugger
[dosbox]
# language: Select a language file for DOSBox-X to use. Encoded with either UTF-8 or a DOS code page.
# You can set code page either in the language file or with "country" setting in [config] section.
# title: Additional text to place in the title bar of the window.
# fastbioslogo: If set, DOSBox-X will skip the BIOS screen by activating fast BIOS logo mode (without 1-second pause).
# startbanner: If set (default), DOSBox-X will display the welcome banner when it starts.
# bannercolortheme: You can specify a different background color theme for the welcome banner from the default one.
# Possible values: default, black, red, green, yellow, blue, magenta, cyan, white.
# dpi aware: Set this option (auto by default) to indicate to your OS that DOSBox-X is DPI aware.
# If it is not set, Windows Vista/7/8/10 and higher may upscale the DOSBox-X window
# on higher resolution monitors which is probably not what you want.
# Possible values: true, false, 1, 0, auto.
# quit warning: Set this option to indicate whether DOSBox-X should show a warning message when the user tries to close its window.
# If set to auto (default), DOSBox-X will warn if a DOS program, game or a guest system is currently running.
# If set to autofile, DOSBox-X will warn if there are open file handles or a guest system is currently running.
# Possible values: true, false, 1, 0, auto, autofile.
# working directory option: Select an option for DOSBox-X's working directory when it runs.
# autoprompt: DOSBox-X will auto-decide whether to prompt for a working directory.
# config: DOSBox-X will use the primary config file directory as the working directory.
# custom: Specify a working directory via the "working directory default" option.
# default: Similar to autoprompt, but DOSBox-X will ask whether to save the selected folder.
# force: Similar to "custom", while overriding -defaultdir command-line option if used.
# noprompt: DOSBox-X uses the current directory and never prompts for a working directory.
# program: DOSBox-X will use the DOSBox-X program directory as the working directory.
# prompt: DOSBox-X will always ask the user to select a working directory when it runs.
# userconfig: DOSBox-X will use its user configuration directory as the working directory.
# Possible values: autoprompt, config, custom, default, force, noprompt, program, prompt, userconfig.
# working directory default: The default directory to act as DOSBox-X's working directory. See also the setting "working directory option".
# For working directory option=prompt, the specified directory becomes the default directory for the folder selection.
# show advanced options: If set, the Configuration Tool will display all config options (including advanced ones) by default.
# resolve config path: If set to true, DOSBox-X will resolve options containing paths in the config file (except [autoexec] section).
# This includes environment variables (%VAR% [DOS/Windows] or ${VAR} [Linux/macOS] and tilde (~) in Linux/macOS.
# If set to dosvar, DOSBox-X forces to resolve DOS-style environment variables (%VAR%) in all platforms (and tilde).
# If set to tilde, DOSBox-X will only resolve tilde (~) in Linux/macOS but will not resolve environment variables.
# Possible values: true, false, dosvar, tilde, 1, 0.
# hostkey: By default, DOSBox-X uses the mapper-defined host key, which defaults to F11 on Windows and F12 on other platforms.
# You may alternatively specify a host key with this setting and bypass the host key as defined in the mapper.
# This can also be done from the menu ("Main" => "Select host key").
# Possible values: ctrlalt, ctrlshift, altshift, mapper.
# mapper send key: Select the key the mapper SendKey function will send.
# Possible values: winlogo, winmenu, alttab, ctrlesc, ctrlbreak, ctrlaltdel.
# ime: Enables support for the system input methods (IME) for inputting characters in Windows and Linux builds.
# If set to auto, this feature is only enabled if DOSBox-X starts with a Chinese/Japanese/Korean code page.
# Possible values: true, false, 1, 0, auto.
# synchronize time: If set, DOSBox-X will try to automatically synchronize time with the host, unless you decide to change the date/time manually.
# machine: The type of machine DOSBox-X tries to emulate.
# Possible values: mda, cga, cga_mono, cga_rgb, cga_composite, cga_composite2, hercules, hercules_plus, hercules_incolor, hercules_color, tandy, pcjr, pcjr_composite, pcjr_composite2, amstrad, ega, ega200, jega, mcga, vgaonly, svga_s3, svga_s386c928, svga_s3vision864, svga_s3vision868, svga_s3vision964, svga_s3vision968, svga_s3trio32, svga_s3trio64, svga_s3trio64v+, svga_s3virge, svga_s3virgevx, svga_et3000, svga_et4000, svga_paradise, vesa_nolfb, vesa_oldvbe, vesa_oldvbe10, pc98, pc9801, pc9821, svga_ati_egavgawonder, svga_ati_vgawonder, svga_ati_vgawonderplus, svga_ati_vgawonderxl, svga_ati_vgawonderxl24, svga_ati_mach8, svga_ati_mach32, svga_ati_mach64, fm_towns.
# captures: Directory where things like wave, midi, screenshot get captured.
# autosave: Enable the auto-save state feature. Specify a time interval in seconds, and optionally a save slot or start and end save slots.
# For example, "autosave=10 11-20" will set a 10-second time interval for auto-saving, and the save slots used will be between 11 and 20.
# You can additionally specify up to 9 programs for this feature, e.g. "autosave=10 11-20 EDIT:21-30 EDITOR:35" for "EDIT" and "EDITOR".
# Putting a minus sign (-) before the time interval causes the auto-saving function to not be activated at start.
# saveslot: Select the default save slot (1-100) to save/load states.
# savefile: Select the default save file to save/load states. If specified it will be used instead of the save slot.
# saveremark: If set, the save state feature will ask users to enter remarks when saving a state.
# forceloadstate: If set, DOSBox-X will load a saved state even if it finds there is a mismatch in the DOSBox-X version, machine type, program name and/or the memory size.
# a20: A20 gate emulation mode.
# The on/off/on_fake/off_fake options are intended for testing and debugging DOS development,
# or to emulate obscure hardware, or to work around potential extended memory problems with DOS programs.
# on_fake/off_fake are intended to test whether a program carries out a memory test to ensure the A20
# gate is set as intended (as HIMEM.SYS does). If it goes by the gate bit alone, it WILL crash.
# This parameter is also changeable from the builtin A20GATE command.
# fast Emulate A20 gating by remapping the first 64KB @ 1MB boundary (fast, mainline DOSBox behavior)
# mask Emulate A20 gating by masking memory I/O address (accurate)
# off Lock A20 gate off (Software/OS cannot enable A20)
# on Lock A20 gate on (Software/OS cannot disable A20)
# off_fake Lock A20 gate off but allow bit to toggle (hope your DOS game tests the HMA!)
# on_fake Lock A20 gate on but allow bit to toggle
# memsize: Amount of memory DOSBox-X has in megabytes.
# This value is best left at its default to avoid problems with some games,
# although other games and applications may require a higher value.
# Programs that use 286 protected mode like Windows 3.0 in Standard Mode may crash with more than 15MB.
# nocachedir: If set, MOUNT commands will mount with -nocachedir (disable directory caching) by default.
# freesizecap: If set to "cap" (="true"), the value of MOUNT -freesize will apply only if the actual free size is greater than the specified value.
# If set to "relative", the value of MOUNT -freesize will change relative to the specified value.
# If set to "fixed" (="false"), the value of MOUNT -freesize will be a fixed one to be reported all the time.
# Possible values: true, false, fixed, relative, cap, 2, 1, 0.
# convertdrivefat: If set, DOSBox-X will auto-convert mounted non-FAT drives (such as local drives) to FAT format for use with guest systems.
#
# Advanced options (see full configuration reference file [dosbox-x.reference.full.conf] for more details):
# -> disable graphical splash; allow quit after warning; keyboard hook; weitek; bochs debug port e9; video debug at startup; compresssaveparts; show recorded filename; skip encoding unchanged frames; capture chroma format; capture format; shell environment size; private area size; turn off a20 gate on boot; cbus bus clock; isa bus clock; pci bus clock; call binary on reset; unhandled irq handler; call binary on boot; ibm rom basic; rom bios allocation max; rom bios minimum size; irq delay ns; iodelay; iodelay16; iodelay32; acpi; acpi rsd ptr location; acpi sci irq; acpi iobase; acpi reserved size; memsizekb; dos mem limit; isa memory hole at 512kb; reboot delay; memalias; convert fat free space; convert fat timeout; leading colon write protect image; locking disk image mount; unmask keyboard on int 16 read; int16 keyboard polling undocumented cf behavior; allow port 92 reset; enable port 92; enable 1st dma controller; enable 2nd dma controller; allow dma address decrement; enable 128k capable 16-bit dma; enable dma extra page registers; dma page registers write-only; cascade interrupt never in service; cascade interrupt ignore in service; enable slave pic; enable pc nmi mask; allow more than 640kb base memory; enable pci bus
#
language =
title =
fastbioslogo = false
startbanner = true
bannercolortheme = default
dpi aware = auto
quit warning = auto
working directory option = default
working directory default =
show advanced options = false
resolve config path = true
hostkey = mapper
mapper send key = ctrlaltdel
ime = auto
synchronize time = false
machine = svga_s3
captures = capture
autosave =
saveslot = 1
savefile =
saveremark = true
forceloadstate = false
a20 = mask
memsize = 16
nocachedir = false
freesizecap = cap
convertdrivefat = true
[render]
# frameskip: How many frames DOSBox-X skips before drawing one.
# aspect: Aspect ratio correction mode. Can be set to the following values:
# 'false' (default):
# 'direct3d'/opengl outputs: image is simply scaled to full window/fullscreen size, possibly resulting in disproportional image
# 'surface' output: it does no aspect ratio correction (default), resulting in disproportional images if VGA mode pixel ratio is not 4:3
# 'true':
# 'direct3d'/opengl outputs: uses output driver functions to scale / pad image with black bars, correcting output to proportional 4:3 image
# In most cases image degradation should not be noticeable (it all depends on the video adapter and how much the image is upscaled).
# Should have none to negligible impact on performance, mostly being done in hardware
# For the pixel-perfect scaling (output=openglpp), it is recommended to enable this whenever the emulated display has an aspect ratio of 4:3
# 'surface' output: inherits old DOSBox aspect ratio correction method (adjusting rendered image line count to correct output to 4:3 ratio)
# Due to source image manipulation this mode does not mix well with scalers, i.e. multiline scalers like hq2x/hq3x will work poorly
# Slightly degrades visual image quality. Has a tiny impact on performance
# When using xBRZ scaler with 'surface' output, aspect ratio correction is done by the scaler itself, so none of the above apply
# Possible values: false, true, 0, 1, yes, no, nearest, bilinear.
# aspect_ratio: Set the aspect ratio (e.g. 16:9) in the aspect ratio correction mode. 0:0 means the default ratio of 4:3, and -1:-1 means the original image ratio.
# char9: Allow 9-pixel wide text mode fonts instead of 8-pixel wide fonts.
# euro: Display Euro symbol instead of the specified ASCII character (33-255).
# For example, setting it to 128 allows Euro symbol to be displayed instead of C-cedilla.
# doublescan: If set, doublescanned output emits two scanlines for each source line, in the
# same manner as the actual VGA output (320x200 is rendered as 640x400 for example).
# If clear, doublescanned output is rendered at the native source resolution (320x200 as 320x200).
# This affects the raster PRIOR to the software or hardware scalers. Choose wisely.
# For pixel-perfect scaling (output=openglpp), it is recommended to turn this option off.
# scaler: Scaler used to enlarge/enhance low resolution modes. If 'forced' is appended,
# then the scaler will be used even if the result might not be desired.
# Appending 'prompt' will cause a confirmation message for forcing the scaler.
# To fit a scaler in the resolution used at full screen may require a border or side bars.
# To fill the screen entirely, depending on your hardware, a different scaler/fullresolution might work.
# Scalers should work with most output options, but they are ignored for openglpp and TrueType font outputs.
# Possible values: none, normal2x, normal3x, normal4x, normal5x, advmame2x, advmame3x, advinterp2x, advinterp3x, hq2x, hq3x, 2xsai, super2xsai, supereagle, tv2x, tv3x, rgb2x, rgb3x, scan2x, scan3x, gray, gray2x, hardware_none, hardware2x, hardware3x, hardware4x, hardware5x, xbrz, xbrz_bilinear.
# glshader: Path to GLSL shader source to use with OpenGL output ("none" to disable, or "default" for default shader).
# Can be either an absolute path, a file in the "glshaders" subdirectory of the DOSBox-X configuration directory,
# or one of the built-in shaders (e.g. "sharp" for the pixel-perfect scaling mode):
# advinterp2x, advinterp3x, advmame2x, advmame3x, rgb2x, rgb3x, scan2x, scan3x, tv2x, tv3x, sharp.
# pixelshader: Set Direct3D pixel shader program (effect file must be in Shaders subdirectory). If 'forced' is appended,
# then the pixel shader will be used even if the result might not be desired.
# autofit: Best fits image to window
# - Intended for output=direct3d, fullresolution=original, aspect=true
# monochrome_pal: Specify the color of monochrome display.
# Possible values: green, amber, gray, white
# Append 'bright' for a brighter look.
# Possible values: green, amber, gray, white.
#
# Advanced options (see full configuration reference file [dosbox-x.reference.full.conf] for more details):
# -> xbrz slice; xbrz fixed scale factor; xbrz max scale factor
#
frameskip = 0
aspect = false
aspect_ratio = 0:0
char9 = true
euro = -1
doublescan = true
scaler = normal2x
glshader = none
pixelshader = none
autofit = true
monochrome_pal = green
[pc98]
# pc-98 BIOS copyright string: If set, the PC-98 BIOS copyright string is placed at E800:0000. Enable this for software that detects PC-98 vs Epson.
# pc-98 fm board: In PC-98 mode, selects the FM music board to emulate.
# Possible values: auto, off, false, board14, board26k, board86, board86c.
# pc-98 enable 256-color: Allow 256-color graphics mode if set, disable if not set
# pc-98 enable 16-color: Allow 16-color graphics mode if set, disable if not set
# pc-98 enable grcg: Allow GRCG graphics functions if set, disable if not set
# pc-98 enable egc: Allow EGC graphics functions if set, disable if not set
# pc-98 bus mouse: Enable PC-98 bus mouse emulation. Disabling this option does not disable INT 33h emulation.
# pc-98 force ibm keyboard layout: Force to use a default keyboard layout like IBM US-English for PC-98 emulation.
# Will only work with apps and games using BIOS for keyboard.
# Possible values: true, false, 1, 0, auto.
# pc-98 try font rom: If enabled, DOSBox-X will first try to load FONT.ROM as generated by T98Tools for PC-98 emulation.
# pc-98 anex86 font: Specify an Anex86 compatible font to load as supported by the Anex86 emulator for PC-98 emulation.
# By default DOSBox-X tries to load ANEX86.BMP followed by FREECG98.BMP after trying to load FONT.ROM.
# If you specify a font here then it will be tried first, perhaps before FONT.ROM (see previous option).
#
# Advanced options (see full configuration reference file [dosbox-x.reference.full.conf] for more details):
# -> pc-98 int 1b fdc timer wait; pc-98 pic init to read isr; pc-98 fm board irq; pc-98 fm board io port; pc-98 sound bios; pc-98 load sound bios rom file; pc-98 buffer page flip; pc-98 enable 256-color planar; pc-98 enable 188 user cg; pc-98 start gdc at 5mhz; pc-98 allow scanline effect; pc-98 video mode; pc-98 timer always cycles; pc-98 timer master frequency; pc-98 allow 4 display partition graphics; pc-98 show graphics layer on initialize
#
pc-98 BIOS copyright string = false
pc-98 fm board = auto
pc-98 enable 256-color = true
pc-98 enable 16-color = true
pc-98 enable grcg = true
pc-98 enable egc = true
pc-98 bus mouse = true
pc-98 force ibm keyboard layout = auto
pc-98 try font rom = true
pc-98 anex86 font =
[dosv]
# dosv: Enable DOS/V emulation and specify which version to emulate. This option is intended for use with games or software
# originating from East Asia (China, Japan, Korea) that use the double byte character set (DBCS) encodings and DOS/V extensions
# to display Japanese (jp), Chinese (chs/cht/cn/tw), or Korean (ko) text. Note that enabling DOS/V replaces 80x25 text mode with
# a EGA/VGA graphics mode that emulates text mode to display the characters and may be incompatible with non-Asian software that
# assumes direct access to the text mode via segment 0xB800. For a general DOS environment with CJK support please disable DOS/V
# emulation and use TrueType font (TTF) output with a CJK code page (932, 936, 949, 950) and TTF font with CJK characters instead.
# Possible values: off, jp, ko, chs, cht, cn, tw.
# getsysfont: If enabled, DOSBox-X will try to get and use the system fonts on Windows and Linux platforms for the DOS/V emulation.
# If this cannot be done, then DOSBox-X will try to use the internal Japanese DOS/V font, or you can specify a different font.
# fontxsbcs: FONTX2 file used to rendering SBCS characters (8x19) in DOS/V or JEGA mode. If not specified, the default one will be used.
# Loading the ASC16 and ASCFONT.15 font files (from the UCDOS and ETen Chinese DOS systems) is also supported for the DOS/V mode.
# fontxsbcs16: FONTX2 file used to rendering SBCS characters (8x16) in DOS/V or JEGA mode. If not specified, the default one will be used.
# Loading the ASC16 and ASCFONT.15 font files (from the UCDOS and ETen Chinese DOS systems) is also supported for the DOS/V mode.
# fontxsbcs24: FONTX2 file used to rendering SBCS characters (12x24) in DOS/V mode (with V-text). If not specified, the default one will be used.
# Loading the ASC24 and ASCFONT.24? font files (the latter from the ETen Chinese DOS system) is also supported for the DOS/V mode.
# fontxdbcs: FONTX2 file used to rendering DBCS characters (16x16) in DOS/V or VGA/JEGA mode. If not specified, the default one will be used.
# Alternatively, you can load a BDF or PCF font file (16x16 or 15x15), such as the free bitmap fonts from WenQuanYi (https://wenq.org/).
# For Simplified Chinese DOS/V, loading the HZK16 font file (https://github.com/aguegu/BitmapFont/tree/master/font) is also supported.
# For Traditional Chinese DOS/V, loading the STDFONT.15 font file from the ETen Chinese DOS system is also supported.
# fontxdbcs14: FONTX2 file used to rendering DBCS characters (14x14) for Configuration Tool or EGA mode. If not specified, the default one will be used.
# Alternatively, you can load a BDF or PCF font file (14x14 or 15x15), such as the free bitmap fonts from WenQuanYi (https://wenq.org/).
# For Simplified Chinese DOS/V, loading the HZK14 font file (https://github.com/aguegu/BitmapFont/tree/master/font) is also supported.
# For Traditional Chinese DOS/V, loading the STDFONT.15 font file from the ETen Chinese DOS system is also supported.
# fontxdbcs24: FONTX2 file used to rendering DBCS characters (24x24) in DOS/V mode (with V-text and 24-pixel fonts enabled).
# For Simplified Chinese DOS/V, loading the HZK24? font file (https://github.com/aguegu/BitmapFont/tree/master/font) is also supported.
# For Traditional Chinese DOS/V, loading the STDFONT.24 font file from the ETen Chinese DOS system is also supported.
# showdbcsnodosv: Enables rendering of Chinese/Japanese/Korean characters for DBCS code pages in standard VGA and EGA machine types in non-DOS/V and non-TTF mode.
# DOS/V fonts will be used in such cases, which can be adjusted by the above config options (such as fontxdbcs, fontxdbcs14, and fontxdbcs24).
# Setting to "auto" enables Chinese/Japanese/Korean character rendering if a language file is loaded (or with "autodbcs" option set) in such cases.
# Possible values: true, false, 1, 0, auto.
# yen: Enables the Japanese yen symbol at 5ch if it is found at 7fh in a custom SBCS font for the Japanese DOS/V or JEGA emulation.
# fepcontrol: FEP control API for the DOS/V emulation.
# Possible values: ias, mskanji, both.
# vtext1: V-text screen mode 1 for the DOS/V emulation. Enter command "VTEXT 1" for this mode. Note that XGA/SXGA mode is only supported by the svga_s3trio and svga_et4000 machine types.
# Possible values: xga, xga24, sxga, sxga24, svga.
# vtext2: V-text screen mode 2 for the DOS/V emulation. Enter command "VTEXT 2" for this mode. Note that XGA/SXGA mode is only supported by the svga_s3trio and svga_et4000 machine types.
# Possible values: xga, xga24, sxga, sxga24, svga.
# use20pixelfont: Enables the 20 pixel font to be used instead of the 24 pixel system font for the Japanese DOS/V emulation (with V-text enabled).
# j3100: With the setting dosv=jp and a non-off value of this option, the Toshiba J-3100 machine will be emulated with DCGA support.
# Setting to "on" or "auto" starts J-3100 automatically, and with the setting "manual" you can enter J-3100 mode with DCGA command.
# Possible values: off, on, auto, manual, 0, 1, 2.
# j3100type: Specifies the Toshiba J-3100 machine type if J-3100 mode is enabled. The color palette will be changed with different machine types.
# Possible values: default, gt, sgt, gx, gl, sl, sgx, ss, gs, sx, sxb, sxw, sxp, ez, zs, zx.
# j3100colorscroll: Specifies that the color display can be used for scrolling, which is currently incompatible with for example the J-3100 version of the SimCity game.
# The VGA version of the Toshiba Windows 3.1 works fine with the "false" value of this setting, whereas its CGA/EGA version requires a "true" value for this.
#
# Advanced options (see full configuration reference file [dosbox-x.reference.full.conf] for more details):
# -> del; j3100backcolor; j3100textcolor
#
dosv = off
getsysfont = true
fontxsbcs =
fontxsbcs16 =
fontxsbcs24 =
fontxdbcs =
fontxdbcs14 =
fontxdbcs24 =
showdbcsnodosv = auto
yen = false
fepcontrol = both
vtext1 = svga
vtext2 = xga
use20pixelfont = false
j3100 = off
j3100type = default
j3100colorscroll = false
[video]
# vmemsize: Amount of video memory in megabytes.
# The maximum resolution and color depth the svga_s3 will be able to display
# is determined by this value.
# -1: auto (vmemsizekb is ignored)
# 0: 512k (800x600 at 256 colors) if vmemsizekb=0
# 1: 1024x768 at 256 colors or 800x600 at 64k colors
# 2: 1600x1200 at 256 colors or 1024x768 at 64k colors or 640x480 at 16M colors
# 4: 1600x1200 at 64k colors or 1024x768 at 16M colors
# 8: up to 1600x1200 at 16M colors
# For build engine games, use more memory than in the list above so it can
# use triple buffering and thus won't flicker.
#
# vmemsizekb: Amount of video memory in kilobytes, in addition to vmemsize.
# high intensity blinking: Set to false if you want to see high-intensity background colors instead of blinking foreground text.
# This option has no effect in PC-98 and some other video modes.
# memory io optimization 1: Enable one class of EGA/VGA memory I/O optimizations. Default ON (true).
# If graphical artifacts or errors occur, try turning this off first. May provide a performance benefit.
# scanline render on demand: Render video output at vsync or when something is changed mid frame, instead of stopping to render every scanline.
# May provide a performance benefit to most DOS games. However this may also break timing-dependent game or Demoscene effects.
# Default auto, which will turn if off for VGA modes and turn it on for SVGA modes.
# Possible values: true, false, 1, 0, auto.
#
# Advanced options (see full configuration reference file [dosbox-x.reference.full.conf] for more details):
# -> vmemdelay; vbe window granularity; vbe window size; enable 8-bit dac; svga lfb base; pci vga; vga attribute controller mapping; vga bios use rom image; vga bios rom image; vga bios size override; video bios dont duplicate cga first half rom font; video bios always offer 14-pixel high rom font; video bios always offer 16-pixel high rom font; video bios enable cga second half rom font; forcerate; sierra ramdac; sierra ramdac lock 565; vga fill active memory; page flip debug line; vertical retrace poll debug line; cgasnow; vga 3da undefined bits; rom bios 8x8 CGA font; rom bios video parameter table; int 10h points at vga bios; unmask timer on int 10 setmode; vesa bank switching window mirroring; vesa bank switching window range check; vesa zero buffer on get information; vesa set display vsync; vesa lfb base scanline adjust; vesa map non-lfb modes to 128kb region; ega per scanline hpel; allow hpel effects; allow hretrace effects; hretrace effect weight; vesa modelist cap; vesa modelist width limit; vesa modelist height limit; vesa vbe put modelist in vesa information; vesa vbe 1.2 modes are 32bpp; allow low resolution vesa modes; allow explicit 24bpp vesa modes; allow high definition vesa modes; allow unusual vesa modes; allow 32bpp vesa modes; allow 24bpp vesa modes; allow 16bpp vesa modes; allow 15bpp vesa modes; allow 8bpp vesa modes; allow 4bpp vesa modes; allow 4bpp packed vesa modes; allow tty vesa modes; double-buffered line compare; ignore vblank wraparound; ignore extended memory bit; enable vga resize delay; resize only on vga active display width increase; vga palette update on full load; ignore odd-even mode in non-cga modes; ignore sequencer blanking
#
vmemsize = -1
vmemsizekb = 0
high intensity blinking = true
memory io optimization 1 = true
scanline render on demand = auto
[vsync]
# vsyncmode: Synchronize vsync timing to the host display. Requires calibration within DOSBox-X.
# Possible values: off, on, force, host.
# vsyncrate: Vsync rate used if vsync is enabled. Ignored if vsyncmode is set to host (win32).
# Possible values:.
vsyncmode = off
vsyncrate = 75
[cpu]
# core: CPU Core used in emulation. auto will switch to dynamic if available and appropriate.
# For the dynamic core, both dynamic_x86 and dynamic_rec are supported (dynamic_x86 is preferred).
# Windows 95 or other preemptive multitasking OSes will not work with the dynamic_rec core.
# Possible values: auto, dynamic, dynamic_x86, dynamic_nodhfpu, dynamic, dynamic_rec, normal, full, simple.
# fpu: Enable FPU emulation
# Possible values: true, false, 1, 0, auto, 8087, 287, 387.
# rdtsc rate: If nonzero, the Pentium RDTSC counter will tick at this rate per millisecond instead of by the cycle count
# segment limits: Enforce checks for segment limits on 80286 and higher CPU types.
# cputype: CPU Type used in emulation. "auto" emulates a 486 which tolerates Pentium instructions.
# "experimental" enables newer instructions not normally found in the CPU types emulated by DOSBox-X, such as FISTTP.
# Possible values: auto, 8086, 8086_prefetch, 80186, 80186_prefetch, 286, 286_prefetch, 386, 386_prefetch, 486old, 486old_prefetch, 486, 486_prefetch, pentium, pentium_mmx, ppro_slow, pentium_ii, pentium_iii, experimental.
# cycles: Number of instructions DOSBox-X tries to emulate each millisecond.
# Setting this value too high results in sound dropouts and lags.
# Cycles can be set in 3 ways:
# 'auto' tries to guess what a game needs.
# It usually works, but can fail for certain games.
# 'fixed #number' will set a fixed number of cycles. This is what you usually
# need if 'auto' fails (Example: fixed 4000).
# 'max' will allocate as much cycles as your computer is able to
# handle. Recommended if better performance is desired.
# Possible values: auto, fixed, max.
# cycleup: Amount of cycles to decrease/increase with the mapped keyboard shortcut.
# cycledown: Setting it lower than 100 will be a percentage.
# turbo: Enables Turbo (Fast Forward) mode to speed up operations.
# apmbios: Emulate Advanced Power Management (APM) BIOS calls.
# integration device: Enable DOSBox-X's integration I/O device, a way for additional software to talk to DOSBox-X. It is currently experimental.
# This can for example be used to return DOSBox-X's current status and by the guest OS to match the mouse pointer position.
# isapnpbios: Emulate ISA Plug & Play BIOS. Enable if using DOSBox-X to run a PnP aware DOS program or if booting Windows 9x.
# Do not disable if Windows 9x is configured around PnP devices, you will likely confuse it.
#
# Advanced options (see full configuration reference file [dosbox-x.reference.full.conf] for more details):
# -> cpuid string; processor serial number; double fault; clear trap flag on unhandled int 1; reset on triple fault; always report double fault; always report triple fault; mask stack pointer for enter leave instructions; allow lmsw to exit protected mode; report fdiv bug; enable msr; enable cmpxchg8b; enable syscall; ignore undefined msr; interruptible rep string op; dynamic core cache block size; cycle emulation percentage adjust; stop turbo on key; stop turbo after second; use dynamic core with paging on; ignore opcode 63; apmbios pnp; apm power button event; apmbios version; apmbios allow realmode; apmbios allow 16-bit protected mode; apmbios allow 32-bit protected mode; integration device pnp; isapnpport; realbig16
#
core = full
fpu = true
rdtsc rate = 0
segment limits = true
cputype = auto
cycles = auto
cycleup = 10
cycledown = 20
turbo = false
apmbios = true
integration device = false
isapnpbios = true
[keyboard]
# aux: Enable emulation of the 8042 auxiliary port. PS/2 mouse emulation requires this to be enabled.
# You should enable this if you will be running Windows ME or any other OS that does not use the BIOS to receive mouse events.
# allow output port reset: If set (default), allow the application to reset the CPU through the keyboard controller.
# This option is required to allow Windows ME to reboot properly, whereas Windows 9x and earlier
# will reboot without this option using INT 19h
# controllertype: Type of keyboard controller (and keyboard) attached.
# auto Automatically pick according to machine type
# at AT (PS/2) type keyboard
# xt IBM PC/XT type keyboard
# pcjr IBM PCjr type keyboard (only if machine=pcjr)
# pc98 PC-98 keyboard emulation (only if machine=pc98)
# Possible values: auto, at, xt, pcjr, pc98.
# auxdevice: Type of PS/2 mouse attached to the AUX port
# Possible values: none, 2button, 3button, intellimouse, intellimouse45.
aux = true
allow output port reset = true
controllertype = auto
auxdevice = intellimouse
[ttf]
# font: Specifies a TrueType font to use for the TTF output. If not specified, the built-in TrueType font will be used.
# Either a font name or full font path can be specified. If file ends with the .TTF extension then the extension can be omitted.
# For a font name or relative path, directories such as the working directory and default system font directory will be searched.
# For example, setting it to "consola" or "consola.ttf" will use Consola font (included in Windows); similar for other TTF fonts.
# Additionally, OTF fonts (e.g. OratorStd.otf), .FON fonts (e.g. vgasys.fon), and .TTC fonts (e.g. msgothic.ttc) are also supported.
# To display Chinese/Japanese/Korean text in these code pages, a font with CJK characters is needed (e.g. GNU Unifont or Sarasa Gothic).
# fontbold: You can optionally specify a bold TrueType font for use with the TTF output that will render the bold text style.
# It requires a word processor be set with the wp option, and this actual bold font will be used for the bold style.
# For example, setting it to "consolab" or "consolab.ttf" will use the Consolab font; similar for other TTF fonts.
# fontital: You can optionally specify an italic TrueType font for use with the TTF output that will render the italic text style.
# It requires a word processor be set with the wp option, and this actual italic font will be used for the italic style.
# For example, setting it to "consolai" or "consolai.ttf" will use the Consolai font; similar for other TTF fonts.
# fontboit: You can optionally specify a bold italic TrueType font for use with the TTF output that will render the bold italic text style.
# It requires a word processor be set with the wp option, and this actual bold-italic font will be used for the bold-italic style.
# For example, setting it to "consolaz" or "consolaz.ttf" will use the Consolaz font; similar for other TTF fonts.
# colors: Specifies a color scheme to use for the TTF output by supply all 16 color values in RGB: (r,g,b) or hexadecimal as in HTML: #RRGGBB
# The original DOS colors (0-15): #000000 #0000aa #00aa00 #00aaaa #aa0000 #aa00aa #aa5500 #aaaaaa #555555 #5555ff #55ff55 #55ffff #ff5555 #ff55ff #ffff55 #ffffff
# gray scaled color scheme: (0,0,0) #0e0e0e (75,75,75) (89,89,89) (38,38,38) (52,52,52) #717171 #c0c0c0 #808080 (28,28,28) (150,150,150) (178,178,178) (76,76,76) (104,104,104) (226,226,226) (255,255,255)
# An optional leading "+" sign allows the preset color scheme to be used when switching from another output.
# outputswitch: Specifies the output that DOSBox-X should switch to from the TTF output when a graphical mode is requested, or auto for automatic selection.
# Possible values: auto, surface, opengl, openglnb, openglhq, openglpp, direct3d.
# winperc: Specifies the window percentage for the TTF output (100 = full screen). Ignored if the ptsize setting is specified.
# ptsize: Specifies the font point size for the TTF output. If specified (minimum: 9), it will override the winperc setting.
# lins: Specifies the number of rows on the screen for the TTF output (0 = default).
# cols: Specifies the number of columns on the screen for the TTF output (0 = default).
# righttoleft: If set, DOSBox-X will display text from right to left instead of left to right on the screen for the TTF output.
# This is especially useful for languages which use right-to-left scripts (such as Arabic and Hebrew).
# wp: You can specify a word processor for the TTF output and optionally also a version number for the word processor.
# Supported word processors are WP=WordPerfect, WS=WordStar, XY=XyWrite, FE=FastEdit, and an optional version number.
# For example, WP6 will set the word processor as WordPerfect 6, and XY4 will set the word processor as XyWrite 4.
# Word processor-specific features like on-screen text styles and 512-character font will be enabled based on this.
# bold: If set, DOSBox-X will display bold text in visually (requires a word processor be set) for the TTF output.
# This is done either with the actual bold font specified by the fontbold option, or by making it bold automatically.
# italic: If set, DOSBox-X will display italicized text visually (requires a word processor be set) for the TTF output.
# This is done either with the actual italic font specified by the fontital option, or by slanting the characters automatically.
# underline: If set, DOSBox-X will display underlined text visually (requires a word processor be set) for the TTF output.
# strikeout: If set, DOSBox-X will display strikeout text visually (requires a word processor be set) for the TTF output.
# printfont: If set, DOSBox-X will force to use the current TrueType font (set via font option) for printing in addition to displaying.
# autodbcs: If set, DOSBox-X enables Chinese/Japanese/Korean DBCS (double-byte) characters when these code pages are active by default.
# Only applicable when using a DBCS code page (932: Japanese, 936: Simplified Chinese; 949: Korean; 950: Traditional Chinese)
# This applies to both the display and printing of these characters (see the [printer] section for details of the latter).
# blinkc: If set to true, the cursor blinks for the TTF output; setting it to false will turn the blinking off.
# You can also change the blinking rate by setting an integer between 1 (fastest) and 7 (slowest), or 0 for no cursor.
# gbk: Enables the GBK extension (in addition to the standard GB2312 charset) for the Simplified Chinese TTF output or DOS/V emulation.
# chinasea: Enables the ChinaSea and Big5-2003 extension (in addition to the standard Big5-1984 charset) for the Traditional Chinese TTF output.
# A TTF/OTF font containing such characters (such as the included SarasaGothicFixed TTF font) is needed to correctly render ChinaSea characters.
# dosvfunc: If set, enables FEP control to function for Japanese DOS/V applications, and changes the blinking of character attributes to high brightness.
#
# Advanced options (see full configuration reference file [dosbox-x.reference.full.conf] for more details):
# -> wpbg; wpfg; char512; autoboxdraw; halfwidthkana; uao
#
font =
fontbold =
fontital =
fontboit =
colors =
outputswitch = auto
winperc = 60
ptsize = 0
lins = 0
cols = 0
righttoleft = false
wp =
bold = true
italic = true
underline = true
strikeout = false
printfont = true
autodbcs = true
blinkc = true
gbk = false
chinasea = false
dosvfunc = false
[voodoo]
# voodoo_card: Enable support for the 3dfx Voodoo card.
# Possible values: false, software, opengl, auto.
# voodoo_maxmem: Specify whether to enable maximum memory size for the Voodoo card.
# If set (on by default), the memory size will be 12MB (4MB front buffer + 2x4MB texture units)
# Otherwise, the memory size will be the standard 4MB (2MB front buffer + 1x2MB texture unit)
# glide: Enable Glide emulation (Glide API passthrough to the host).
# Requires a Glide wrapper - glide2x.dll (Windows), libglide2x.so (Linux), or libglide2x.dylib (macOS).
# lfb: Enable LFB access for Glide. OpenGlide does not support locking aux buffer, please use _noaux modes.
# Possible values: full, full_noaux, read, read_noaux, write, write_noaux, none.
# splash: Show 3dfx splash screen for Glide emulation (Windows; requires 3dfxSpl2.dll).
voodoo_card = auto
voodoo_maxmem = true
glide = false
lfb = full_noaux
splash = true
[mixer]
# nosound: Enable silent mode, sound is still emulated though.
# sample accurate: Enable sample accurate mixing, at the expense of some emulation performance. Enable this option for DOS games and demos
# that require such accuracy for correct Tandy/OPL output including digitized speech. This option can also help eliminate
# minor errors in Gravis Ultrasound emulation that result in random echo/attenuation effects.
# swapstereo: Swaps the left and right stereo channels.
# rate: Mixer sample rate, setting any device's rate higher than this will probably lower their sound quality.
# blocksize: Mixer block size, larger blocks might help sound stuttering but sound will also be more lagged.
# Possible values: 1024, 2048, 4096, 8192, 512, 256.
# prebuffer: How many milliseconds of data to keep on top of the blocksize.
nosound = false
sample accurate = false
swapstereo = false
rate = 48000
blocksize = 1024
prebuffer = 25
[midi]
# mpu401: Type of MPU-401 to emulate.
# Possible values: intelligent, uart, none.
# mpubase: The IO address of the MPU-401.
# Set to 0 to use a default I/O address.
# 300h to 330h are for use with IBM PC mode.
# C0D0h to F8D0h (in steps of 800h) are for use with NEC PC-98 mode (MPU98).
# 80D2h through 80DEh are for use with NEC PC-98 Sound Blaster 16 MPU-401 emulation.
# If not assigned (0), 330h is the default for IBM PC and E0D0h is the default for PC-98.
# Possible values: 0, 300, 310, 320, 330, 332, 334, 336, 340, 360, c0d0, c8d0, d0d0, d8d0, e0d0, e8d0, f0d0, f8d0, 80d2, 80d4, 80d6, 80d8, 80da, 80dc, 80de.
# mididevice: Device that will receive the MIDI data from MPU-401.
# Possible values: default, win32, alsa, oss, coreaudio, coremidi, mt32, synth, fluidsynth, timidity, none.
# midiconfig: Special configuration options for the device driver. This is usually the id or part of the name of the device you want to use
# (find the id/name with mixer/listmidi).
# Or in the case of coreaudio or synth, you can specify a soundfont here.
# When using a Roland MT-32 rev. 0 as midi output device, some games may require a delay in order to prevent 'buffer overflow' issues.
# In that case, add 'delaysysex', for example: midiconfig=2 delaysysex
# See the README/Manual for more details.
# samplerate: Sample rate for MIDI synthesizer, if applicable.
# Possible values: 49716, 48000, 44100, 32000, 22050, 16000, 11025, 8000.
# mpuirq: MPU-401 IRQ. -1 to automatically choose.
# mt32.romdir: Name of the directory where MT-32 Control and PCM ROM files can be found. Emulation requires these files to work.
# Accepted file names are as follows:
# MT32_CONTROL.ROM or CM32L_CONTROL.ROM - control ROM file.
# MT32_PCM.ROM or CM32L_PCM.ROM - PCM ROM file.
# mt32.model: Model of the MT-32 synthesizer to use.
# Possible values: cm32l, mt32, auto.
# fluid.driver: Driver to use with Fluidsynth, not needed under Windows. Available drivers depend on what Fluidsynth was compiled with.
# Possible values: pulseaudio, alsa, oss, coreaudio, dsound, portaudio, sndman, jack, file, default.
# fluid.soundfont: Soundfont (.SF2 or .SF3) to use with Fluidsynth. One must be specified (e.g. GeneralUser_GS.sf2).
#
# Advanced options (see full configuration reference file [dosbox-x.reference.full.conf] for more details):
# -> mt32.reverse.stereo; mt32.verbose; mt32.thread; mt32.chunk; mt32.prebuffer; mt32.partials; mt32.dac; mt32.analog; mt32.output.gain; mt32.reverb.mode; mt32.reverb.output.gain; mt32.reverb.time; mt32.reverb.level; mt32.rate; mt32.src.quality; mt32.niceampramp; mt32.engage.channel1; fluid.samplerate; fluid.gain; fluid.polyphony; fluid.cores; fluid.periods; fluid.periodsize; fluid.reverb; fluid.chorus; fluid.reverb.roomsize; fluid.reverb.damping; fluid.reverb.width; fluid.reverb.level; fluid.chorus.number; fluid.chorus.level; fluid.chorus.speed; fluid.chorus.depth; fluid.chorus.type
#
mpu401 = intelligent
mpubase = 0
mididevice = default
midiconfig =
samplerate = 44100
mpuirq = -1
mt32.romdir =
mt32.model = auto
fluid.driver = default
fluid.soundfont =
[sblaster]
# sbtype: Type of Sound Blaster to emulate. 'gb' is Game Blaster.
# Possible values: sb1, sb2, sbpro1, sbpro2, sb16, sb16vibra, gb, ess688, reveal_sc400, none.
# sbbase: The IO address of the Sound Blaster.
# 220h to 2E0h are for use with IBM PC Sound Blaster emulation.
# D2h to DEh are for use with NEC PC-98 Sound Blaster 16 emulation.
# Possible values: 220, 240, 260, 280, 2a0, 2c0, 2e0, d2, d4, d6, d8, da, dc, de.
# irq: The IRQ number of the Sound Blaster (usually 5 or 7, depending on the sound card type and the game).
# Set to 0 for the default setting of the sound card, or set to -1 to start DOSBox-X with the IRQ unassigned.
# Possible values: 7, 5, 3, 9, 10, 11, 12, 0, -1.
# listen to recording source: When the guest records audio from the Sound Blaster card, send the input source to the speakers as well so it can be heard.
# recording source: Audio source to use when guest is recording audio. At this time only generated audio sources are available.
# Possible values: silence, hiss, 1khz tone.
# dma: The DMA number of the Sound Blaster. Set to -1 to start DOSBox-X with the DMA unassigned.
# Possible values: 1, 5, 0, 3, 6, 7, -1.
# hdma: The High DMA number of the Sound Blaster. Set to -1 to start DOSBox-X with the High DMA unassigned.
# Possible values: 1, 5, 0, 3, 6, 7, -1.
# enable speaker: Start the DOS virtual machine with the Sound Blaster speaker enabled.
# Sound Blaster Pro and older cards have a speaker disable/enable command.
# Normally the card boots up with the speaker disabled. If a DOS game or demo
# attempts to play without enabling the speaker, set this option to true to
# compensate. This setting has no meaning if emulating a Sound Blaster 16 card.
# sbmixer: Allow the Sound Blaster mixer to modify the DOSBox-X mixer.
# oplmode: Type of OPL emulation. On 'auto' the mode is determined by the 'sbtype' setting.
# All OPL modes are AdLib-compatible, except for 'cms' (set 'sbtype=none' with 'cms' for a Game Blaster).
# Possible values: auto, cms, opl2, dualopl2, opl3, opl3gold, none, hardware, hardwaregb.
# oplemu: Provider for the OPL emulation. 'compat' might provide better quality.
# 'nuked' is the most accurate (but the most CPU-intensive). See oplrate as well.
# Possible values: default, compat, fast, nuked, mame, opl2board, opl3duoboard, retrowave_opl3.
# oplrate: Sample rate of OPL music emulation. Use 49716 for highest quality (set the mixer rate accordingly).
# Possible values: 49716, 48000, 44100, 32000, 22050, 16000, 11025, 8000.
# oplport: Serial port of the OPL2 Audio Board when oplemu=opl2board, opl2mode will become 'opl2' automatically.
# retrowave_bus: Bus of the Retrowave series board (serial/spi). SPI is only supported on Linux.
# retrowave_port: Serial port of the Retrowave series board.
# hardwarebase: base address of the real hardware Sound Blaster:
# 210,220,230,240,250,260,280
# goldplay: Enable goldplay emulation.
# blaster environment variable: Whether or not to set the BLASTER environment variable automatically at startup
#
# Advanced options (see full configuration reference file [dosbox-x.reference.full.conf] for more details):
# -> mindma; irq hack; dsp command aliases; pic unmask irq; enable asp; disable filtering; dsp write buffer status must return 0x7f or 0xff; pre-set sbpro stereo; adlib force timer overflow on detect; retrowave_spi_cs; force dsp auto-init; force goldplay; goldplay stereo; dsp require interrupt acknowledge; dsp write busy delay; sample rate limits; instant direct dac; stereo control with sbpro only; dsp busy cycle rate; dsp busy cycle always; dsp busy cycle duty; io port aliasing
#
sbtype = sb16
sbbase = 220
irq = 7
listen to recording source = false
recording source = silence
dma = 1
hdma = 5
enable speaker = false
sbmixer = true
oplmode = auto
oplemu = default
oplrate = 44100
oplport =
retrowave_bus = serial
retrowave_port =
hardwarebase = 220
goldplay = true
blaster environment variable = true
[gus]
# gus: Enable the Gravis Ultrasound emulation.
# gusrate: Sample rate of Ultrasound emulation.
# Possible values: 49716, 48000, 44100, 32000, 22050, 16000, 11025, 8000.
# gusmemsize: Amount of RAM on the Gravis Ultrasound in KB. Set to -1 for default.
# gus master volume: Master Gravis Ultrasound GF1 volume, in decibels. Reducing the master volume can help with games or demoscene productions where the music is too loud and clipping.
# gusbase: The IO base address of the Gravis Ultrasound.
# Possible values: 240, 220, 260, 280, 2a0, 2c0, 2e0, 300, 210, 230, 250.
# gusirq: The IRQ number of the Gravis Ultrasound.
# Possible values: 5, 3, 7, 9, 10, 11, 12.
# gusdma: The DMA channel of the Gravis Ultrasound.
# Possible values: 3, 0, 1, 5, 6, 7.
# gustype: Type of Gravis Ultrasound to emulate.
# classic Original Gravis Ultrasound chipset
# classic37 Original Gravis Ultrasound with ICS Mixer (rev 3.7)
# max Gravis Ultrasound MAX emulation (with CS4231 codec)
# interwave Gravis Ultrasound Plug & Play (interwave)
# Possible values: classic, classic37, max, interwave.
# ultradir: Path to Ultrasound directory. In this directory
# there should be a MIDI directory that contains
# the patch files for GUS playback. Patch sets used
# with Timidity should work fine.
#
# Advanced options (see full configuration reference file [dosbox-x.reference.full.conf] for more details):
# -> autoamp; unmask dma; ignore channel count while active; pic unmask irq; startup initialized; dma enable on dma control polling; clear dma tc irq if excess polling; force master irq enable; gus panning table; gus fixed render rate; irq hack
#
gus = false
gusrate = 44100
gusmemsize = -1
gus master volume = 0.00
gusbase = 240
gusirq = 5
gusdma = 3
gustype = classic
ultradir = C:\ULTRASND
[innova]
# innova: Enable the Innovation SSI-2001 emulation.
# samplerate: Sample rate of Innovation SSI-2001 emulation
# Possible values: 49716, 48000, 44100, 32000, 22050, 16000, 11025, 8000.
# sidbase: SID base port (typically 280h).
# Possible values: 240, 220, 260, 280, 2a0, 2c0, 2e0, 300.
# quality: Set SID emulation quality level (0 to 3).
# Possible values: 0, 1, 2, 3.
innova = false
samplerate = 22050
sidbase = 280
quality = 0
[speaker]
# pcspeaker: Enable PC-Speaker emulation.
# pcrate: Sample rate of the PC-Speaker sound generation.
# Possible values: 65536, 49716, 48000, 44100, 32000, 22050, 16000, 11025, 8000.
# tandy: Enable Tandy Sound System emulation. For 'auto', emulation is present only if machine is set to 'tandy'.
# Possible values: auto, on, off.
# tandyrate: Sample rate of the Tandy 3-Voice generation.
# Possible values: 49716, 48000, 44100, 32000, 22050, 16000, 11025, 8000.
# disney: Enable Disney Sound Source emulation. (Covox Voice Master and Speech Thing compatible).
# ps1audio: Enable PS1 audio emulation.
# Possible values: on, off.
# ps1audiorate: Sample rate of the PS1 audio emulation.
# Possible values: 49716, 48000, 44100, 32000, 22050, 16000, 11025, 8000.
#
# Advanced options (see full configuration reference file [dosbox-x.reference.full.conf] for more details):
# -> pcspeaker clock gate enable at startup; initial frequency
#
pcspeaker = true
pcrate = 65536
tandy = auto
tandyrate = 44100
disney = false
ps1audio = off
ps1audiorate = 22050
[joystick]
# joysticktype: Type of joystick to emulate: auto (default),
# none (disables joystick emulation),
# 2axis (supports two joysticks),
# 4axis (supports one joystick, first joystick used),
# 4axis_2 (supports one joystick, second joystick used),
# fcs (Thrustmaster), ch (CH Flightstick).
# auto chooses emulation depending on real joystick(s).
# (Remember to reset DOSBox-X's mapperfile if you saved it earlier)
# Possible values: auto, 2axis, 4axis, 4axis_2, fcs, ch, none.
# timed: enable timed intervals for axis. Experiment with this option, if your joystick drifts (away).
# autofire: continuously fires as long as you keep the button pressed.
# swap34: swap the 3rd and the 4th axis. can be useful for certain joysticks.
# buttonwrap: enable button wrapping at the number of emulated buttons.
#
# Advanced options (see full configuration reference file [dosbox-x.reference.full.conf] for more details):
# -> joy1deadzone1; joy1deadzone2; joy2deadzone1; joy1response1; joy1response2; joy2response1; joy1axis0; joy1axis1; joy1axis2; joy1axis3; joy1axis4; joy1axis5; joy1axis6; joy1axis7; joy2axis0; joy2axis1; joy2axis2; joy2axis3; joy2axis4; joy2axis5; joy2axis6; joy2axis7
#
joysticktype = auto
timed = true
autofire = false
swap34 = false
buttonwrap = false
[mapper]
# joy1deadzone0-: deadzone for joystick 1 axis 0-
# joy1deadzone0+: deadzone for joystick 1 axis 0+
# joy1deadzone1-: deadzone for joystick 1 axis 1-
# joy1deadzone1+: deadzone for joystick 1 axis 1+
# joy1deadzone2-: deadzone for joystick 1 axis 2-
# joy1deadzone2+: deadzone for joystick 1 axis 2+
# joy1deadzone3-: deadzone for joystick 1 axis 3-
# joy1deadzone3+: deadzone for joystick 1 axis 3+
# joy1deadzone4-: deadzone for joystick 1 axis 4-
# joy1deadzone4+: deadzone for joystick 1 axis 4+
# joy1deadzone5-: deadzone for joystick 1 axis 5-
# joy1deadzone5+: deadzone for joystick 1 axis 5+
# joy1deadzone6-: deadzone for joystick 1 axis 6-
# joy1deadzone6+: deadzone for joystick 1 axis 6+
# joy1deadzone7-: deadzone for joystick 1 axis 7-
# joy1deadzone7+: deadzone for joystick 1 axis 7+
# joy2deadzone0-: deadzone for joystick 2 axis 0-
# joy2deadzone0+: deadzone for joystick 2 axis 0+
# joy2deadzone1-: deadzone for joystick 2 axis 1-
# joy2deadzone1+: deadzone for joystick 2 axis 1+
# joy2deadzone2-: deadzone for joystick 2 axis 2-
# joy2deadzone2+: deadzone for joystick 2 axis 2+
# joy2deadzone3-: deadzone for joystick 2 axis 3-
# joy2deadzone3+: deadzone for joystick 2 axis 3+
# joy2deadzone4-: deadzone for joystick 2 axis 4-
# joy2deadzone4+: deadzone for joystick 2 axis 4+
# joy2deadzone5-: deadzone for joystick 2 axis 5-
# joy2deadzone5+: deadzone for joystick 2 axis 5+
# joy2deadzone6-: deadzone for joystick 2 axis 6-
# joy2deadzone6+: deadzone for joystick 2 axis 6+
# joy2deadzone7-: deadzone for joystick 2 axis 7-
# joy2deadzone7+: deadzone for joystick 2 axis 7+
joy1deadzone0- = 0.60
joy1deadzone0+ = 0.60
joy1deadzone1- = 0.60
joy1deadzone1+ = 0.60
joy1deadzone2- = 0.60
joy1deadzone2+ = 0.60
joy1deadzone3- = 0.60
joy1deadzone3+ = 0.60
joy1deadzone4- = 0.60
joy1deadzone4+ = 0.60
joy1deadzone5- = 0.60
joy1deadzone5+ = 0.60
joy1deadzone6- = 0.60
joy1deadzone6+ = 0.60
joy1deadzone7- = 0.60
joy1deadzone7+ = 0.60
joy2deadzone0- = 0.60
joy2deadzone0+ = 0.60
joy2deadzone1- = 0.60
joy2deadzone1+ = 0.60
joy2deadzone2- = 0.60
joy2deadzone2+ = 0.60
joy2deadzone3- = 0.60
joy2deadzone3+ = 0.60
joy2deadzone4- = 0.60
joy2deadzone4+ = 0.60
joy2deadzone5- = 0.60
joy2deadzone5+ = 0.60
joy2deadzone6- = 0.60
joy2deadzone6+ = 0.60
joy2deadzone7- = 0.60
joy2deadzone7+ = 0.60
[serial]
# serial1: serial1-9 -- set type of device connected to the serial (COM) port.
# Can be disabled, dummy, file, modem, nullmodem, directserial.
# Additional parameters must be in the same line in the form of
# parameter:value. Parameter for all types is irq (optional).
# for file: specify an output file
# Additional parameters:
# timeout:<milliseconds> = how long to wait before closing the file on inactivity (default:0),
# squote to use single quotes instead of double quotes for quoted program commands.
# shellhide to hide the command window when opening programs on the Windows platform.
# openwith:<program>: start a program to open the output file.
# openerror:<program>: start a program to open the output file if an error had occurred.
# multiplier:<x>: Actual baud rate is the programmed rate times X to allow rates higher than 115200.
# Example: serial1=file file:output1.txt timeout:1000 openwith:notepad
# for directserial: realport (required), rxdelay (optional).
# (realport:COM1 realport:ttyS0).
# for modem: listenport (optional).
# for nullmodem: server, rxdelay, txdelay, telnet, usedtr,
# transparent, port, inhsocket, sock, nonlocal (all optional).
# connections are limited to localhost unless you specify nonlocal:1
# "sock" parameter specifies the protocol to be used by both sides
# of the connection. 0 for TCP and 1 for ENet reliable UDP.
# Example: serial1=modem listenport:5000 sock:1
# Note: COM1-4 are standard COM ports in DOS, whereas COM5-9 are extended COM ports.
# You can optionally specify base addresses and IRQs for them with base: and irq: options.
# Serial port settings can also be changed via the built-in SERIAL command.
# Possible values: dummy, disabled, modem, nullmodem, serialmouse, directserial, log, file.
# serial2: see serial1
# Possible values: dummy, disabled, modem, nullmodem, serialmouse, directserial, log, file.
# serial3: see serial1
# Possible values: dummy, disabled, modem, nullmodem, serialmouse, directserial, log, file.
# serial4: see serial1
# Possible values: dummy, disabled, modem, nullmodem, serialmouse, directserial, log, file.
# serial5: see serial1
# Possible values: dummy, disabled, modem, nullmodem, serialmouse, directserial, log, file.
# serial6: see serial1
# Possible values: dummy, disabled, modem, nullmodem, serialmouse, directserial, log, file.
# serial7: see serial1
# Possible values: dummy, disabled, modem, nullmodem, serialmouse, directserial, log, file.
# serial8: see serial1
# Possible values: dummy, disabled, modem, nullmodem, serialmouse, directserial, log, file.
# serial9: see serial1
# Possible values: dummy, disabled, modem, nullmodem, serialmouse, directserial, log, file.
# phonebookfile: File used to map fake phone numbers to addresses.
serial1 = dummy
serial2 = dummy
serial3 = disabled
serial4 = disabled
serial5 = disabled
serial6 = disabled
serial7 = disabled
serial8 = disabled
serial9 = disabled
phonebookfile = phonebook-dosbox-x.txt
[parallel]
# parallel1: parallel1-9 -- set type of device connected to the parallel (LPT) port.
# Can be:
# reallpt (direct parallel port passthrough),
# file (records data to a file or passes it to a device),
# printer (virtual dot-matrix printer, see [printer] section)
# disney (attach Disney Sound Source emulation to this port)
# Additional parameters must be in the same line in the form of
# parameter:value.
# for reallpt:
# Windows and DOS:
# realbase (the base address of your real parallel port).
# Default: 378
# ecpbase (address of the ECP Extended Control register, optional).
# BSD: same as Windows (requires root access / setuid root).
# Linux: same as Windows (requires root access / setuid root) or:
# realport (the parallel port device e.g. /dev/parport0).
# for file:
# dev:<devname> (i.e. dev:lpt1) to forward data to a device,
# or append:<file> appends data to the specified file.
# Without the above parameters data is written to files in the capture dir.
# Additional parameters:
# timeout:<milliseconds> = how long to wait before closing the file on inactivity (default:0 or 500),
# squote to use single quotes instead of double quotes for quoted program commands.
# shellhide to hide the command window when opening programs on the Windows platform.
# addFF to add a formfeed when closing, addLF to add a linefeed if the app doesn't.
# cp:<codepage number> to perform codepage translation, i.e. cp:437
# openps:<program>: start a program to open the file if the print output is detected to be PostScript.
# openpcl:<program>: start a program to open the file if the print output is detected to be PCL.
# openwith:<program>: start a program to open the file in all other conditions.
# openerror:<program>: start a program to open the file if an error had occurred.
# Example: parallel1=file file:output1.prn timeout:1000 openpcl:pcl6 openps:gswin32c openwith:notepad
# for printer:
# printer still has its own configuration section above.
# Note: LPT1-3 are standard LPT ports in DOS, whereas LPT4-9 are extended LPT ports.
# You can optionally specify base addresses and IRQs for them with base: and irq: options.
# Parallel port settings can also be changed via the built-in PARALLEL command.
# parallel2: see parallel1
# parallel3: see parallel1
# parallel4: see parallel1
# parallel5: see parallel1
# parallel6: see parallel1
# parallel7: see parallel1
# parallel8: see parallel1
# parallel9: see parallel1
# dongle: Enable dongle
parallel1 = printer
parallel2 = disabled
parallel3 = disabled
parallel4 = disabled
parallel5 = disabled
parallel6 = disabled
parallel7 = disabled
parallel8 = disabled
parallel9 = disabled
dongle = false
[printer]
# printer: Enable printer emulation.
# dpi: Resolution of printer (default 360).
# width: Width of paper in 1/10 inch (default 85 = 8.5'').
# height: Height of paper in 1/10 inch (default 110 = 11.0'').
# printoutput: Output method for finished pages:
# png : Creates PNG images (default)
# ps : Creates PostScript
# bmp : Creates BMP images (very huge files, not recommended)
# printer : Send to an actual printer in Windows (specify a printer, or Print dialog will appear)
# multipage: Adds all pages to one PostScript file or printer job until CTRL-F2 is pressed.
# device: Specify the Windows printer device to use. You can see the list of devices from the Help
# menu ('List printer devices') or the Status Window. Then make your choice and put either
# the printer device number (e.g. 2) or your printer name (e.g. Microsoft Print to PDF).
# Leaving it empty will show the Windows Print dialog (or '-' for showing once).
# docpath: The path (directory) where the output files are stored.
# fontpath: The path (directory) where the printer fonts (courier.ttf, ocra.ttf, roman.ttf, sansserif.ttf, script.ttf) are located.
# openwith: Start the specified program to open the output file.
# openerror: Start the specified program to open the output file if an error had occurred.
# printdbcs: Allows DOSBox-X to print Chinese/Japanese/Korean DBCS (double-byte) characters when these code pages are active.
# If set to auto (default), this is enabled only for the TrueType font (TTF) output with the DBCS support enabled.
# Only applicable when using a DBCS code page (932: Japanese, 936: Simplified Chinese; 949: Korean; 950: Traditional Chinese)
# Possible values: true, false, 1, 0, auto.
# shellhide: If set, the command window will be hidden for openwith/openerror options on the Windows platform.
# timeout: (in milliseconds) if nonzero: the time the page will be ejected automatically after when no more data arrives at the printer.
printer = true
dpi = 360
width = 85
height = 110
printoutput = png
multipage = false
device = -
docpath = .
fontpath = FONTS
openwith =
openerror =
printdbcs = auto
shellhide = false
timeout = 0
[dos]
# xms: Enable XMS support.
# xms handles: Number of XMS handles available for the DOS environment, or 0 to use a reasonable default
# shell configuration as commands: Allow entering dosbox-x.conf configuration parameters as shell commands to get and set settings.
# This is disabled by default to avoid conflicts between commands and executables.
# It is recommended to get and set dosbox-x.conf settings using the CONFIG command instead.
# Compatibility with DOSBox SVN can be improved by enabling this option.
# hma: Report through XMS that HMA exists (not necessarily available)
# hard drive data rate limit: Slow down (limit) hard disk throughput. This setting controls the limit in bytes/second.
# Set to 0 to disable the limit, or -1 (default) to use a reasonable limit.
# The disk I/O performance as in DOSBox SVN can be achieved by setting this to 0.
# floppy drive data rate limit: Slow down (limit) floppy disk throughput. This setting controls the limit in bytes/second.
# Set to 0 to disable the limit, or -1 (default) to use a reasonable limit.
# The disk I/O performance as in DOSBox SVN can be achieved by setting this to 0.
# ansi.sys: If set (by default), ANSI.SYS emulation is on. If clear, ANSI.SYS is not emulated and will not appear to be installed.
# NOTE: This option has no effect in PC-98 mode where MS-DOS systems integrate ANSI.SYS into the DOS kernel.
# log console: If set, log DOS CON output to the log file. Setting to "quiet" will log DOS CON output only (no debugging output).
# Possible values: true, false, 1, 0, quiet.
# share: Reports SHARE.EXE as resident and provides functions such as file-locking and record-locking, although not all SHARE functions are emulated.
# file access tries: If a positive integer is set, DOSBox-X will try to read/write/lock files directly on mounted local drives for the specified number of times without caching before failing on Windows systems.
# For networked database applications (e.g. dBase, FoxPro, etc), it is strongly recommended to set this to e.g. 3 for correct operations.
# network redirector: Report DOS network redirector as resident. This will allow the host name to be returned unless the secure mode is enabled.
# You can also directly access UNC network paths in the form \\MACHINE\SHARE even if they are not mounted as drives on Windows systems.
# Set either "ipx=true" in [ipx] section or "ne2000=true" in [ne2000] section for a full network redirector environment.
# minimum mcb free: Minimum free segment value to leave free. At startup, the DOS kernel will allocate memory
# up to this point. This can be used to deal with EXEPACK issues or DOS programs that cannot
# be loaded too low in memory. If you want more free conventional memory to be reported,
# you can for example set its value to 1.
# ems: Enable EMS support. The default (=true) provides the best
# compatibility but certain applications may run better with
# other choices, or require EMS support to be disabled (=false)
# to work at all.
# Possible values: true, emsboard, emm386, false, 1, 0.
# umb: Enable UMB support.
# quick reboot: If set, the DOS restart call will reboot the emulated DOS (integrated DOS or guest DOS) instead of the virtual machine.
#
# ver: Set DOS version. Specify as major.minor format. A single number is treated as the major version (compatible with LFN support). Common settings are:
# auto (or unset) Pick DOS kernel version 5.0 (DOSBox default)
# 3.3 MS-DOS 3.3 emulation (not tested!)
# 5.0 MS-DOS 5.0 emulation (recommended for DOS gaming)
# 6.22 MS-DOS 6.22 emulation
# 7.0 MS-DOS 7.0 (or Windows 95 pure DOS mode) emulation
# 7.1 MS-DOS 7.1 (or Windows 98 pure DOS mode) emulation
# Long filename (LFN) support will be enabled with a reported DOS version of 7.0 or higher with "lfn=auto" (default).
# Similarly, FAT32 disk images will be supported with a reported DOS version of 7.1 or higher.
#
# lfn: Enable long filename support. If set to auto (default), LFN support is enabled if the reported DOS version is at least 7.0.
# If set to autostart, the built-in VER command won't activate/deactivate LFN support according to the reported DOS version.
# Possible values: true, false, 1, 0, auto, autostart.
# fat32setversion: Whether DOSBox-X should automatically set the reported DOS version to 7.0/7.10 when it is less than 7.0/7.10 and mounting LBA/FAT32 disk images is requested.
# If set to "ask", a popup message will show up to ask whether DOSBox-X should automatically change the reported DOS version in order to mount the disk image.
# Possible values: ask, auto, manual.
# shellhigh: Load the DOSBox-X command shell into the upper memory when the UMB is available.
# If set to auto (default), it is enabled if the reported DOS version is at least 7.0.
# Possible values: true, false, 1, 0, auto.
# automount: Enable automatic drive mounting in Windows.
# automountall: Automatically mount all available Windows drives at start.
# Possible values: true, false, 1, 0, quiet.
# mountwarning: If set, a warning message will be displayed while trying to auto-mount your Windows host drives.
# autofixwarning: If set to true or both, DOSBox-X shows messages while trying to automatically fix the "Packed file is corrupt" error.
# If set to false or none, DOSBox-X will not show such messages on the screen when the error occurred.
# If set to "a20fix" or "loadfix", DOSBox-X will show the message for the a20fix or the loadfix only.
# Possible values: true, false, 1, 0, both, a20fix, loadfix, none.
# startcmd: Enable START command to start programs to run on the host system. On Windows host programs or commands may also be launched directly.
# starttranspath: Specify whether DOSBox-X should automatically translate all paths in the command-line to host system paths when starting programs to run on the host system.
# startwait: Specify whether DOSBox-X should wait for the host system applications after they are started.
# startquiet: If set, before launching host system applications to run on the host DOSBox-X will not show messages like "Now run it as a Windows application".
# vmware: Enable VMware interface emulation including guest mouse integration (when used along with e.g. VMware mouse driver for Windows 3.x).
# int33: Enable INT 33H for mouse support.
# mouse report rate: Mouse reporting rate, or 0 for auto. This affects how often mouse events are reported to the guest through the mouse interrupt.
# Some games including CyClone need a lower reporting rate to function correctly. Auto mode allows the guest to change the report rate through the PS/2 mouse emulation.
# This option does not affect any DOS game that uses polling through INT 33h to detect mouse movement.
# keyboardlayout: Language code of the keyboard layout (or none).
# customcodepage: Set a custom code page for CHCP command and specify a SBCS code page file, following the standard SBCS code page format.
# Examples of SBCS code pages are available from the Unicode Consortium website: https://www.unicode.org/Public/MAPPINGS/VENDORS/MICSFT/PC/
# dbcs: Enable DBCS table and Chinese, Japanese, Korean support for the TrueType font (TTF) output.
# CAUTION: Some software will crash without the DBCS table, including the Open Watcom installer.
# dos clipboard device enable: If enabled, a DOS device will be added for bidirectional communications with the shared clipboard.
# Setting to "read" will only allow read access, and setting to "write" will only allow write access.
# Setting to "full" or "true" enables both; setting to "false" or "disabled" disables the access or device.
# The default device name is CLIP$, but can be changed with the "dos clipboard device name" setting below.
# dos clipboard device name: Set DOS device name (up to 8 characters) for bidirectional communications with the shared clipboard.
# If unset or invalid, the default name CLIP$ will be used (e.g. "TYPE CLIP$" shows the clipboard contents).
# It has no effect if "dos clipboard device enable" is disabled, and it is deactivated if the secure mode is enabled.
# dos clipboard api: If set, DOS APIs for communications with the Windows clipboard will be enabled for shared clipboard communications.
# dos idle api: If set, DOSBox-X can lower the host system's CPU load when a supported guest program is idle.
#
# Advanced options (see full configuration reference file [dosbox-x.reference.full.conf] for more details):
# -> badcommandhandler; mscdex device name; hma allow reservation; command shell flush keyboard buffer; special operation file prefix; drive z is remote; drive z convert fat; drive z expand path; drive z hide files; hidenonrepresentable; hma minimum allocation; dos sda size; hma free space; cpm compatibility mode; minimum dos initial private segment; minimum mcb segment; enable dummy device mcb; maximum environment block size on exec; additional environment block size on exec; enable a20 on windows init; zero memory on xms memory allocation; vcpi; unmask timer on disk io; zero int 67h if no ems; zero unused int 68h; emm386 startup active; zero memory on ems memory allocation; ems system handle memory size; ems system handle on even megabyte; umb start; umb end; kernel allocation in umb; keep umb on boot; keep private area on boot; private area in umb; autoa20fix; autoloadfix; startincon; int33 hide host cursor if interrupt subroutine; int33 hide host cursor when polling; int33 disable cell granularity; int 13 disk change detect; int 13 extensions; biosps2; int15 wait force unmask irq; int15 mouse callback does not preserve registers; filenamechar; collating and uppercase; con device use int 16h to detect keyboard input; zero memory on int 21h memory allocation; pipe temporary device
#
xms = false
xms handles = 0
shell configuration as commands = false
hma = false
hard drive data rate limit = -1
floppy drive data rate limit = -1
ansi.sys = true
log console = false
share = true
file access tries = 0
network redirector = true
minimum mcb free = 0
ems = true
umb = true
quick reboot = false
ver =
lfn = auto
fat32setversion = ask
shellhigh = auto
automount = true
automountall = false
mountwarning = true
autofixwarning = false
startcmd = false
starttranspath = true
startwait = true
startquiet = false
vmware = true
int33 = true
mouse report rate = 0
keyboardlayout = auto
customcodepage =
dbcs = true
dos clipboard device enable = false
dos clipboard device name = CLIP$
dos clipboard api = true
dos idle api = true
[ipx]
# ipx: Enable ipx over UDP/IP emulation.
ipx = false
[ne2000]
# ne2000: Enable NE2000 Ethernet emulation. Either pcap or slirp backend can be used, switchable via "backend" option.
# Settings for the pcap and slirp backends can be found in the [ethernet, pcap] and [ethernet, slirp] sections.
# Once properly set, load the NE2000 packet driver inside DOSBox-X with base address and interrupt specified below.
# nicbase: The base address of the NE2000 board.
# nicirq: The interrupt it uses. Note serial2 uses IRQ3 as default.
# macaddr: The MAC address the emulator will use for its network adapter.
# If you have multiple DOSBox-Xes running on the same network,
# this has to be changed for each. AC:DE:48 is an address range reserved for
# private use, so modify the last three number blocks, e.g. AC:DE:48:88:99:AB.
# backend: The backend (either pcap or slirp is supported) used for the NE2000 Ethernet emulation.
# If set to "auto", then "slirp" is selected when available, otherwise "pcap" is selected when available.
# NE2000 Ethernet emulation will be disabled if no backend is available (or the specified backend if unavailable).
# Possible values: pcap, slirp, auto, none.
ne2000 = false
nicbase = 300
nicirq = 3
macaddr = AC:DE:48:88:99:AA
backend = auto
[ethernet, pcap]
# realnic: Specifies which of your host network interfaces is used for pcap.
# Write 'list' here to see the list of devices from the Help
# menu ('List network interfaces') or from the Status Window.
# Then make your choice and put either the interface number
# (e.g. 2) or a part of your adapters name (e.g. VIA here).
# timeout: Specifies the read timeout for the device in milliseconds for the pcap backend, or the default value will be used.
realnic = list
timeout = default
[ethernet, slirp]
# ipv4_network: The IPv4 network the guest and host services are on.
# ipv4_netmask: The netmask for the IPv4 network.
# ipv4_host: The address of the guest on the IPv4 network.
# ipv4_nameserver: The address of the nameserver service provided by the host on the IPv4 network.
# ipv4_dhcp_start: The start address used for DHCP by the host services on the IPv4 network.
#
# Advanced options (see full configuration reference file [dosbox-x.reference.full.conf] for more details):
# -> restricted; disable_host_loopback; mtu; mru; tcp_port_forwards; udp_port_forwards
#
ipv4_network = 10.0.2.0
ipv4_netmask = 255.255.255.0
ipv4_host = 10.0.2.2
ipv4_nameserver = 10.0.2.3
ipv4_dhcp_start = 10.0.2.15
[ide, primary]
# enable: Enable IDE interface
# pnp: List IDE device in ISA PnP BIOS enumeration
#
# Advanced options (see full configuration reference file [dosbox-x.reference.full.conf] for more details):
# -> irq; io; altio; int13fakeio; int13fakev86io; enable pio32; ignore pio32; cd-rom spinup time; cd-rom spindown timeout; cd-rom insertion delay
#
enable = true
pnp = true
[ide, secondary]
enable = true
pnp = true
[ide, tertiary]
enable = false
pnp = true
[ide, quaternary]
enable = false
pnp = true
[ide, quinternary]
enable = false
pnp = true
[ide, sexternary]
enable = false
pnp = true
[ide, septernary]
enable = false
pnp = true
[ide, octernary]
enable = false
pnp = true
[fdc, primary]
# enable: Enable floppy controller interface
# pnp: List floppy controller in ISA PnP BIOS enumeration
# mode: Floppy controller mode. What the controller acts like.
# ps2 PS/2 mode (most common)
# ps2_model30 PS/2 model 30
# at AT mode
# xt PC/XT mode
#
# Advanced options (see full configuration reference file [dosbox-x.reference.full.conf] for more details):
# -> irq; io; dma; int13fakev86io; instant mode; auto-attach to int 13h; chip
#
enable = false
pnp = true
mode = ps2
[4dos]
rem = This section is the 4DOS.INI file, if you use 4DOS as the command shell
[config]
# rem: Records comments (remarks).
# break: Sets or clears extended CTRL+C checking.
# Possible values: on, off.
# numlock: Sets the initial state of the NumLock key.
# Possible values: on, off.
# shell: Specifies the command shell (COMMAND.COM or 4DOS.COM).
# dos: Reports whether DOS occupies HMA and allocates UMB memory (if available).
# fcbs: Number of FCB handles available to DOS programs (1-255).
# files: Number of file handles available to DOS programs (8-255).
# country: Country code for date/time/decimal formats and optionally code page for TTF output and language files.
# lastdrive: The maximum drive letter (A-Z) that can be accessed by programs.
# Possible values: a, b, c, d, e, f, g, h, i, j, k, l, m, n, o, p, q, r, s, t, u, v, w, x, y, z.
rem = This section is DOS's CONFIG.SYS file, not all CONFIG.SYS options supported
break = off
numlock =
shell =
dos =
fcbs = 100
files = 200
country =
lastdrive = a
set path = Z:\;Z:\SYSTEM;Z:\BIN;Z:\DOS;Z:\4DOS;Z:\DEBUG;Z:\TEXTUTIL
set prompt = $P$G
set temp =
install =
installhigh =
device =
devicehigh =
[autoexec]
# Lines in this section will be run at startup.
# You can put your MOUNT lines here.