The fpv.wtf root hack on DJI FPV Goggles / Air Unit / Vista allows you to install custom software on it to unlock new features. This is an open source project, not official, therefore do this at your own risk.
Everything can be done in a browser, no need to install anything, it’s easier than using DJI’s own software to be honest!
Table of Contents
Why Root DJI FPV System?
By rooting your DJI FPV Goggles and Air Unit (and Vista), it gives you killer features that in my opinion makes the DJI FPV system the best digital system on the market right now. For example, full Betaflight OSD support, Live Audio, 60Mbps bit rate (3rd party mod), auto DVR record and many more.
Once your goggles/VTX are rooted, it allows you to install WTFOS operating system and custom packages.
Currently you can root the following DJI FPV devices:
Root hack currently only supports firmware v01.00.0606 and V01.00.0608, you can find out which firmware you are on by connecting your device to the DJI FPV Assistant program.
Go to https://fpv.wtf/root
Connect your device to your computer via USB. Donate if you can, if not just click I already paid. Then hit Root Device, in the pop up window, select the COM port of your DJI device.
It will take a few minutes. Once you rooted your goggles, it should still work with Vista / Air Unit that has not been rooted just fine.
If you get an error, or it gets stuck at attempts, try the following (error: Could not connect to device, make sure that adb server is not running on your machine (adb kill-server) and that you are not connected in another tab/window.), it really helped me:
- Use Google Chrome
- Close all browsers, open only the fpv.wtf page
- Power on the Vista/Goggles, don’t plug in the USB cable until it shows green light or main screen on the goggles
WTFOS is the operating system, like Android on smartphones, other developers can build “apps” within WTFOS to add new features and functionality.
To install WTFOS, go to https://fpv.wtf/wtfos
Connect your device to computer via USB cable, and click “Connect to Device” and select the COM Port of your device. If nothing shows up, your device may have not been rooted properly, try root it again.
Click Install, it can take a few mins.
When it’s done, it will disconnect the device and reconnected again, with the “Connect to Device” button grey out. You can now move on to the next step.
The goggles menu remains the same, nothing has changed except you are getting the new/different features offered by the packages you install.
If for any reason you want to go back to your original DJI operating system (for example your goggles stop working properly or won’t boot up), just hold down the bind button while powering it up. When you power cycle the goggles it will go back to WTFOS. You can uninstall WTFOS if you want, instructions on Github Wiki.
If you want to update your goggles to a newer official DJI firmware, you have to uninstall WTFOS first.
Normally for DJI Goggles V2, you can just go to the FPV.WTF site, go to WTFOS and click uninstall. However for DJI Goggles V1, you have to enter these in the command line:
Packages are like applications, they add new features to the FPV system. Once WTFOS is installed, you can install packages here (need to connect device first):
The must have package right now is MSP OSD – full Betaflight OSD support, as well as 1200mW hack is pretty useful too (saves you the trouble from uploading a text file manually).
Repeat for Air Unit / Vista
Do the same for all the Air Unit and Vista you want to hack: Root, Install WTFOS and then packages. Make sure to use a fan while doing this to keep them cool!
How To Update DJI Firmware After Rooting
DJI Assistant program will not detect your DJI FPV Goggles and Vista after you have rooted them and installed WTFOS.
To update firmware on these devices, you first have to
- For DJI FPV Goggles V2, uninstall WTFOS by going to the FPV.WTF site, go to WTFOS (https://fpv.wtf/wtfos) and click Remove
- For DJI FPV Goggles V1 and Vista, you have to enter these in the command line (https://fpv.wtf/cli):
Now close the browser and reconnect your goggles, DJI assistant should now recognise it again and you can update firmware. You can install WTFOS again after this, once your goggles are rooted, they are rooted forever so don’t worry.
Rollback to older Firmware with Butter
If you are on a firmware that doesn’t allow you to root, or downgrade to older firmware, you can use a tool made by FPV.WTF called Butter to rollback or recover your device to the v01.00.0606. Butter is also useful for fixing “bricked” Vista and DJI goggles (say when you disconnected power during an update).
Butter only works in Windows and Linux (no MacOS). The procedure involves running a command line script, and the procedure is automated and easy to do. The supported devices are DJI FPV Air Unit, Air Unit Lite (Caddx Vista and Runcam Link), DJI FPV Googles V1 and V2.
Warning: this will reset the Goggles, and you will lose all your binds.
How to use Butter?
- Windows users: Install the necessary drivers using driver_installer.exe if you haven’t already done so, download here: https://github.com/fpv-wtf/butter#advanced-usage
- Linux users: Install fastboot with eg. ‘sudo apt install fastboot’
Download the package needed for your particular device: https://github.com/fpv-wtf/butter#usage
Read the “Readme.txt” for instructions, to sum it up here:
- Have your device powered off
- Launch windows-runme.bat or linux-runme.sh according to your OS
- Power on your device
- Wait for flashing to finish
The script will overwrite the firmware back to V01.00.0606, which is a version that allows you to root it. DJI Assistant will tell you that you are still on the firmware version before you ran Butter, don’t worry, it’s just the version number in the goggles that didn’t get updated, but in fact the firmware has been rolled back and you can carry on and root it. Once it’s rooted, it’s permanent whatever you do and you won’t need to do it again, feel free to upgrade the firmware to any version as you like. But if you want to use WTFOS you have to stay on 0606 or 0608 for now to avoid issues.
If you are stuck at “Waiting for DJI Recovery device to enumerate..” when flashing, try this:
– Make sure you’ve installed the proper drivers using driver_installer.exe
– Try another USB cable
– Try another USB port (2.0 if you have one)
– Try restarting your PC
– Try another PC