Apple-2-Tools
/
gsplus
mirror of https://github.com/digarok/gsplus.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
gsplus/doc
History
Matt Keller 9df65dfd85 fix macos dependencies 
Needs cmake and pkg-config to build on macos (still possible without
pkg-config by using ccmake and editing flags/libraries manually, which
is a pain.)
 		2019-07-28 16:08:38 -04:00
..
web v0.14 release 2018-09-11 17:06:05 -05:00
Developer-QuickStart-Linux.txt gitlab-ci integration for cmake - all platforms 2019-05-11 09:10:08 -05:00
Developer-QuickStart-MacOSX.txt fix macos dependencies 2019-07-28 16:08:38 -04:00
Developer-QuickStart-Rpi.txt fix sdl2 keymap on non-apple systems and add rpi doc 2018-08-24 23:20:47 -05:00
Developer-QuickStart-Win32_SDL2.txt New CI pushes builds to S3 and creates an updated webpage in final stage 2018-08-09 14:39:55 -05:00
GitlabCI-Runner-Linux.txt Win32 SDL2 builds on Cygwin against Mingw SDL2 libs, new docs and log cleanup 2018-07-25 14:33:16 -05:00
GitlabCI-Runner-MacOSX.txt Win32 SDL2 builds on Cygwin against Mingw SDL2 libs, new docs and log cleanup 2018-07-25 14:33:16 -05:00
GitlabCI-Runner-Win32-SDL.txt Win32 SDL2 builds on Cygwin against Mingw SDL2 libs, new docs and log cleanup 2018-07-25 14:33:16 -05:00
README.txt slightly better clarification on usage 2017-01-22 22:11:48 -06:00
gsplusmanual.pdf v0.14 release 2018-09-11 17:06:05 -05:00

README.txt

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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
   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 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

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/

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