Gyroflow Toolbox

Screenshot 2023 01 02 at 12 13 13 PM

Gyroflow Toolbox allows you to import Gyroflow Projects into Apple’s Final Cut Pro. These are free & open source.

What is Gyroflow?

Screenshot 2023 01 02 at 12 12 15 PM

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.


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.

Screenshot 2023 01 02 at 12 06 13 PM

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.

Screenshot 2023 01 02 at 12 06 45 PM

You then need to click Grant Access:

Screenshot 2023 01 02 at 12 07 10 PM

Once done, you’ll be presented with a successful message:

Screenshot 2023 01 02 at 12 07 32 PM

The button will now be disabled, and will say Motion Template Installed. You can now close the Gyroflow Toolbox application.

Screenshot 2023 01 02 at 12 07 53 PM

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.

Screenshot 2023 01 02 at 12 08 49 PM

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.

Screenshot 2023 01 02 at 12 09 19 PM

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.

Screenshot 2023 01 02 at 12 10 33 PM

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.

Subscribe to our newsletter