Welcome to MorphOS-Storage, a webserver dedicated to MorphOS users. ©2016-2024 Meta-MorphOS.org
Description:RunInDOSBox allows double-clicked MS-DOS programs to be automatically redirected to run inside DOSBox.
Developer/Porter:Christopher Handley
Homepage:http://cshandley.co.uk/
Readme:
RunInDOSBox
===========
r1 (05.02.2013)
by Christopher Handley

Contents
++++++++
1. Introduction
2. Installation
2.1. AmigaOS4
2.2. MorphOS
2.3. AROS
3. Usage
3.1. DOSBox tips
3.2. From the Shell or a script
3.3. From eGame or AmiDock
4. FAQ (Frequently Asked Questions)
4.1. DOSBox crashes on exit (MorphOS ONLY)
4.2. RunInDOSBox won't open any .bat files (AmigaOS4 ONLY)
4.3. RunInDOSBox won't open any .com files (AmigaOS4 ONLY)
4.4. RunInDOSBox won't open any .exe files (AmigaOS4 ONLY)
5. Additional notes
6. Contact details
7. The future
8. Thanks
9. History


1. Introduction
+++++++++++++++
RunInDOSBox allows double-clicked MS-DOS programs to be automatically redirected
to run inside DOSBox. (This is not quite true for AROS users, who will need to
either use eGame (or a shell script) to start MS-DOS programs.)

Note that eGame is compatible with RunInDOSBox, and provides a quick way of
starting your (MS-DOS) games, no matter which OS you use.


2. Installation
+++++++++++++++
2.1. AmigaOS4
-------------
Please follow these steps:

1. If you don't have DOSBox installed, then please download & install it from:
http://os4depot.net/index.php?function=showfile&file=emulation/computer/dosbox.lha
(Installation is just unarchiving it wherever you want to keep it.)

DOSBox needs a newer version of SDL than comes with AmigaOS4.1 (Update 5), so
you may have to download from here:
http://os4sdl.googlecode.com/files/SDL-1.2.13-SVNr49-shared.lha
(Install it by copying "libSDL-1.2.so" to the "Sys:SObjs" folder.)

2. If you have never run DOSBox before, then please run it once by
double-clicking on the "DOSBox" program (and then close it). This lets
AmigaOS4's AppDir: (and thus RunInDOSBox) know where to find it.

3. Next double-click on RunInDOSBox's "Install" icon. This will copy a few
files to their required locations.


4. This final step cannot be automated, so the installer will start
Sys:Prefs/DefIcons for you (i.e. DefIcons program in the Prefs folder on OS4's
system partition.). In the window that opens:

(a) If you *only* want to run DOS .exe files, then you do not need to do
anything! So click the "Cancel" button, and JUMP TO STEP 5.

(b) If you *only* want to run DOS games via eGame, then you do not need to do
anything! So click the "Cancel" button, and JUMP TO STEP 5.

(c) If you want to run DOS .bat files, then please follow the instructions given
in section "4.2. RunInDOSBox won't open any .bat files (AmigaOS4 ONLY)".

(d) If you want to run DOS .com files, then please follow the instructions given
in section "4.3. RunInDOSBox won't open any .com files (AmigaOS4 ONLY)".

(e) Finally click on the "Save" button.


5. Opening the "test_demo" folder. Inside it you should see the file
"Urgent.EXE". If it does NOT have a "DOSBox" icon, then you need to follow the
instructions given in section "4.4. RunInDOSBox won't open any .exe files (AmigaOS4 ONLY)".

6. You can now test that RunInDOSBox works, by double-clicking on "run_test".
DOSBox should open on it's own screen, and you should then see & hear a simple
demo. The demo does not respond to Escape, so you will need to press
Ctrl-Alt-F9 to quit DOSBox.

2.2. MorphOS
------------
Please follow these steps:

1. If you don't have DOSBox installed, then please download & install it from:
http://morphos-files.net/find.php?find=dosbox
(Installation is just unarchiving it wherever you want to keep it.)

You also need to install PowerSDL:
http://aminet.net/package/util/libs/powersdl

2. Next double-click on RunInDOSBox's "Install" icon. (The first time
RunInDOSBox is installed, it will ask where to find DOSBox.) It will then copy
a few files to their required locations.

3. Opening the "test_demo" folder. Inside it you should see the file
"Urgent.EXE", which should have a "DOSBox" icon.

4. You can now test that RunInDOSBox works, by double-clicking on "run_test".
DOSBox should open on it's own screen, and you should then see & hear a simple
demo. The demo does not respond to Escape, so you will need to press
Ctrl-Alt-F9 to quit DOSBox.

2.3. AROS
---------
Please follow these steps:

1. If you don't have DOSBox installed, then please download & install it from:
http://aminet.net/package/misc/emu/dosbox_0.73b-aros_x86
(Installation is just unarchiving it wherever you want to keep it.)

