This is an update release of WPILib for the 2025 season. This release adds the 2025 field images and AprilTags and has a small number of other quality of life improvements and fixes. This upgrade is recommended for all teams.
Upgrading from earlier 2025 releases is easy: simply download and run the new installer and it will update your current installation. If you already have the 2025 WPILib vscode installed, it will detect it and you can simply click "next" for that installation step. After installation, vscode will prompt you when opening your robot project whether you want to upgrade it to this version. Note that using the installer is required to get the new version of desktop tools such as Shuffleboard. This release is compatible with the kickoff release of the RoboRIO image, so there is no need to upgrade the RIO image if you have already done so for 2025.
The documentation for WPILib is located at https://docs.wpilib.org/ (if you have trouble accessing this location, https://frcdocs.wpi.edu/en/stable/ is an alternate location with the same content).
If you're new to FRC, start with Getting Started.
System Requirements: WPILib requires 64-bit Windows 10 or 11 (Arm and 32-bit are not supported), Ubuntu 22.04 or 24.04, or macOS 13.3 or higher. C++ teams should note that the latest version of Visual Studio 2022 is required for desktop builds. Mac users will need to have the Xcode Command Line Tools installed before running the installer. This can be done by running xcode-select --install in the Terminal.
If you're returning from a previous season, check out what's new for 2025. You will need a new RoboRIO image for 2025; this is available via the FRC 2025 Game Tools. Follow the WPILib installation guide to install WPILib.
If you're starting from a 2024 robot project, you will need to import your project to create a 2025 project. The import process is important, as it will make a few automated corrections for some breaking changes that happened in 2025. It is also necessary to import vendor libraries again, since last year’s vendor libraries must be updated to be compatible with this year’s projects.
A complete list of known issues with this release can be found here.
WPILib is developed by a small team of volunteers and the FIRST community.
Downloads
- Windows (2.4 GB)
- Mac (Arm) (2.2 GB)
- Mac (Intel) (2.3 GB)
- Linux (x64) (2.8 GB)
- Linux (arm64) (2.4 GB)
What's Changed since 2025.1.1
WPILib
- Update field and AprilTags by @Kevin-OConnor in #7634
- [glass] Make Field2D field picker show JSONs first by @sciencewhiz in #7643
- [glass] Fix Field2D custom image padding to maintain aspect ratio by @rmheuer in #7648
- [epilogue] Don't add a measure's symbol to its name when logged by Epilogue by @oh-yes-0-fps in #7652
- [cscore] Use kernel frame time in Linux USB Camera by @mcm001 in #7609
- [wpimath] Make Rotation2d member initialization order match declaration order by @calcmogul in #7632
- [wpimath] Implement Translation3d.RotateAround by @HarryXChen3 in #7661
- [commands] Add a warning to
schedulejavadocs by @spacey-sooty in #7073
WPIcal
- Add JSON Combiner by @ElliotScher in #7640
RobotBuilder
- Add Koors40 Motor Controller support by @sciencewhiz in wpilibsuite/RobotBuilder#638
GradleRIO
- Disable SmartDashboard and wpical on Linux arm64 by @PeterJohnson in wpilibsuite/GradleRIO#772
- Add missing whitespace in InvalidImageException by @mcm001 in wpilibsuite/GradleRIO#773
Elastic
- Elastic updated to 2025.0.2: https://github.com/Gold872/elastic-dashboard/releases/tag/v2025.0.2
AdvantageScope
- AdvantageScope updated to 4.1.1: https://github.com/Mechanical-Advantage/AdvantageScope/releases/tag/v4.1.1
Installer
- Select tarballs for VSCode on Linux ARM by @auscompgeek in wpilibsuite/WPILibInstaller-Avalonia#508
- Change AdvantageScope wmclass by @spacey-sooty in wpilibsuite/WPILibInstaller-Avalonia#512
Full Changelog: v2025.1.1...v2025.2.1
MD5 Hashes
4d9992358cfa5fcf1290040f9858aa12 Linux/WPILib_Linux-2025.2.1.tar.gz
087198535a6661b883a7627345c441ed LinuxArm64/WPILib_LinuxArm64-2025.2.1.tar.gz
05e977b48854a2ececa4aae54849bdae Win64/WPILib_Windows-2025.2.1.iso
d2f4df9d919270dc513b2c2edbd2eb93 macOS/WPILib_macOS-Intel-2025.2.1.dmg
16c9cd92081e83579e387fa948afb871 macOSArm/WPILib_macOS-Arm64-2025.2.1.dmg
SHA256 Hashes
03db633b9c93b62aa8fa35f4389fb11b58fc1ccf57e26c44d688c93f722efbb9 Linux/WPILib_Linux-2025.2.1.tar.gz
4d56286dee44edfa84fe590865edc62ca57030e4fa694364654f23b79a7caa84 LinuxArm64/WPILib_LinuxArm64-2025.2.1.tar.gz
e08be319cadbcdec9fdd2a7f369931b8b1590bd76b67d4dde563e57deeb39493 Win64/WPILib_Windows-2025.2.1.iso
4422028e4ef59ea2ced3c07215731befb4603c8f76b128fbca1ac5aadbdd7f63 macOS/WPILib_macOS-Intel-2025.2.1.dmg
96e20e47e66a1c432a121893524a026d9f575ea673554bf16343710a080e2a52 macOSArm/WPILib_macOS-Arm64-2025.2.1.dmg