HandBrake-docs/source/docs/en/1.10.0/developer/build-linux.markdown

2.9 KiB

Type, Title, Project, Project_URL, Project_Version, Language, Language_Code, Authors, Copyright, License, License_Abbr, License_URL
Type Title Project Project_URL Project_Version Language Language_Code Authors Copyright License License_Abbr License_URL
article Building HandBrake for Linux HandBrake https://handbrake.fr/ Latest English en
Bradley Sepos <bradley@bradleysepos.com> (BradleyS)
2024 HandBrake Team Creative Commons Attribution-ShareAlike 4.0 International CC BY-SA 4.0 https://handbrake.fr/docs/license.html

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

List available tags in the HandBrake 1.10.x release series, and check out the most recent.

git tag --list | grep ^1\.10\.
git checkout refs/tags/$(git tag -l | grep -E '^1\.10\.[0-9]+$' | tail -n 1)

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