2. Next double-click on RunInDOSBox's "Install" icon. (The first time
RunInDOSBox is installed, it will ask where to find DOSBox.) It will then copy
a few files to their required locations.

3. You can now test that RunInDOSBox works, by double-clicking on "run_test".
DOSBox should open on it's own screen, and you should then see & hear a simple
demo. The demo does not respond to Escape, so you will need to press
Ctrl-Alt-F9 to quit DOSBox.


3. Usage
++++++++
AmigaOS4 & MorphOS users can now double-click any .EXE or .COM file to run it.
If you are an AmigaOS4 user who followed the optional installation steps, then
you can also run .BAT files. MorphOS users can run .BAT files without any extra
steps.

AROS users will need to use eGame to run .EXE, .COM & .BAT files, or otherwise
create script files like "run_test" (see the section "3.2. From the Shell or a script").


When an MS-DOS program is run, you will briefly see a reminder that you can quit
DOSBox by pressing Ctrl-Alt-F9. This message will disappear on it's own, but
you can dismiss it immediately by pressing Enter.

When you have finished with the MS-DOS program, it is best to try to quit the
program normally. Often there will be a Quit or "Exit to DOS" option. If you
don't see any, then try pressing the Escape key, as many programs quit when you
do this. If the program quits, then DOSBox will close & return you to
Workbench. But if you can't quit normally, then you can force DOSBox to close
by pressing Ctrl-Alt-F9.

Note that while DOSBox is running, you can use the normal Amiga hotkeys
LeftAmiga-N to return to Workbench, and LeftAmiga-M to cycle screens.

RunInDOSBox makes DOSBox use the "RunInDOSBox.conf" file, so edit that if you
want to fiddle with it's settings. But beware this file *may* be overwritten
when you install a newer version of RunInDOSBox.

*WARNING: If MorphOS users find that DOSBox crashes on exit*, then please
read section "4.1. DOSBox crashes on exit (MorphOS ONLY)".

3.1. DOSBox tips
----------------
When DOSBox is running, you can press Alt-Enter to switch between Full Screen &
Windowed mode.

Some MS-DOS games/demos allow you to choose what graphics & sound you have.
Here is a quick guide as to what DOSBox supports:

* Video: If possible choose VGA, otherwise EGA, otherwise CGA. Do NOT choose
Tandy or Hercules!

* Sound: If possible choose SoundBlaster 16 or Adlib (I'm not sure which is
best). Otherwise choose a plain SoundBlaster. Only choose PC Speaker if you
have no other choice. Do NOT choose Gravis Ultrasound.

* SoundBlaster settings, if required: Port=220, IRQ=7, DMA=1.

* MIDI: This is not supported, so don't bother! (Unless you see an "FM"
option.)

* Joystick: I haven't tried this yet, so I don't know if it is supported or
not. Let me know!

3.2. From the Shell or a script
-------------------------------
If you want to run an MS-DOS program from the Shell or a script, then you just
need to put "RunInDOSBox" before it. For example:

RunInDOSBox Urgent.EXE

You can also tell RunInDOSBox to run the program in a window on Workbench:

RunInDOSBox Urgent.EXE WINDOW

If DOS32A causes any compatibility problems (I haven't found any yet), then you
can disable it like so:

RunInDOSBox Foobar.EXE NoDOS32A

If DOSBox is quitting before you are able to see any error message (when trying
to run a program), then you can tell it to not auto-exit:

RunInDOSBox Foobar.EXE NoExit


Advanced users can have CD images (ISOs) mounted (for games like Terminator
Future Shock or Tomb Raider 1) :

RunInDOSBox FShock/Shock.exe cdISO FutureShock.iso

You can also mount a folder as a fake CD:

RunInDOSBox FShock/Shock.exe CDdir FShockCD

3.3. From eGame or AmiDock
--------------------------
You can treat an MS-DOS game like any other game, by dropping it's executable on
eGame's window to add it.

AmigaOS4: If you FIRST snapshot the icon of say a .EXE file, then you can add
it to AmiDock.


4. FAQ (Frequently Asked Questions)
+++++++++++++++++++++++++++++++++++
4.1. DOSBox crashes on exit (MorphOS ONLY)
------------------------------------------
If you are finding that DOSBox crashes on exit (such that you have a 'frozen'
DOSBox window), then you will have to disable DOSBox's sound. You can do this
by going to DOSBox's folder, opening "RunInDOSBox.conf" with Editor (or another
text editor), searching for the nosound=false line, and then changing it to
true, so that it looks like this:

nosound=true

4.2. RunInDOSBox won't open any .bat files (AmigaOS4 ONLY)
----------------------------------------------------------
If you want RunInDOSBox to work with .BAT files, then follow these instructions:

