gsplus/doc/README.txt

51 lines
2.2 KiB
Plaintext
Raw Normal View History

2017-01-23 04:11:48 +00:00
Getting started
2016-11-03 02:28:16 +00:00
===============
2017-01-22 22:27:18 +00:00
1. Download the emulator package from https://apple2.gs/plus and put it in a folder.
2017-01-23 04:11:48 +00:00
Yes, you can drag it into your Applications on a Mac, but be aware that it is
meant to be launched from a command line. If you put it in Applications, you
should be able to run it with the terminal command:
2017-01-22 22:27:18 +00:00
/Applications/GSplus.app/Contents/MacOS/gsplus
2016-11-03 02:28:16 +00:00
2. Download the Apple IIgs Firmware ROMs, for either a ROM01 or ROM03 machine.
2017-01-22 22:27:18 +00:00
(If you have a real IIgs, there are ways to save it from your machine too.)
2016-11-03 02:28:16 +00:00
Try: ftp://ftp.apple.asimov.net/pub/apple_II/emulators/rom_images/
2017-01-23 04:11:48 +00:00
a. Put the ROM image in the same folder where you run the emulator from.
2017-01-22 22:27:18 +00:00
It will search for: "ROM", "ROM.01", "ROM.03"
2017-01-23 04:11:48 +00:00
If your ROM file has some other name, launch gsplus and hit F4 to go to
the config menu to choose your ROM under "ROM File Selection"
... or ...
3. Edit your config:
You can manually edit the config.txt file (or use the F4 menu.)
You can set disks using a slot/number syntax like:
s5d1 = images/ArkanoidII.po
s6d1 = images/ProDOS_2_4_1.dsk
s7d1 = images/gsos.2mg
You can also manually set your ROM path like:
g_cfg_rom_path = ../roms/gsrom03
2017-01-22 22:27:18 +00:00
3. Get some Apple IIgs software.
I recommend the excellent Apple IIgs dedicated site:
http://www.whatisthe2gs.apple2.org.za/
If you have a real IIgs, you can transfer your disks using ADTPro
http://adtpro.sourceforge.net/
2016-11-03 02:28:16 +00:00
5. Boot the Apple IIgs by running the emulator
2017-01-22 22:27:18 +00:00
Windows: gsplus32.exe
Mac/Ubuntu: ./gsplus
Mac (if in Apps) /Applications/GSplus.app/Contents/MacOS/gsplus
2017-01-23 04:11:48 +00:00
If the config file cant be found, it will try to create a config.txt file for you,
2017-01-22 22:27:18 +00:00
with all of the defaults.
2017-01-23 04:11:48 +00:00
2017-01-22 22:27:18 +00:00
Note: You can also specify a config file. This is very useful as you can have specific
2017-01-23 04:11:48 +00:00
disks/setting pre-set in a config file and launch directly into your favorite game with
that config. They can be named anything you want, though the officially recognized
extensions are .txt and .gsp.
2017-01-22 22:27:18 +00:00
Examples:
Windows: gsplus32.exe -config arkanoid.gsp
Mac/Ubuntu: ./gsplus -config choplifter_config.txt