(Last updated March 21, 2024)

Downloading jGRASP

Go to the following page:

This page contains an optional survey by the jGRASP authors; you may scroll down and skip it. We recommend installing the lastest stable, non-beta version of the jGRASP editor. At the time of writing, this was version 2.0.6_16. Locate the appropriate download link and click it:

Save the file to your desktop or another convenient location.

Installing jGRASP

Windows

Open the .exe file you just downloaded. A setup wizard will appear.

The default settings are reasonable for most users, and you can complete the installation by repeatedly clicking "Next".

At this point, you will have a new jGRASP shortcut on your desktop. Double-click it to open jGRASP:

If you see this, you're all set!

NOTE: You will likely see jGRASP warnings pop up saying that jGRASP has not been tested with this Java Version or that this version is from an unsupported vendor:

These warnings happen because latest stable version of jGRASP has not yet been tested with the latest Adoptium JDK release. You can dismiss these pop up windows, and everything should still work fine.

If you get the following error:

then your system does not yet have the JDK installed. Make sure you followed the JDK installation instructions, and try again.

macOS

Open the .pkg file you just downloaded. You may receive an error about jGRASP being from an "unidentified developer":

This is due to a macOS "feature" that makes it difficult to run applications not distributed via Apple's official channels. To run the jGRASP installer regardless, bypassing this "feature", right click the .pkg file and choose "open". You will see an installation wizard.

The default settings are reasonable for most users, and you can complete the installation by repeatedly clicking "Continue".

You can now run jGRASP by opening jGRASP.app from the Applications folder. One way to do this is to press Cmd+Space, type "jGRASP", and press Enter:

If jGRASP opens successfully, then you're all set!

NOTE: You will likely see jGRASP warnings pop up saying that jGRASP has not been tested with this Java Version or that this version is from an unsupported vendor:

These warnings happen because latest stable version of jGRASP has not yet been tested with the latest Adoptium JDK release. You can dismiss these pop up windows, and everything should still work fine.

If you get the following error:

then you don't have the JDK installed. Make sure you followed the JDK installation instructions, and try again.

Linux

Extract the .zip file you just downloaded to some permanent location. ~/jgrasp, ~/opt/jgrasp, or /usr/local/jgrasp would all be reasonable locations, but anything will do. cd into that directory and run java -jar jgrasp.jar. If all goes well, you should see this:

If you get an error about java being missing, follow the JDK installation instructions, and try again.

If you run into issues, or have additional information to contribute to this section, contact us.