(a) If DefIcons is not already running, then double-click on Sys:Prefs/DefIcons.
(i.e. the DefIcons program in the Prefs folder on OS4's system partition.)

(b) Under "Filetypes", look for "ascii" with a white box on it's left. It
should become obvious if you click once on the white box to the left of
"system".

(c) Click on "ascii" (but not on it's white box!). Then click on the (left)
"Add" button below it, and for "Name" replace the "<new>" text with "msdos"
(without quotes of course), then press Enter.

(d) With "msdos" still selected (under "Filetypes"), LOOK UNDER "Actions".
Click on the (right) "Add" button, and (while your left mouse button is still
pressed) choose "PATTERN". In the "Pattern:" box below, enter "#?.bat" (without
quotes).

(e) Finally click on the "Save" button.

4.3. RunInDOSBox won't open any .com files (AmigaOS4 ONLY)
----------------------------------------------------------
If you want RunInDOSBox to work with .COM files, then follow these instructions:

(a) If DefIcons is not already running, then double-click on Sys:Prefs/DefIcons.
(i.e. the DefIcons program in the Prefs folder on OS4's system partition.)

(b) Under "Filetypes", please click on "project". Then click on the (left)
"Add" button below it, and for "Name" replace the "<new>" text with "msdos"
(without quotes of course), then press Enter.

(c) With "msdos" still selected (under "Filetypes"), LOOK UNDER "Actions".
Click on the (right) "Add" button, and (while your left mouse button is still
pressed) choose "PATTERN". In the "Pattern:" box below, enter "#?.com" (without
quotes).

(d) Finally click on the "Save" button.

4.4. RunInDOSBox won't open any .exe files (AmigaOS4 ONLY)
----------------------------------------------------------
If you don't get a "DOSBox" icon for any DOS .exe files, then follow these
instructions:

(a) If DefIcons is not already running, then double-click on Sys:Prefs/DefIcons.
(i.e. the DefIcons program in the Prefs folder on OS4's system partition.)

(b) Under "Filetypes", please click on "project". Then click on the (left)
"Add" button below it, and for "Name" replace the "<new>" text with "msdos"
(without quotes of course), then press Enter.

(c) With the new "msdos" still selected (under "Filetypes"), LOOK UNDER
"Actions". Click on the (right) "Add" button, and (while your left mouse button
is still pressed) choose "PATTERN". In the "Pattern:" box below, enter "#?.exe"
(without quotes).

(d) Click on the (right) "Add" button, and (while your left mouse button is
still pressed) choose "MATCH". In the "Match:" box below, enter "MZ" (without
quotes).

(e) If you did that correctly, then under "Actions" you should see:
* PATTERN #?.exe
* MATCH 0 "MZ" Case sensitive

(f) Finally click on the "Save" button.


5. Additional notes
+++++++++++++++++++
To speed-up some games, DOS/32A is automatically used for DOS4GW-based games.
It's license requires the following sentence to be included in the
documentation:

This product uses DOS/32 Advanced DOS Extender technology.


6. Contact details
++++++++++++++++++
If you have any problems with RunInDOSBox, then let me know! You can contact me
by email, using the address given on this web page:

http://cshandley.co.uk/email

If for some reason you cannot email me, then I can be found on AmigaWorld.net &
www.Amigans.net as "ChrisH". I suggest you PM me on AmigaWorld.net, as I may
not notice forum posts (nor PMs on Amigans.net!).


7. The future
+++++++++++++
Here is a list of POSSIBLE thing that I might add:

* A simple GUI to choose whether it defaults to Full Screen or Windowed, and to
disable the reminder about how to quit DOSBox.

If you are interested in any of these ideas, or have any suggestions of your
own, then feel free to email me! Your input may help me decided what to do
next.


8. Thanks
+++++++++
In chronological order, thanks to:
* Chris Young, for testing & various suggestions, especially the idea of using DOS/32A.
* D.Brink1975, Scott Cabit, Samir Hawamdeh, Allan Ullmann & Joel Edberg for alpha-testing.
* Ilkka "Itix" Lehtoranta, for answering my MorphOS filetype questions.

Sorry if I missed anyone.


9. History
++++++++++
r1 (05.02.2013)
* Made the installer & RunInDOSBox work on MorphOS & AROS.
* Added the "NoExit" parameter.
* Fixed the "CDdir" parameter not working.
* Fixed a potential crash/instability when starting DOSBox.
* DOSBox now grabs the mouse in window mode, and so I've had to show the how-to-quit message for window mode too.

r0 alpha 2 (15-11-2012)
* DOS4GW-based games should now run a bit faster, as DOS/32A will be automatically used.
* Added the "CDdir" parameter, so CDs can be emulated using the contents of a folder (rather than using an ISO file).

r0 alpha 1 (20-10-2012)
* First (private) release.


Upload Date:Apr 25 2017
Category:Emulation
Download:RunInDosBox_1.1.lha
Md5:4b6a9fd7d5057689143744e2b33d519f
Size:488 KB
Downloads:291
Screenshot(s)
History
Last Comments