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

68 lines
2.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
Type: article
Title: Building HandBrake for Linux
Project: HandBrake
Project_URL: https://handbrake.fr/
Project_Version: Latest
Language: English
Language_Code: en
Authors: [ Bradley Sepos <bradley@bradleysepos.com> (BradleyS) ]
Copyright: 2023 HandBrake Team
License: Creative Commons Attribution-ShareAlike 4.0 International
License_Abbr: CC BY-SA 4.0
License_URL: 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](../get-handbrake/where-to-get-handbrake.html) for more information.
## Installing dependencies
Dependency installation instructions are available for the following distributions.
- [Alpine](install-dependencies-alpine.html)
- [Arch](install-dependencies-arch.html)
- [Clear](install-dependencies-clear.html)
- [Debian](install-dependencies-debian.html)
- [Enterprise Linux](install-dependencies-el.html)
- [Fedora](install-dependencies-fedora.html)
- [Gentoo](install-dependencies-gentoo.html)
- [Mageia](install-dependencies-mageia.html)
- [OpenSUSE](install-dependencies-opensuse.html)
- [Solus](install-dependencies-solus.html)
- [Ubuntu](install-dependencies-ubuntu.html)
- [Void](install-dependencies-void.html)
HandBrakes optional experimental support for Intel Quick Sync Video on Linux requires installing the Intel Media SDK and its dependencies. See the [Intel Media SDK Releases](https://github.com/Intel-Media-SDK/MediaSDK/releases) page and [Intel Media SDK Build Instructions](https://github.com/Intel-Media-SDK/MediaSDK#how-to-build).
## Building HandBrake
Clone the HandBrake repository.
git clone https://github.com/HandBrake/HandBrake.git && cd HandBrake
List available tags in the HandBrake 1.8.x release series, and check out the most recent.
git tag --list | grep ^1\.8\.
git checkout refs/tags/$(git tag -l | grep -E '^1\.8\.[0-9]+$' | tail -n 1)
Build HandBrake. To enable experimental support for Intel Quick Sync Video, append `--enable-qsv`. To build the command line interface only, disable the graphical interface by appending `--disable-gtk`.
./configure --launch-jobs=$(nproc) --launch
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