> For the complete documentation index, see [llms.txt](https://docs.gyroflow.xyz/app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gyroflow.xyz/app/getting-started/installation.md).

# Installation

Gyroflow is officially available in Microsoft Store, Apple Store and Google Play store. Downloadable binaries are available as well.

{% tabs %}
{% tab title="Windows" %}

## Install from the Microsoft Store:

[![](https://957905993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgogMettXiFqbEAwJmvy8%2Fuploads%2FceDhtNVg4tP0nWnVTe9U%2Fbadge_microsoft_store.png?alt=media\&token=95557b6f-516f-422b-8261-ff5a50decee0)](https://apps.microsoft.com/store/detail/gyroflow/9NZG7T0JCG9H)

## Manual install:

1. Download the latest version from <https://gyroflow.xyz/download>
2. Extract `Gyroflow-windows64.zip` (or `Gyroflow-windows-arm64.zip` on Windows on ARM) somewhere
3. Open the extracted folder and run `Gyroflow.exe`
4. If it shows an error about `VCRUNTIME140.dll`, [install VC redist](https://aka.ms/vs/17/release/vc_redist.x64.exe)

## Minimum system requirements

Windows 10 64-bit (1809 or later)

* If you have Windows "N" install, go to `Settings` -> `Apps` -> `Optional features` -> `Add a feature` -> enable `Media Feature Pack`

{% hint style="info" %}
Windows 7 is not supported, because of Qt 6 requirements
{% endhint %}
{% endtab %}

{% tab title="macOS" %}

## Install from the App Store:

[![](https://957905993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgogMettXiFqbEAwJmvy8%2Fuploads%2FMNVnVzjJCqtuZYWs2Awv%2Fbadge_apple_store.png?alt=media\&token=a9160486-ea9a-4564-88d3-313dabef3f17)](https://apps.apple.com/us/app/gyroflow/id6447994244)

## Beta channel:

Updates are pushed more often to TestFlight. Use this link to join as tester and get most recent updates first: <https://testflight.apple.com/join/e0RI1n5i>

## Manual install:

1. Download the latest version from <https://gyroflow.xyz/download>
2. Run`Gyroflow-mac-universal.dmg`
3. Drag & drop `Gyroflow` app to the Applications folder (or anywhere you want, like on Desktop)

{% hint style="info" %}
You can also install using brew: **`brew install gyroflow`**.

To upgrade Gyroflow, run **`brew update`** then **`brew upgrade gyroflow`**
{% endhint %}

## Minimum system requirements

* macOS 10.15 or later

{% hint style="info" %}
Both Intel and Apple Silicon are supported natively.
{% endhint %}

### Hardware acceleration support:

<table><thead><tr><th width="287">Processor</th><th width="85">H.264</th><th width="91">H.265</th><th>ProRes</th></tr></thead><tbody><tr><td>Intel</td><td>✅</td><td>✅</td><td>❌</td></tr><tr><td>M1</td><td>✅</td><td>✅</td><td>❌</td></tr><tr><td>M1 Pro/Max/Ultra</td><td>✅</td><td>✅</td><td>✅</td></tr><tr><td>M2 and newer</td><td>✅</td><td>✅</td><td>✅</td></tr></tbody></table>
{% endtab %}

{% tab title="Linux" %}

## Installing Gyroflow

1. Make sure you have latest GPU drivers installed
2. Download `Gyroflow-linux64.tar.gz` from <https://gyroflow.xyz/download>
3. Extract the files somewhere and run `./Gyroflow` in the terminal.
4. If it doesn't work, you probably need to install additional dependencies:

`sudo apt install libc++-dev libva2 libvdpau1 libasound2 libxkbcommon0 libpulse0 libvulkan1`

GPU specific packages:

* NVIDIA: `nvidia-opencl-icd nvidia-vaapi-driver nvidia-vdpau-driver nvidia-egl-icd nvidia-vulkan-icd libnvcuvid1 libnvidia-encode1`
* Intel: `intel-media-va-driver i965-va-driver beignet-opencl-icd intel-opencl-icd`
* AMD: `mesa-vdpau-drivers mesa-va-drivers mesa-opencl-icd libegl-mesa0 mesa-vulkan-drivers`

{% hint style="info" %}
`.AppImage`is also available, but it's recommended to run the `.tar.gz` package
{% endhint %}

## Install with Flatpak

Gyroflow is also available as a Flatpak from [FlatPark](https://flatpark.org/apps/xyz.gyroflow.Gyroflow). It installs the official `Gyroflow-linux64.tar.gz` unmodified, and FlatPark updates it for each new Gyroflow release, so `flatpak update` keeps it up to date. It runs on any distro with Flatpak, and you don't need to install the packages listed above.

```
flatpak remote-add --if-not-exists flatpark https://dl.flatpark.org/flatpark.flatpakrepo
flatpak install flatpark xyz.gyroflow.Gyroflow
```

* The Flatpak has access to your `Videos` folder and to removable drives (`/run/media` and `/media`). Gyroflow saves the render next to the source clip by default, so if your footage is stored anywhere else, give it access to your home folder with `flatpak override --user --filesystem=home xyz.gyroflow.Gyroflow`
* Settings and your own lens profiles are stored in `~/.var/app/xyz.gyroflow.Gyroflow`
* OpenCL isn't available inside the Flatpak, so GPU processing uses Vulkan
* Video editor plugins aren't part of the Flatpak. Install them as described in [Video editor plugins](https://docs.gyroflow.xyz/app/video-editor-plugins/general-plugin-workflow.md)

{% hint style="info" %}
The Flatpak package is maintained by FlatPark, not by the Gyroflow team. Report problems with the package itself at [github.com/flatpark/flatpark](https://github.com/flatpark/flatpark/issues).
{% endhint %}

## Minimum system requirements

* Debian 10+
* Ubuntu 18.10+
* CentOS 8.2+
* openSUSE 15.3+

{% hint style="info" %}
Other distros require glibc 2.28+ (**`ldd --version`** to check)
{% endhint %}
{% endtab %}

{% tab title="Android" %}

## Install from the Google Play Store:

[<img src="https://957905993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgogMettXiFqbEAwJmvy8%2Fuploads%2FDelQCteFrnjbCjjpovP8%2Fbadge_google_play.png?alt=media&amp;token=4e31665e-efdd-4d08-82d9-baf80d890389" alt="" data-size="original">](https://play.google.com/store/apps/details?id=xyz.gyroflow)

## Manual install:

Nightly .apk can be downloaded from <https://nightly.link/gyroflow/gyroflow/workflows/release/master/Gyroflow-android.zip>

## Minimum system requirements

* Android 8
  {% endtab %}

{% tab title="iOS" %}

## Install from the App Store:

[![](https://957905993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgogMettXiFqbEAwJmvy8%2Fuploads%2FMNVnVzjJCqtuZYWs2Awv%2Fbadge_apple_store.png?alt=media\&token=a9160486-ea9a-4564-88d3-313dabef3f17)](https://apps.apple.com/us/app/gyroflow/id6447994244)

## Beta channel:

Updates are pushed more often to TestFlight. Use this link to join as tester and get most recent updates first: <https://testflight.apple.com/join/e0RI1n5i>

## Manual install:

Installing from outside of Apple Store is possible only on jailbroken devices or if you have a developer account and know how to re-sign an .ipa. Nightly .ipa can be downloaded from <https://nightly.link/gyroflow/gyroflow/workflows/release/master/Gyroflow-ios.zip>

## Minimum system requirements

* iOS 14
  {% endtab %}
  {% endtabs %}

## Latest development build

Development moves fast and there are new features added very often, check them out by downloading the nightly build

You can always download the latest build from <https://gyroflow.xyz/devbuild/>

The list of all nightly builds is available on [GitHub actions](https://github.com/gyroflow/gyroflow/actions)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.gyroflow.xyz/app/getting-started/installation.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
