https://github.com/gyroflow/gyroflow-frei0r
Gyroflow frei0r plugin
https://github.com/gyroflow/gyroflow-frei0r
Last synced: 10 days ago
JSON representation
Gyroflow frei0r plugin
- Host: GitHub
- URL: https://github.com/gyroflow/gyroflow-frei0r
- Owner: gyroflow
- License: apache-2.0
- Created: 2023-10-23T22:53:42.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-10-24T00:35:10.000Z (over 1 year ago)
- Last Synced: 2025-04-30T20:01:59.989Z (about 2 months ago)
- Language: Rust
- Size: 88.9 KB
- Stars: 3
- Watchers: 4
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
Awesome Lists containing this project
README
# Gyroflow frei0r plugin
* Works with project files exported from [Gyroflow](http://gyroflow.xyz/)
* Allows you to apply the stabilization right in your frei0r-capable video editor
Some applications using frei0r, in which you can use this plugin:
- [MLT](https://www.mltframework.org/)
- [LiquidSoap](https://www.liquidsoap.info/)
- [Kdenlive](https://www.kdenlive.org/)
- [Shotcut](https://www.shotcut.org/)
- [FFMpeg](https://ffmpeg.org)
- [PureData](https://puredata.info/)
- [Open Movie Editor](http://www.openmovieeditor.org/)
- [Gephex](https://gephex.org/)
- [LiVES](http://lives.sf.net)
- [FreeJ](https://freej.dyne.org)
- [VeeJay](http://veejayhq.net)
- [Flowblade](https://jliljebl.github.io/flowblade/)
# Downloads
## https://github.com/gyroflow/gyroflow-frei0r/releases
# Installation
### Kdenlive:
1. Copy the plugin binary to `kdenlive/lib/frei0r-1/`
2. Copy [`frei0r_gyroflow.xml`](https://raw.githubusercontent.com/gyroflow/gyroflow-frei0r/main/frei0r_gyroflow.xml) to `kdenlive/bin/data/kdenlive/effects/`
# Usage
### FFmpeg:
1. Create a folder somewhere, copy the plugin binary to it, and set environment variable `FREI0R_PATH` to that dir. For example on Windows: `set FREI0R_PATH=C:\effects\`
2. Run ffmpeg: `ffmpeg -i input_video.mp4 -vf "frei0r=gyroflow:C_DRIVE_SEP_projects_DIR_SEP_my_project.gyroflow|0.5|n|0.001" result.mp4`
3. Parameters are: `project_file_path|smoothness|stabilization_overview|timestamp_scale`.
4. Because ffmpeg can't accept `:` or `/` in parameters, plugin will replace `_DRIVE_SEP_` with `:\` and `_DIR_SEP_` with `/`, so you can use parameter: `E_DRIVE_SEP_some_folder_DIR_SEP_my_project.gyroflow` for `E:\some_folder\my_project.gyroflow`
# Building from source
1. Get latest stable Rust language from: https://rustup.rs/
2. Clone the repo: `git clone https://github.com/gyroflow/gyroflow-frei0r.git`
3. Build the binary: `cargo build --release`
4. Resulting file will be in `target/release/` directory
#### License
Licensed under either of Apache License, Version 2.0 or MIT license at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in this crate by you, as defined in the Apache-2.0 license, shall
be dual licensed as above, without any additional terms or conditions.