Installation

To install JoeyLib, you will need the following:

For all targets:
- A Ubuntu-flavored 64 bit Linux Machine (stock Debian does not have all the needed packages)
For building JoeyLib for the Apple IIgs:
- ISO of Opus II: The Software
- MSI from and GIT access to Golden Gate
For building JoeyLib for macOS:
- XIP file of XCode 9.4.1 (Requires free Apple ID)
- A ridiculous amount of disk space (30+ gig free - seriously)

From a shell prompt on your Linux system, as a user that has sudo privileges (not root!), enter:

mkdir joey
cd joey
wget https://skunkworks.kangaroopunch.com/skunkworks/joeylib/raw/master/scripts/installer.sh
chmod +x installer.sh
./installer.sh

The installer will prepare your system and then present a menu of platforms on which you can build JoeyLib. The following items will be created in the same folder as installer.sh:

installWork/ - Temporary folder containing intermediate files
dist/ - Final JoeyLib binaries, header files, and helper scripts
sdks/ - Various tools needed to work with some of the supported platforms
joeylib/ - The source code to JoeyLib itself
joeyDev.sh - A script to run to set up your system environment to use JoeyLib

If you are low on space, you can delete installWork/ once you have built all the desired JoeyLib platforms. However, re-running the installer to update or modify your JoeyLib binaries will re-download and re-create much of what is stored there.