Downloading and installing HandBrake For Linux

HandBrake for Linux

HandBrake is available for Linux at the HandBrake website. Download Handbrake 1.5.1

Installing on Linux

Installing HandBrake on Linux

If you have installed a HandBrake package from your distribution or another third-party package repository, please remove it before proceeding. See the section, Warning about broken third-party builds on Where to get HandBrake for more information.

Flathub Flatpak

The most convenient way to install HandBrake and manage updates is to install the release we publish to Flathub. Please see Flathub’s Quick Setup page for instructions to enable Flatpak and Flathub on your Linux distribution.

Once Flathub is enabled on your system, you may install HandBrake directly from Flathub, from the Gnome Software GUI (‘gnome-software), or from the command line.

Installing from Flathub and Gnome Software is fairly self-explanatory. To install from the command line for system-wide use:

flatpak install fr.handbrake.ghb

During installation, it will ask for your password (assuming you have sudo privilege). Once installed, HandBrake will be available to all users of the system.

To install without sudo privileges:

flatpak --user install fr.handbrake.ghb

Once installed, HandBrake will only be available to the user that installed it.

Flatpak Bundles

Alternatively, you may manually download, verify, and install Flatpak bundles of HandBrake for Linux which are available on the HandBrake for Linux download page, the HandBrakeCLI download page or the development snapshot builds page[^nightly-builds].

Install your distribution’s flatpak package before running the following commands.

Install the latest HandBrake GUI release (after downloading and verifying)

flatpak --user install HandBrake-1.4.2-x86_64.flatpak

Install the latest HandBrake CLI release (after downloading and verifying)

flatpak --user install HandBrakeCLI-1.4.2-x86_64.flatpak

Install the nightly build (for example, filename changes nightly)

Download the latest snapshot from the [development snapshot builds](https://github.com/HandBrake/HandBrake-snapshots)[^nightly-builds]
flatpak --user install fr.handbrake.ghb-20210720182537-a01549c9c-master-x86_64.flatpak

Launching HandBrake

You may launch HandBrake by quickly clicking twice (double-clicking) on the cocktail & pineapple icon. Depending on your system settings, a single click may suffice.

icon-1.1.0 icon-click-1.1.0

Launching HandBrake Flatpak from the command line

To launch the HandBrake GUI from the command line

flatpak run fr.handbrake.ghb

The HandBrake GUI Flatpak package also includes the CLI which may be run with

flatpak run --command=HandBrakeCLI fr.handbrake.ghb

Additional HandBrakeCLI options go at the end of the above command line.

If you installed the stand-alone HandBrakeCLI Flatpak package, it can be run with

flatpak run fr.handbrake.HandBrakeCLI

The developers of Flatpak have also provided some useful helper scripts that get installed whenever a Flatpak package is installed. Unfortunately, the PATH environment usually does not include the location these are installed to.

If you wish to use these helper scripts, update your PATH (usually performed in a shell initialization file such as ~/.bash_profile)

export PATH=$PATH:$HOME/.local/share/flatpak/exports/bin:/var/lib/flatpak/exports/bin

Once your PATH includes these directories, the GUI may be run with

fr.handbrake.ghb

And the CLI may be run with

fr.handbrake.HandBrakeCLI

Next steps

Continue to check for updates.

  1. Nightly builds are based on HandBrake’s latest development code, including new and experimental features that may be unstable or significantly different from the latest release version. Although everyone is welcome to try them, nightly builds are best suited for experienced users and developers.↩
  2. HandBrake is not associated with any third-party checksum utilities. Only use software from vendors you trust.↩
  3. HandBrake is not associated with any third-party checksum utilities. Only use software from vendors you trust.↩
This article is part of the HandBrake Documentation and was written by Bradley Sepos (BradleyS) and Scott (s55). Join us on GitHub to contribute your thoughts and ideas, and to suggest any corrections.