Skip to content

Getting started

Installation

Install Frame on macOS, Windows, or Linux and keep it up to date.

Download the current release from Frame on GitHub. Choose the package for your operating system and processor. Release packages include the media tools they need; the Flatpak uses the Freedesktop runtime.

macOS

Use the Apple Silicon package for an M-series Mac, or the Intel package for an Intel Mac. Open the DMG and move Frame to Applications.

You can also install through the Frame Homebrew tap:

Terminal
brew tap 66HEX/frame
brew install --cask frame
brew tap 66HEX/frame
brew install --cask frame

The current macOS release is ad-hoc signed and is not notarized. If macOS blocks a copy downloaded from the official release page, the repository documents this command after installation:

Terminal
xattr -dr com.apple.quarantine /Applications/Frame.app
xattr -dr com.apple.quarantine /Applications/Frame.app

Only use it for the official Frame download you intended to install.

Windows

Download the Windows installer from the release page and run it. Frame is also available through WinGet:

Terminal
winget install --id 66HEX.Frame -e
winget install --id 66HEX.Frame -e

Current Windows builds are not certificate signed. SmartScreen may show a warning. For the official installer, select More info, then Run anyway.

Linux

Install from Flathub:

Terminal
flatpak install flathub io.github._66HEX.Frame
flatpak install flathub io.github._66HEX.Frame

AppImage downloads are also available on the GitHub release page. Choose x86_64 for a typical Intel or AMD computer, or aarch64 for an ARM64 computer, then allow the downloaded file to run as an executable in your file manager.

Nixpkgs

Frame is available as frame-media-converter in Nixpkgs, on the nixos-unstable branch, for x86_64 and aarch64 Linux. This package uses FFmpeg and FFprobe from Nixpkgs. Updates are managed through Nix.

With Nix installed and the nix-command and flakes features enabled, run Frame without adding it to your profile:

Terminal
nix run github:NixOS/nixpkgs/nixos-unstable#frame-media-converter
nix run github:NixOS/nixpkgs/nixos-unstable#frame-media-converter

To install it in your user profile:

Terminal
nix profile add github:NixOS/nixpkgs/nixos-unstable#frame-media-converter
nix profile add github:NixOS/nixpkgs/nixos-unstable#frame-media-converter

On older Nix versions, use nix profile install in place of nix profile add. After installation, launch Frame from your application menu or run frame in a terminal.

For a NixOS configuration that already uses nixos-unstable, add pkgs.frame-media-converter to your existing environment.systemPackages list:

Example
{ pkgs, ... }: {
  environment.systemPackages = [ pkgs.frame-media-converter ];
}
{ pkgs, ... }: {
  environment.systemPackages = [ pkgs.frame-media-converter ];
}

Then apply your configuration with sudo nixos-rebuild switch. The package must come from nixos-unstable; the commands above select that branch explicitly, even if your default Nixpkgs source uses a stable release. See the NixOS package management guide for declarative installation.

Updates

Native release builds include an updater. Frame verifies the release manifest signature and the downloaded package before installation. If you installed through a package manager, you can update through that same package manager:

Terminal
brew upgrade --cask frame
brew upgrade --cask frame
Terminal
winget upgrade --id 66HEX.Frame -e
winget upgrade --id 66HEX.Frame -e
Terminal
flatpak update io.github._66HEX.Frame
flatpak update io.github._66HEX.Frame

For an installation made with nix profile add:

Terminal
nix profile upgrade frame-media-converter
nix profile upgrade frame-media-converter

If you have more than one copy in your profile, use nix profile list to find the correct entry name. For declarative NixOS installations, update your nixos-unstable channel or flake input and rebuild the configuration.

After installation, continue with your first conversion.