gyroflow / gyroflow-plugins

Gyroflow OpenFX, Adobe and frei0r plugins
GNU General Public License v3.0
25 stars 1 forks source link

Gyroflow logo Gyroflow logo

Video stabilization using gyroscope data

HomepageDownloadDocumentationDiscordReport bugRequest feature

Downloads Contributors Issues License

Gyroflow plugin for video editors

Gyroflow plugin for a video editor allows you to stabilize the video directly inside the video editor, where you work with the original video file, instead of rendering a stabilized video in the app and then importing it to the video editor.

If your camera has official lens profiles and accurate gyro timing (GoPro 8+, Sony, Insta360, DJI), then you should be able to just apply the plugin to your clip. In the Adobe and Final Cut Pro plugin, it should load the gyro data automatically. In Resolve, you should click "Load for current file" or use the "Browse" button to select your video file or the .gyroflow project file.

Since Gyroflow supports a lot of different cameras and gyro sources, it's practically impossible to recreate all tools it offers (for example synchronization with optical flow) inside the plugin user interface.

If your camera requires synchronization (RED, RunCam, Hawkeye, phone apps, blackbox, etc.), the workflow starts inside the main Gyroflow application, where you load your video, lens profile, gyro data, you do all synchronization and parameters, but instead of rendering - you export a project file which includes all your parameters and gyro data. This can be easily done by using the CTRL+S shortcut, or using Export -> Export project file (including gyro data) in the application.

This exported project file is then loaded inside the Gyroflow plugin in the video editor and the plugin will process your pixels directly inside your editor according to the gyro data and all your parameters, but without any transcoding, recompression or additional processing.

This is especially important when working with RAW files (like BRAW or R3D), where you retain all your RAW controls like ISO, White Balance etc.


This repository contains the source code of Gyroflow video editor plugins. This includes OpenFX, Adobe and frei0r.
Final Cut Pro plugin is hosted in an external repository.

Supported applications:

Applications Plugin type Download Nightly
OpenFX Download Windows
macOS
Linux
Adobe Download Windows
macOS
FxPlug4 Download ---
frei0r Download Windows
macOS
Linux

Installation and usage

Gyroflow app includes a tool to install the plugins. Since version v1.6.0 it has a dedicated "Video editor plugins" panel, which should show up (on bottom right) when Gyroflow detects you have Adobe or DaVinci Resolve installed. Using this panel is the easiest way to install and update the plugins.

The Final Cut Pro plugin, called Gyroflow Toolbox is available on the Mac App Store as paid product (to cover support costs), however you can also build it from source here.

For manual installation steps and more details, refer to the documentation


License

Distributed under the GPLv3 License with App Store Exception. See LICENSE for more information.