Downloading and installing HandBrake

HandBrake is available for Linux, Mac, and Windows, at the HandBrake website.

This is the only official download source for HandBrake. For more information, see Where to get HandBrake.

Downloading

Most modern computers can run HandBrake. To be sure your system meets the minimum requirements, see System requirements in the technical documentation.

To download HandBrake to your computer, click the download button on the HandBrake website’s Home page. You can also choose a version for a specific operating system from the Downloads page.

Experienced users may wish to try HandBrake’s development snapshot builds1 that are available via GitHub.

Verifying your download

Checksums

The HandBrake Team publishes checksums for all downloads on handbrake.fr and the Checksums article on GitHub. You may use the provided checksums to verify the integrity of the files you download.

When installing on Linux from Flathub, download integrity is verified automatically. Similarly, the integrity of source code managed using git is verified automatically.

To verify an official source distribution tarball or Flatpak bundle, consult your Linux distribution’s documentation for instructions on how to verify checksums.

On Mac, launch Terminal from your Applications > Utilities folder and use the shasum command. For example, if you downloaded HandBrake to your Downloads folder:

shasum -a 256 ~/Downloads/HandBrake-*.dmg

Alternatively, the free third-party app Hashsum available on the Mac App Store provides a convenient graphical interface for computing file checksums2.

On Windows, launch a Command Prompt Window and use the certutil command. For example, if you downloaded HandBrake to your Downloads folder:

cd Downloads
certUtil -hashfile <filename> SHA256

Alternatively, free third-party apps 7-Zip Compute Hash, ExactFile, and MultiHasher for Windows provide convenient graphical interfaces for computing file checksums3.

If the checksums for the file you downloaded do not match the ones published by the HandBrake Team, you should delete the file and try your download again.

OpenPGP

The HandBrake Team also publishes OpenPGP signatures for all downloads on GitHub. More information is available on the OpenPGP article on GitHub.

Installing on Linux

If you have installed a HandBrake package from your distribution or other 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 are fairly self explanatory. To install from the command line for system wide use:

flatpak install fr.handbrake.ghb

During install 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 download page, the HandBrakeCLI download page or development snapshot builds page[^nightly-builds].

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

Install the latest HandBrake GUI release (after download and verify)

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

Install the latest HandBrake CLI release (after download and verify)

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

Install the nightly build (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

Installing on Mac

Once you’ve downloaded HandBrake for Mac, open the disk image in your Downloads folder. Your web browser (e.g. Safari, Firefox, or Chrome) may do this for you automatically. Then drag the HandBrake application to your Applications folder.

Opening HandBrake disk image
Open the HandBrake disk image you downloaded. Your web browser may do this automatically.
Installing HandBrake on Mac
Drag HandBrake to your Applications folder to install it on your Mac.

HandBrake is now installed. You may eject the disk image and move it to the Trash.

Installing on Windows

Once you’ve downloaded the HandBrake installer, simply double click to run it.

If HandBrake is already installed on your computer, the installer will offer to remove the previous version before installing the current version. Select OK to proceed and review HandBrake’s license terms.

HandBrake Windows installer: removing previous versions
The HandBrake installer will offer to remove previous versions before installing the current version.
HandBrake Windows installer
HandBrake’s Windows installer.

Next, the installer will ask you where you wish to install HandBrake. Unless you have a specific reason to change this, select Install to continue. Once the installation is complete, you may select Finish to exit the installer.

HandBrake for Windows installation progress
The installer will report its progress.
HandBrake for Windows installation complete
HandBrake is now installed.

You will find shortcuts for launching HandBrake placed on both the Windows Desktop and Start Menu.

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.

HandBrake iconDouble-clicking HandBrake icon

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 Checking 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 than 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.