Gyroflow Toolbox allows you to import Gyroflow Projects into Apple’s Final Cut Pro. These are free & open source.
What is Gyroflow?
Gyroflow is a free and open source application that can stabilize your video by using motion data from a gyroscope and optionally an accelerometer. Some modern cameras record that data internally (GoPro, Sony, Insta360, etc), and Gyroflow is able to then stabilize the captured footage. It can also use gyro data from an external source (eg. from Betaflight blackbox).
Gyroflow Toolbox allows you to take the stabilized data from Gyroflow and use it within Final Cut Pro as an effect. You will need to install the latest Gyroflow application, before using Gyroflow Toolbox.
Supported Cameras
Below you can see a list of supported cameras that can be used.
- GoPro (HERO 5 and later)
- Sony (a1, a7c, a7r IV, a7 IV, a7s III, a9 II, FX3, FX6, FX9, RX0 II, RX100 VII, ZV1, ZV-E10)
- Insta360 (OneR, OneRS, SMO 4k, Go, GO2, Caddx Peanut)
- DJI (Avata, O3 Air Unit)
- Blackmagic RAW (.braw) RED RAW (.r3d)
- Betaflight blackbox (*.bfl, *.bbl, .csv) ArduPilot logs (.bin, *.log)
- Gyroflow .gcsv log
- iOS apps: Sensor Logger, G-Field Recorder, Gyro, GyroCam
- Android apps: Sensor Logger, Sensor Record, OpenCamera Sensors, MotionCam Pro
- Runcam CSV (Runcam 5 Orange, iFlight GOCam GR, Runcam Thumb, Mobius Maxi 4K)
- Hawkeye Firefly X Lite CSV
- WitMotion (WT901SDCL binary and *.txt)
- Vuze (VuzeXR)
- KanDao (Obisidian Pro)
Things you need to be aware of
You can only apply the Gyroflow Toolbox effect to an entire clip. You cannot trim the clip. Due to limitations in Final Cut Pro’s FxPlug4 API the developers currently can’t determine the source start timecode of a clip. Because of this, the Gyroflow Toolbox effect should only be applied to a clip where the start of the clip hasn’t been trimmed in the timeline (i.e. the clip you have in the timeline should show the first frame of the source clip). If you need to trim the start of this clip, you can use the full clip within a Compound Clip, then trim the Compound Clip as required. The team behind Gyroflow Toolbox has been in contact with the Final Cut Pro team about this, and there’s currently no other better workaround or solution.
Download Test Footage
The Gyroflow team has kindly shared some test footage that contains gyro data on Google Drive.
Installation
Download the top ZIP file, then when you extract it, drag the Gyroflow Toolbox.app application to your Applications folder.
You should then run the application. If it’s the first time installing the software, or if there’s been an update, you’ll be prompted to Install Motion Template.
Once you click the button, you’ll be prompted to grant permission to your Movies folder. This is due to macOS’s sandboxing, and you’ll only need to do this once. Click OK.
You then need to click Grant Access:
Once done, you’ll be presented with a successful message:
The button will now be disabled, and will say Motion Template Installed. You can now close the Gyroflow Toolbox application.
How do you use it in FCP?
After you have installed Gyroflow and Gyroflow Toolbox, you’ll see a Gyroflow Toolbox Effect in the Effects Browser.
You can then apply this effect to any clips that are supported by Gyroflow.
From the Inspector you can then click Launch Gyroflow, to open the Gyroflow application.
You can learn more about Gyroflow here.
Once you have finished stabilizing in Gyroflow you should click the Export button arrow and then Export project file (including processed gyro data).
It’s important that you include the processed gyro data, otherwise, none of the stabilization will come across to Gyroflow Toolbox.
You can now press the Import Project button in the Final Cut Pro Inspector to import it.
The data from the Gyroflow Project gets saved within the Final Cut Pro library. If you want to reload it, you can either re-import, or if the file is in the same path, you can press Reload Project.
You can adjust and keyframe the FOV, Smoothness and Lens Correction within Final Cut Pro.
