(Last updated March 21, 2024)

CSE 14x Course Software

Option 1 (recommended):

For the most simple installation, we recommend using jGRASP's Bundled installation that includeds a supported version of the JDK.

  • Bundled installation
  • NOTE: This option will only allow you to use jGRASP, so if you plan to use development environments other than jGRASP you should follow the "Option 2" instructions below to install JDK and jGRASP separately.

    Option 2:

    This option might lead to bothersome error messages in jGRASP, but would be preferrable if you wish to use development environments other than jGRASP. You will need to download and install two pieces of software: the Java compiler (known as the JDK) and a Java development environment called jGRASP. Follow these instructions:

    1. JDK installation
    2. jGRASP installation

    Some users already have the JDK installed on their computers because of other software that they use that is written in Java. If you think this applies to you, you can safely skip the JDK section of this guide, although you may find that you need to come back and complete it anyway.

    If you are having any trouble getting Java and jGRASP installed on your machine, contact Jonathan Sanders


    We will keep this page updated with solutions to frequently-encountered issues, listed below. If you have a solution to add to the list, please contact us!

    Missing compiler error messages

    Some users who have their OS configured with a non-English primary language cannot properly see the compiler errors in jGRASP. To fix this problem, follow these steps in jGRASP.

    Click "Settings" -> "Compiler Settings" -> "Workspace".

    In the settings box that pops up, click the "Flags / Args" tab (in the lower row of tabs). Then, click the black "button" under "FLAGS or ARGS" and next to "Compile". In the text box that becomes available type in -J-Duser.language=en and click "OK".

    (Thanks to former TA Eric Spishak for this tip!)

    "unable to encode text using charset us-ascii" errors

    Some Windows users who have their OS configured with a non-English primary language encounter an "unable to encode text using charset us-ascii" error when closing jGRASP. This seems to happen after opening and closing a file whose path contains non-English characters. Until this bug is fixed in jGRASP, we recommend only storing your Java files in folders with English names. Sorry about that!

    Once jGRASP has seen a file with a non-English path, it will remember it, even if you‘ve renamed the folder. To make it forget about the old path and stop displaying this error message, you‘ll need to delete your jGRASP workspace and create a new default one. Before doing this, make sure you know where on your computer your Java code is saved, because jGRASP will forget which files and folders you have open.

    1. Make sure jGRASP is closed.
    2. Open C:\Users\YOUR_USERNAME\ in Windows Explorer and delete the folder named .grasp_settings.
    3. Re-open jGRASP.

    This will reset jGRASP back to its default settings, making it forget the old filename.