User Setup Guide
Setting up the software is quite easy.
- Download the
Legup.jarfile. - Double click on the file to run it.
Reference this website: https://askubuntu.com/questions/101746/how-can-i-execute-a-jar-file-from-the-terminal
And that's it! But if you're still reading this, that means you probably ran into some problems. There are two troubleshooting guides: one for Windows and one for macOS.
If you're using a Windows computer, refer to this troubleshooting guide.
If you're using Mac, refer to this troubleshooting guide.
Note: both setup guides assume that you have already downloaded the Legup.jar file.
While the screenshots provided were taken on a laptop running Windows 10, these instructions should still work on Windows 7 and Windows 8 machines.
LEGUP jar file defaults to Internet Explorer (or another application)
If you are absolutely sure that Java is not installed, you can skip straight to the last step, which contains the link to install Java. If you're not 100% sure, you can start from the first step to verify whether or not Java is installed.
- Click on the Windows button
⊞ Winto bring up the start menu. Search up for the application called Command Prompt and open it. The window that comes up should look something like this:
- Type in the command
java --version. If Java is not installed, you should see a message that reads:
'java' is not recognized as an internal or external command, operable program or batch file.
If Java is installed, you should see a message similar to the following:
java 15 2020-09-15
Java(TM) SE Runtime Environment (build 15+36-1562)
Java HotSpot(TM) 64-Bit Server VM (build 15+36-1562, mixed mode, sharing)
Below is a sample screenshot of the error message that would appear if Java is not installed.
- If Java is not installed, go to https://www.oracle.com/java/technologies/downloads/ and follow the instructions on the website. Once that is done, you should be able to open the
Legup.jarfile without problems. Make sure to install a JRE that supports Java 21.
- Right click the
Legup.jarfile. A menu should pop up, and you should see an option that readsOpen with.... (See image below for clarification.)
- On the subsequent window that pops up, select to open the file through Open JDK Platform. If you do not see the Open JDK Platform option, you most likely do not have Java installed. Please refer to the "Java not installed" section.
When running the LEGUP jar you may be presented with this message:
If you see this message, please go to the Java download page. Download and install Java then you should be able to run the application. Make sure to install a JRE that supports Java 21.
When running the LEGUP jar you may be presented with this message:
If you see this message do the following:
- Open Finder and navigate where you Legup.jar is located
- Right click the Legup.jar
- Hold down the option key and click "Open"
- Now you can click Open on the new message and LEGUP should be running
The file select screen may appear empty even when there are files within a given directory. This is because LEGUP does not have access to the corresponding folder.
Normally, when LEGUP first attempts to read the file system, there is a popup that requests access. If you accidentally clicked "Do not allow", then you will have to manually allow access.
- Open System Settings -> Privacy and Security -> Full Disk Access
- Scroll down the list of applications and click on the '+' icon at the bottom.
- Navigate to /System/Library/CoreServices/JavaLauncher.app either through the UI or using Cmd+Shift+H and pasting the address. If the app doesn't exist, you likely don't have Java installed (in which case how did you open the application?).
Make sure that the slider is set to on (like the image above).
- Try reopening LEGUP.