mirror of
https://github.com/digarok/gsplus.git
synced 2024-11-24 06:34:02 +00:00
48 lines
2.1 KiB
Plaintext
48 lines
2.1 KiB
Plaintext
Getting started
|
||
===============
|
||
|
||
1. Download the emulator package from https://apple2.gs/plus and put it in a folder.
|
||
Yes, you can drag it into your Applications on a Mac, but be aware that it is still
|
||
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:
|
||
/Applications/GSplus.app/Contents/MacOS/gsplus
|
||
|
||
2. Download the Apple IIgs Firmware ROMs, for either a ROM01 or ROM03 machine.
|
||
(If you have a real IIgs, there are ways to save it from your machine too.)
|
||
Try: ftp://ftp.apple.asimov.net/pub/apple_II/emulators/rom_images/
|
||
a. Put the ROM image in the same folder where you run the emulator from.
|
||
It will search for: "ROM", "ROM.01", "ROM.03"
|
||
If your ROM image is named differently, launch the program from the command line
|
||
and hit F4 to go to the config menu to choose your ROM location
|
||
|
||
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/
|
||
|
||
4. Edit your config:
|
||
You can manually edit the config.txt file, or while the emulator is running hit F4
|
||
to enter config menu.
|
||
|
||
Set it to point to your IIgs ROM file from step 2 if not already configured.
|
||
Set up the slots to point to disks from step 3.
|
||
|
||
5. Boot the Apple IIgs by running the emulator
|
||
Windows: gsplus32.exe
|
||
Mac/Ubuntu: ./gsplus
|
||
Mac (if in Apps) /Applications/GSplus.app/Contents/MacOS/gsplus
|
||
|
||
If the config file can’t be found, it will try to create a config.txt file for you,
|
||
with all of the defaults.
|
||
|
||
Note: You can also specify a config file. This is very useful as you can have specific
|
||
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.
|
||
|
||
Examples:
|
||
Windows: gsplus32.exe -config arkanoid.gsp
|
||
Mac/Ubuntu: ./gsplus -config choplifter_config.txt
|
||
|