Builder _ Installation _ Windows
Only three steps are required to get the Builder running for the first time:
- Downloading the GUIslice Builder executable
- Ensuring Java is available
- Adding Java path to environment variables
EMAIL SUPPORT: During the beta, please feel free to send an email to [email protected] with any comments, questions or suggestions you might have
GUIslice Builder binary location:
- In the latest GUIslice Builder repo Release Notes under Assets, you will find
builder-win-X.Y.Z.zip- Look for the highest version number
- Unzip this archive and then follow the steps below
- When you unzip the archive, you will find a Windows Installer executable:
builder-win-X.Y.Z.exe
- When you unzip the archive, you will find a Windows Installer executable:
The GUIslice Builder is written in Java, which generally requires downloading of the Java executable (runtime).
One needs to install either Java JRE or JDK version 8 (or higher). For those with the Arduino IDE 1.8.7 (or later) installed, no additional Java installation is required as the IDE already contains Java 8 JRE (please refer to Option A below).
The Arduino IDE automatically included a Java8 installation. You will need to ensure that the GUIslice Builder can find this java installation. By default, it might be located at:
C:\Program Files (x86)\Arduino\javaC:\arduino-1.8.7\java
Once you have confirmed this location, note it down as we will use this path in the Installer.
To install the Java 8 runtime, you can use Oracle's JRE. You can also download the latest version of OpenJDK from OpenJDK.
Oracle's latest version is 221 and the site is:
You then need to run the downloaded file:
jre-8u192-windows-x64.exe
Now we are ready to continue with the Builder installer executable.
- Double-click on the Builder installer executable that was unzipped earlier (
builder-win-X-Y-Z.exe). - Windows will usually present the typical security warning dialog box to confirm you wish to install. Click Run.
- NOTE: You might see a Microsoft SmartScreen warning as shown below ("Windows protected your PC"). In recent builds of Windows 10, this warning is expected since (like most open source software) we don't have enough downloads yet for Microsoft to "whitelist" each version of our installer. You can always confirm the security of the application by reviewing the published source code.
- Click on the More Info text link then the Run anyway button
- Windows will then show the typical yellow "User Account Control" dialog box, confirming you wish to install. Click Yes.
- The GUIsliceBuilder setup wizard will launch, at which you can click Next >
- A License Agreement dialog will be shown, simply reminding users that this is free software with no restrictions (per the MIT License). Click on "I accept the agreement" and Next >.
- The user will then be presented with a choice for the GUIslice project folder. It is strongly recommended to select your Arduino Sketchbook folder. For example:
- Next, the installer will ask for the location where Java was installed. This will configure the JAVA_HOME environment variable to point to the correct location so that the Builder can find it. Please enter the location that was identified in an earlier step (eg. See Option A above).
- The wizard will then ask for the location that the Builder executable should be installed. Normally, the program would be installed into the Program Files directory:
- Next, the wizard will ask if you'd like to create a desktop shortcut for the GUIslice Builder.
- Finally, the Wizard will confirm the settings, at which point you can click on Install
- The installation will start, and usually complete in a couple seconds.
Provided that the installation above was completed successfully, you can now launch the GUIslice Builder.
- In most cases, the GUIsliceBuilder will appear on the Start Menu under "GUIslice / GUIsliceBuilder"
- Alternately, you can double-click on the Builder from the Desktop if you enabled that during installation.
