๐DaVinci Resolve (OpenFX)
Gyroflow engine is also available as an OpenFX plugin to allow you to stabilise videos inside a video editor like DaVinci Resolve.
Installation
The Gyroflow OpenFX Plugin works on Mac, Windows and Linux:
Installing the OpenFX plugin
Download the latest version from https://gyroflow.xyz/download#plugins
Create the OFX folder:
/Library/OFX/Plugins
. You can do that in Finder or in the Terminal:sudo mkdir -p /Library/OFX/Plugins ; open /Library/OFX/Plugins
.Run
Gyroflow-ofx-macosx.dmg
Copy
Gyroflow.ofx.bundle
folder to/Library/OFX/Plugins/
IMPORTANT: Make sure the OFX folder is in the root /Library
folder, not your user /Users/YOUR-USER-NAME/Library
folder.
Hardware Acceleration
Gyroflow OFX plugin supports Metal acceleration on Mac.
Source Code
You can find the source code for this OpenFX plugin on GitHub here.
Nightly Builds
Development moves fast and there are new features added very often, check them out by downloading the nightly build:
The list of all nightly builds is available on GitHub actions.
Supported Hosts
This OpenFX plugin has been primarily built for Blackmagic's DaVinci Resolve, however it has also been tested in MAGIX Vegas and ASSIMILATE Scratch.
It may also work in other OpenFX-compatible hosts, such as Baselight, DVS Clipster, Nuke & Flame, however it's currently untested.
If you would like to use this OpenFX Plugin in another application, and it's not working correctly, please post a GitHub issue.
Interface
This section explains the various sections of the OpenFX Plugin Interface.
Gyroflow Project
Load for current file
This feature relies on external scripting and is only available in paid DaVinci Resolve Studio.
To use this feature, you also have to allow executing external scripts.
You can do this by going to Preferences...
Then within the General section, make sure External scripting using is set to Local.
For this feature to work, you must have the clip you want to apply Gyroflow to selected in the Edit page or in the Color page.
It is also impossible to query file path on a Compound Clip. In any case, you can just select the video or project file using the Browse button, as explained next...
Browse
If you're not able to use the Load for current file feature, you can manually Browse for a Gyroflow Project. Just click the Browse button and navigate to wherever your Gyroflow Project is saved.
The OpenFX Plugin will remember the last opened folder.
Load preset/lens profile
Clicking the Load preset/lens profile button allows you to select a Preset or Lens Profile.
Lens calibration is a very important piece of the stabilization algorithm and it's very important to use accurate lens profile when stabilizing a video in Gyroflow. You can learn more here.
On macOS, the built-in Lens Profiles are located at:
/Applications/Gyroflow.app/Contents/Resources/camera_presets
Open in Gyroflow
If you already have a Gyroflow Project loaded, pressing Open in Gyroflow will open this project in Gyroflow. If you don't already have a Gyroflow Project loaded, this will just open Gyroflow in it's default state.
Reload Project
If you already have a Gyroflow Project loaded, pressing the Reload Project button will reload the project from the filesystem. This is useful if you've made changes in the main Gyroflow application, but now want to update the OpenFX Plugin.
Last saved project
This is a convenince function that allows you to load the last saved project in the main Gyroflow application to the OpenFX plugin. This is useful if you're working on the free version of DaVinci Resolve, and you don't have access to the Load for current file feature.
Status Message
Underneath the Last save project button is a checkbox that displays a status message. This is useful to determine if everything is working correctly, or if there's any issues or problems - for example, a frames per second mismatch:
If everything is correct and working, you'll see this:
Adjust Parameters
This section allows you to manually adjust several Gyroflow parameters directly within the OpenFX plugin. You can also apply keyframes.
Input & Video Rotation
Input Rotation is when the Host (i.e. DaVinci Resolve) rotates the input pixels before feeding to the OpenFX Plugin. For example, if an .mp4
contains rotation in the metadata, the Host will automatically rotate it. Gyroflow expects raw pixels directly from the source file, so if the Host has already rotated them, it won't match. Given this, the Input rotation is the rotation done by the host BEFORE feeding to the OpenFX plugin, whereas Video rotation is a rotation by the Gyroflow engine AFTER stabilisation.
Video Speed
Use this slider to change video speed or keyframe it, instead of built-in speed changes in the editor.
Disable Gyroflow's stretch
If you used Input stretch in the lens profile in Gyroflow, and you de-stretched the video separately in Resolve, check this to disable Gyroflow's internal stretching.
Keyframes
This section allows you to control how the OpenFX handles keyframes.
Use Gyroflow's keyframes
Ticking this uses Gyroflow's internal keyframes, instead of the ones in your host application (i.e. DaVinci Resolve). This is enabled by default.
Recalculate keyframes
This button allows you to recalculate keyframes after adjusting the splines (in Fusion mode).
Additional Settings
This section covers the additional settings at the bottom of the OpenFX settings.
Stabilization overview
This allow you to zoom out the view to see the stabilization results. This is very useful to see if and how Gyroflow is working. You should disable this before rendering.
Don't draw outside source clip
When clip and timeline aspect ratio don't match, draw the final image inside the source clip, instead of drawing outside it.
Embed .gyroflow data in plugin
If you intend to share the host (i.e. DaVinci Resolve) project to someone else, the plugin can embed the Gyroflow project data including gyro data inside the host project. This way you don't have to share .gyroflow
project files. Enabling this option will make the project bigger. This option is off by default.
Workflow
Vertical Video or different aspect ratio
For vertical video, or if your timeline has different aspect ratio than your source video, you have two options:
The preferred option is to add the Gyroflow OpenFX plugin in a Fusion node, then set the target resolution in the Output size area in the plugin. Then go to plugin Settings and check Use plugin RoD for output size and then you can continue on the vertical timeline in the edit/color pages.
Alternatively, change your timeline scaling settings to Scale image to fit instead of Scale image with crop - this is easier method but if you have 16:9 video that you want to export as 9:16, it will negatively affect the quality.
Frame Rate Mismatch
If your timeline has different frame rate than the source file, you may experience broken stabilization. The plugin tries its best to adapt to the frame rate differences, but sometimes it's not possible and in that case, you have to add the plugin as a Fusion node instead.
Last updated