Building HandBrake for 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.
Installing dependencies
Dependency installation instructions are available for the following distributions.
Building HandBrake
Clone the HandBrake repository.
git clone https://github.com/HandBrake/HandBrake.git && cd HandBrake
Build HandBrake.
./configure --launch-jobs=$(nproc) --launch
The following optional parameters are commonly used:
| Parameter | Description |
|---|---|
| –enable-qsv | Enable support for the Intel QuickSync Video Decoder and Encoder |
| –enable-nvdec | Enable support for the Nvidia NVDec Decoder |
| –enable-vce | Enable support for the AMD VCN video encoder |
| –enable-libdovi | Enable support for Dolby Vision |
| –disable-gtk | Build only HandBrakeCLI on Linux |
For a full listing of options, use the command:
./configure --help
When complete, you will find HandBrakeCLI in the build directory. If the graphical interface is enabled, you will also find ghb in the build/gtk/src directory.
Install HandBrake (optional). When installing the graphical interface, icon and desktop files for the Applications menu will be also installed.
sudo make --directory=build install
If you wish to then uninstall
sudo make --directory=build uninstall
To start over, simply remove the build directory.
rm -rf build