Difference between revisions of "DOSBox and Mac OS X"

From DOSBoxWiki
Jump to navigationJump to search
m (→‎Editing DOSBox preferences: changed Wikipedia link from external to interwiki)
 
(21 intermediate revisions by 16 users not shown)
Line 2: Line 2:
  
 
== Installing ==
 
== Installing ==
This guide will use the [[Version0.72|0.72]] Mac OSX version which is available for [http://www.dosbox.com/download.php?main=1 download].  The [[Version0.72|0.72]] release is compiled as a Universal Binary, and will run on PowerPC and Intel based Macs.  To install DOS first expand the [[ZIP Files|.ZIP]] file and copy the contents into a folder like '''<tt>DOSBox</tt>'''.  Move this folder into your '''<tt>Applications</tt>''' folder.
+
This guide will use the [[Version0.74|0.74]] Mac OSX version which is available for [http://www.dosbox.com/download.php?main=1 download].  The [[Version0.74|0.74]] release is compiled as a Universal Binary, and will run on PowerPC and Intel based Macs.  To install DOSBox, first expand the [[ZIP Files|.ZIP]] file and copy the contents into a folder like '''<tt>DOSBox</tt>'''.  Move this folder into your '''<tt>Applications</tt>''' folder.
  
Now you need to create a folder to [[MOUNT]] as your [[CDrive|C: drive]] and hold your [[GAMES|games]].  The most convenient location for this folder would be your home folder (which can be referenced as '''<tt>~</tt>''').  In This example we will call our folder '''<tt>DOSGAMES</tt>'''.  Inside this folder we can place all of the programs that we want to be available in our emulated DOS environment.  Remember that while these files are buried deep in the file system with paths like '''<tt>~/DOSGAMES/TESTDRV</tt>''', inside DOSBox they appear as though they reside in the root of thier mounted drive letter, so the above example in DOSBox would be located at '''<tt>C:\TESTDRV</tt>''' (assuming that '''<tt>~/DOSGAMES</tt>''' was mounted as [[CDrive|C:]]).
+
Now you need to create a folder to [[MOUNT]] as your [[CDrive|C: drive]] and hold your [[GAMES|games]].  The most convenient location for this folder would be your home folder (which can be referenced as '''<tt>~</tt>''').  In This example we will call our folder '''<tt>DOSGAMES</tt>'''.  Inside this folder we can place all of the programs that we want to be available in our emulated DOS environment.  Remember that while these files are buried deep in the file system with paths like '''<tt>~/DOSGAMES/TESTDRV</tt>''', inside DOSBox they appear as though they reside in the root of their mounted drive letter, so the above example in DOSBox would be located at '''<tt>C:\TESTDRV</tt>''' (assuming that '''<tt>~/DOSGAMES</tt>''' was mounted as [[CDrive|C:]]).
  
 
== Running DOSBox for the first time ==
 
== Running DOSBox for the first time ==
Double click on the DOSBox icon in Finder to launch DOSBox for the first time.  This will cause the DOSBox window to appear.  By default no drives are mounted (except the DOSBox default [[ZDrive|Z:]])  From here you need to mount your '''<tt>DOSGAMES</tt>''' folder.  Assuming you placed it inside your home folder you should eb able to run this command to [[MOUNT]] the folder.
+
Double click on the DOSBox icon in Finder to launch DOSBox for the first time.  This will cause the DOSBox window to appear.  By default no drives are mounted (except the DOSBox default [[ZDrive|Z:]])  From here you need to mount your '''<tt>DOSGAMES</tt>''' folder.  Assuming you placed it inside your home folder you should be able to run this command to [[MOUNT]] the folder.
<code><pre>Z:\>MOUNT C ~/DOSGAMES
+
 
Drive C is mounted as local directory /Users/[your username]/DOSGAMES/</pre></code>
+
Z:\>'''MOUNT C ~/DOSGAMES'''
 +
Drive C is mounted as local directory /Users/[your username]/DOSGAMES/
  
 
Now type this command to navigate to your newly mounted drive
 
Now type this command to navigate to your newly mounted drive
<code><pre>Z:\>C:
+
 
C:\></pre></code>
+
Z:\>'''C:'''
 +
C:\>
 +
 
 +
== Editing DOSBox preferences ==
 +
 
 +
After you first run DOSBox, go to the '''<tt>~/Library/Preferences/</tt>''' folder and open the newly created file '''<tt>DOSBox 0.74 Preferences</tt>'''. The exact folder name in the [[Wikipedia:Finder (software)|Finder]] may vary, depending on the language you use for OS X.
 +
 
 +
By editing this file, you can set the [[Dosbox.conf|system settings and initialization values]] that define your emulated environment. You can also add '''MOUNT''' commands to the [[AUTOEXEC]] [[Dosbox.conf#.5Bautoexec.5D|section]] at the bottom of the configuration files, so that you do not have to type them in every time you start DOSBox.
 +
 
 +
== Running DOSBox with custom config ==
 +
 
 +
You can create configuration file for individual games. It can hold specific configuration options and even commands for invoking game in the AUTOEXEC section. Then you can run DOSBox with your config by calling following command from terminal:
 +
 
 +
open -a DOSBox --args -conf path/to/your-config.conf

Latest revision as of 00:06, 10 December 2013

For long time users of the Apple Macintosh, the DOS environment might appear confusing at first. It helps to have experience with the System Terminal and the Command Line. Once set up however a simple shortcut will be all you need.

Installing

This guide will use the 0.74 Mac OSX version which is available for download. The 0.74 release is compiled as a Universal Binary, and will run on PowerPC and Intel based Macs. To install DOSBox, first expand the .ZIP file and copy the contents into a folder like DOSBox. Move this folder into your Applications folder.

Now you need to create a folder to MOUNT as your C: drive and hold your games. The most convenient location for this folder would be your home folder (which can be referenced as ~). In This example we will call our folder DOSGAMES. Inside this folder we can place all of the programs that we want to be available in our emulated DOS environment. Remember that while these files are buried deep in the file system with paths like ~/DOSGAMES/TESTDRV, inside DOSBox they appear as though they reside in the root of their mounted drive letter, so the above example in DOSBox would be located at C:\TESTDRV (assuming that ~/DOSGAMES was mounted as C:).

Running DOSBox for the first time

Double click on the DOSBox icon in Finder to launch DOSBox for the first time. This will cause the DOSBox window to appear. By default no drives are mounted (except the DOSBox default Z:) From here you need to mount your DOSGAMES folder. Assuming you placed it inside your home folder you should be able to run this command to MOUNT the folder.

Z:\>MOUNT C ~/DOSGAMES
Drive C is mounted as local directory /Users/[your username]/DOSGAMES/

Now type this command to navigate to your newly mounted drive

Z:\>C:
C:\>

Editing DOSBox preferences

After you first run DOSBox, go to the ~/Library/Preferences/ folder and open the newly created file DOSBox 0.74 Preferences. The exact folder name in the Finder may vary, depending on the language you use for OS X.

By editing this file, you can set the system settings and initialization values that define your emulated environment. You can also add MOUNT commands to the AUTOEXEC section at the bottom of the configuration files, so that you do not have to type them in every time you start DOSBox.

Running DOSBox with custom config

You can create configuration file for individual games. It can hold specific configuration options and even commands for invoking game in the AUTOEXEC section. Then you can run DOSBox with your config by calling following command from terminal:

open -a DOSBox --args -conf path/to/your-config.conf