WPILib Installation
The WPI Robotics Library (WPILib) is the standard software library provided for teams to write code for their FRC robots. You will spend most of the time working with it.
Installation
WPILib supports Windows, MacOS and Linux, but be aware that Windows 10 support might be ended in 2027 due to the release of new control system. You also want to make sure that you are using the correct version according to the control system we will use in 2027.
- Windows
- macOS
- Linux
Windows 10+ users can right click on the downloaded disk image and select Mount to open it. Then launch WPILibInstaller.exe.
Upon opening the installer, you’ll be presented with the below screen. Go ahead and press Start.
macOS users can double click on the downloaded dmg and then select WPILibInstaller to launch the application.
Linux users should extract the downloaded .tar.gz and then launch WPILibInstaller. Ubuntu treats executables in the file explorer as shared libraries, so double-clicking won’t run them. Run the following commands in a terminal instead with <version> replaced with the version you’re installing.
$ tar -xf WPILib_Linux-<version>.tar.gz
$ cd WPILib_Linux-<version>/
$ ./WPILibInstaller


If this is your first time using WPILib, Everything is recommended.
Choose Install for this User if you do not want your WPILib to be used by other users of this device. Otherwise, choose Install for all Users

If this is your first time using WPILib, Download for this computer only is recommended.

Wait for the Installation to complete.

After installation is complete, you will be presented with the finished screen. Click on Finish to quit the installer.
What is installed
-
Visual Studio Code - The supported IDE for 2019 and later robot code development. The offline installer sets up a separate copy of VS Code for WPILib development, even if you already have VS Code on your machine. This is done because some of the settings that make the WPILib setup work may break existing workflows if you use VS Code for other projects.
-
C++ Compiler - The toolchains for building C++ code for the roboRIO
-
Gradle - The specific version of Gradle used for building/deploying C++ or Java robot code
-
Java JDK/JRE - A specific version of the Java JDK/JRE that is used to build Java robot code and to run any of the Java based Tools (Dashboards, etc.). This exists side by side with any existing JDK installs and does not overwrite the JAVA_HOME variable
-
WPILib Tools - SmartDashboard, Shuffleboard, RobotBuilder, OutlineViewer, PathWeaver, Glass, SysId, Data Log Tool, roboRIO Team Number Setter, AdvantageScope, Elastic, WPIcal
-
WPILib Dependencies - OpenCV, etc.
-
VS Code Extensions - WPILib and Java/C++/Python extensions for robot code development in VS Code
-
Documentation - Offline copies of this frc-docs documentation and Java/C++/Python APIs
Uninstalling
- Windows
- macOS
- Linux
-
Delete the appropriate wpilib folder (
C:\Users\Public\wpilib\YYYYwhere YYYY is the year to uninstall) -
Delete the desktop icons at
C:\Users\Public\Public Desktop
Delete the appropriate wpilib folder (~/wpilib/YYYY where YYYY is the year to uninstall)
Delete the appropriate wpilib folder (~/wpilib/YYYY where YYYY is the year to uninstall). eg rm -rf ~/wpilib/YYYY
Congratulations! Now you have taken your first step into FRC programming.