Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions source/docs/en/latest/developer/build-windows.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ Begin by installing all dependencies specified in the guide [Installing dependen

*This section is for running HandBrake on ARM-based Windows machines only (not x64). You can find the type of machine you have by opening Windows Settings and navigating to System > About.*

After installing the Ubuntu dependencies, continue as follows.
After installing the Ubuntu dependencies, continue on Ubuntu as follows.

To build with Dolby Vision support, install the additional Rust dependencies for Windows ARM.

Expand Down Expand Up @@ -67,7 +67,7 @@ Build LibHB and the HandBrake CLI using the cross-compilation toolchain.

*This section is for running HandBrake on x64-based Windows machines only (not ARM). You can find the type of machine you have by opening Windows Settings and navigating to System > About.*

After installing the Ubuntu dependencies, continue as follows.
After installing the Ubuntu dependencies, continue on Ubuntu as follows.

To build with Dolby Vision support, install the additional Rust dependencies for Windows x64.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -16,67 +16,102 @@ License_URL: https://handbrake.fr/docs/license.html
Installing dependencies on Alpine
=================================

The following instructions are for [Alpine](https://www.alpinelinux.org) 3.18.
The following instructions are for [Alpine](https://www.alpinelinux.org) 3.24.

Basic requirements to run commands:

- curl
- sudo (for normal user accounts)

Dependencies:

- autoconf
- automake
- build-base
- busybox
- cmake
- g++
- freetype-dev
- fribidi-dev
- git
- harfbuzz-dev
- jansson-dev
- lame-dev
- libass-dev
- libjpeg-turbo-dev
- libogg-dev
- libtheora-dev
- libtool
- libunwind-static
- libvorbis-dev
- libvpx-dev
- libxml2-dev
- m4
- make
- meson
- nasm
- ninja
- numactl-dev
- opus-dev
- patch
- pkgconf
- python3
- speex-dev
- tar
- x264-dev

Intel Quick Sync Video dependencies (optional):
Additional dependencies not available in the base repository:

- libass-dev [Alpine Community]
- libvpx-dev [Alpine Community]
- x264-dev [Alpine Community]

Dolby Vision dependencies (optional):

- openssl-libs-static
- rustup [Alpine Community]
- zlib-static

Intel Quick Sync Video and VAAPI dependencies (optional):

- libva-dev
- libdrm-dev

Nvidia NVENC/NVDEC dependencies (optional):

- clang22
- llvm22

Graphical interface dependencies:

- desktop-file-utils
- gstreamer-dev
- gst-libav
- gst-plugins-base-dev
- gst-plugins-good
- gtk+3.0-dev
- gtk4.0-dev

Install dependencies.

sudo apk add autoconf automake busybox cmake g++ git jansson-dev lame-dev libass-dev libjpeg-turbo-dev libtheora-dev libtool libvorbis-dev libvpx-dev libxml2-dev m4 make meson nasm ninja numactl-dev opus-dev patch pkgconf python3 speex-dev tar x264-dev
sudo apk add autoconf automake build-base busybox cmake freetype-dev fribidi-dev git harfbuzz-dev jansson-dev lame-dev libass-dev libjpeg-turbo-dev libogg-dev libtheora-dev libtool libunwind-static libvorbis-dev libxml2-dev m4 meson nasm ninja numactl-dev opus-dev pkgconf python3 speex-dev tar x264-dev

To build with Intel Quick Sync Video support, install the QSV dependencies.
Enable the Alpine community repository and install related additional dependencies.

sudo setup-apkrepos -c
sudo apk add libass-dev libvpx-dev x264-dev

To build with Dolby Vision support, install the Rust dependencies.

sudo apk add openssl-libs-static rustup zlib-static
rustup-init -y && source "${HOME}/.cargo/env"
rustup toolchain install "stable-$(uname -m)-unknown-linux-musl"
rustup default "stable-$(uname -m)-unknown-linux-musl"
cargo install cargo-c

To build with Intel Quick Sync Video and VAAPI support, install the VAAPI dependencies.

sudo apk add libva-dev libdrm-dev

To build with Nvidia NVENC/NVDEC support, install the CUDA LLVM toolchain dependencies.

sudo apt-get install clang22 llvm22

To build the GTK [GUI](abbr:Graphical User Interface), install the graphical interface dependencies.

sudo apk add desktop-file-utils gst-libav gst-plugins-base-dev gst-plugins-good gtk+3.0-dev
sudo apk add desktop-file-utils gst-libav gst-plugins-base-dev gst-plugins-good gtk4.0-dev

Alpine is now prepared to build HandBrake. See [Building HandBrake for Linux](build-linux.markdown) for further instructions.
32 changes: 26 additions & 6 deletions source/docs/en/latest/developer/install-dependencies-arch.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ License_URL: https://handbrake.fr/docs/license.html
Installing dependencies on Arch
===============================

The following instructions are for [Arch](https://www.archlinux.org) 2023.10.01.
The following instructions are for [Arch](https://www.archlinux.org) 2026.08.01.

Basic requirements to run commands:

Expand Down Expand Up @@ -53,11 +53,20 @@ Dependencies:
- x264
- xz

Intel Quick Sync Video dependencies (optional):
Dolby Vision dependencies (optional):

- rustup

Intel Quick Sync Video and VAAPI dependencies (optional):

- libva
- libdrm

Nvidia NVENC/NVDEC dependencies (optional):

- clang
- llvm

Graphical interface dependencies:

- desktop-file-utils
Expand All @@ -67,14 +76,25 @@ Graphical interface dependencies:

Install dependencies.

sudo pacman -Syu base-devel cmake flac fontconfig freetype2 fribidi git harfbuzz jansson lame libass libbluray libjpeg-turbo libogg libsamplerate libtheora libvorbis libvpx libxml2 meson nasm ninja numactl opus python speex x264 xz
sudo pacman -S --needed base-devel cmake flac fontconfig freetype2 fribidi git harfbuzz jansson lame libass libbluray libjpeg-turbo libogg libsamplerate libtheora libvorbis libvpx libxml2 meson nasm ninja numactl opus python speex x264 xz

To build with Dolby Vision support, install the Rust dependencies.

sudo pacman -S --needed rustup
rustup toolchain install "stable-$(uname -m)-unknown-linux-gnu"
rustup default "stable-$(uname -m)-unknown-linux-gnu"
cargo install cargo-c

To build with Intel Quick Sync Video and VAAPI support, install the VAAPI dependencies.

sudo pacman -S --needed libva libdrm

To build with Intel Quick Sync Video support, install the QSV dependencies.
To build with Nvidia NVENC/NVDEC support, install the CUDA LLVM toolchain dependencies.

sudo pacman -Syu libva libdrm
sudo pacman -S --needed clang llvm

To build the GTK [GUI](abbr:Graphical User Interface), install the graphical interface dependencies.

sudo pacman -Syu desktop-file-utils gst-libav gst-plugins-good gtk4
sudo pacman -S --needed desktop-file-utils gst-libav gst-plugins-good gtk4

Arch is now prepared to build HandBrake. See [Building HandBrake for Linux](build-linux.markdown) for further instructions.
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
Type: article
Title: Installing dependencies on Clear
Title: Installing dependencies on Clear Linux
Project: HandBrake
Project_URL: https://handbrake.fr/
Project_Version: Latest
Expand All @@ -11,97 +11,10 @@ Copyright: 2026 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
Redirect_URL: build-linux.html
---

Installing dependencies on Clear
================================
Installing dependencies on Clear Linux
======================================

The following instructions are for [Clear](https://clearlinux.org) 40470 and later.

Basic requirements to run commands:

- curl
- sudo (for normal user accounts)

Dependencies:

- c-basic
- dev-utils
- devpkg-bzip2
- devpkg-fontconfig
- devpkg-freetype
- devpkg-fribidi
- devpkg-jansson
- devpkg-harfbuzz
- devpkg-libass
- devpkg-libjpeg-turbo
- devpkg-libogg
- devpkg-libsamplerate
- devpkg-libtheora
- devpkg-libvorbis
- devpkg-libvpx
- devpkg-libxml2
- devpkg-numactl
- devpkg-opus
- devpkg-speex
- devpkg-xz
- devpkg-zlib
- git

Additional dependencies not available in the base repository:

- lame
- x264

Intel Quick Sync Video dependencies (optional):

- devpkg-libva
- devpkg-libdrm

Graphical interface dependencies:

- desktop-dev

Install dependencies.

sudo swupd bundle-add c-basic dev-utils devpkg-bzip2 devpkg-fontconfig devpkg-freetype devpkg-fribidi devpkg-jansson devpkg-harfbuzz devpkg-libass devpkg-libjpeg-turbo devpkg-libogg devpkg-libsamplerate devpkg-libtheora devpkg-libvorbis devpkg-libvpx devpkg-libxml2 devpkg-numactl devpkg-opus devpkg-speex devpkg-xz devpkg-zlib git

Build and install the dependencies not available in the base repository.

# lame
curl -LO https://sourceforge.net/projects/lame/files/lame/3.100/lame-3.100.tar.gz
tar -xf lame-3.100.tar.gz
cd lame-3.100
./configure --enable-shared --enable-static --enable-nasm
make -j$(nproc)
sudo make install-strip
cd ..

# x264
curl -LO https://code.videolan.org/videolan/x264/-/archive/master/x264-master.tar.bz2
tar -xf x264-master.tar.bz2
cd x264-master
./configure --enable-shared --enable-static --enable-lto --enable-pic --enable-strip
make -j$(nproc)
sudo make install
cd ..

# make shared libraries findable
if ! grep '/usr/local/lib' /etc/ld.so.conf >/dev/null 2>&1; then
export CFLAGS="${CFLAGS:-} -I/usr/local/include"
export LDFLAGS="${LDFLAGS:-} -L/usr/local/lib"
echo 'export CFLAGS="${CFLAGS:-} -I/usr/local/include"' >> "${HOME}/.bashrc"
echo 'export LDFLAGS="${LDFLAGS:-} -L/usr/local/lib"' >> "${HOME}/.bashrc"
echo '/usr/local/lib' | sudo tee --append /etc/ld.so.conf
sudo ldconfig
fi

To build with Intel Quick Sync Video support, install the QSV dependencies.

sudo swupd bundle-add devpkg-libva devpkg-libdrm

To build the GTK [GUI](abbr:Graphical User Interface), install the graphical interface dependencies.

sudo swupd bundle-add desktop-dev

Clear is now prepared to build HandBrake. See [Building HandBrake for Linux](build-linux.markdown) for further instructions.
Clear Linux was discontinued in 2025 and is no longer supported. See [Building HandBrake for Linux](build-linux.markdown) for information on building HandBrake for other Linux distros.
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ License_URL: https://handbrake.fr/docs/license.html
Installing dependencies on Debian
=================================

The following instructions are for [Debian](https://www.debian.org) 11 Bullseye and 12 Bookworm.
The following instructions are for [Debian](https://www.debian.org) 13 Trixie.

Basic requirements to run commands:

Expand All @@ -33,7 +33,7 @@ Dependencies:
- libass-dev
- libbz2-dev
- libfontconfig-dev
- libfreetype6-dev
- libfreetype-dev
- libfribidi-dev
- libharfbuzz-dev
- libjansson-dev
Expand All @@ -44,30 +44,39 @@ Dependencies:
- libopus-dev
- libsamplerate0-dev
- libspeex-dev
- libssl-dev
- libtheora-dev
- libtool
- libtool-bin
- libturbojpeg0-dev
- libvorbis-dev
- libvpx-dev
- libx11-dev
- libx264-dev
- libxml2-dev
- libvpx-dev
- m4
- make
- meson
- nasm
- ninja-build
- patch
- pkg-config
- python3
- tar
- zlib1g-dev

Intel Quick Sync Video dependencies (optional):
Dolby Vision dependencies (optional):

- rustup

Intel Quick Sync Video and VAAPI dependencies (optional):

- libva-dev
- libdrm-dev

Nvidia NVENC/NVDEC dependencies (optional):

- clang
- llvm

Graphical interface dependencies:

- appstream
Expand All @@ -81,12 +90,23 @@ Graphical interface dependencies:
Install dependencies.

sudo apt-get update
sudo apt-get install autoconf automake build-essential cmake git libass-dev libbz2-dev libfontconfig-dev libfreetype6-dev libfribidi-dev libharfbuzz-dev libjansson-dev liblzma-dev libmp3lame-dev libnuma-dev libogg-dev libopus-dev libsamplerate0-dev libspeex-dev libtheora-dev libtool libtool-bin libturbojpeg0-dev libvorbis-dev libx264-dev libxml2-dev libvpx-dev m4 make meson nasm ninja-build patch python3 pkg-config tar zlib1g-dev
sudo apt-get install autoconf automake build-essential cmake git libass-dev libbz2-dev libfontconfig-dev libfreetype-dev libfribidi-dev libharfbuzz-dev libjansson-dev liblzma-dev libmp3lame-dev libnuma-dev libogg-dev libopus-dev libsamplerate0-dev libspeex-dev libssl-dev libtheora-dev libtool libtool-bin libturbojpeg0-dev libvorbis-dev libvpx-dev libx11-dev libx264-dev libxml2-dev m4 make meson nasm ninja-build patch pkg-config zlib1g-dev

To build with Dolby Vision support, install the Rust dependencies.

sudo apt-get install rustup
rustup toolchain install "stable-$(uname -m)-unknown-linux-gnu"
rustup default "stable-$(uname -m)-unknown-linux-gnu"
cargo install cargo-c

To build with Intel Quick Sync Video support, install the QSV dependencies.
To build with Intel Quick Sync Video and VAAPI support, install the VAAPI dependencies.

sudo apt-get install libva-dev libdrm-dev

To build with Nvidia NVENC/NVDEC support, install the CUDA LLVM toolchain dependencies.

sudo apt-get install clang llvm

To build the GTK [GUI](abbr:Graphical User Interface), install the graphical interface dependencies.

sudo apt-get install appstream desktop-file-utils gettext gstreamer1.0-libav gstreamer1.0-plugins-good libgstreamer-plugins-base1.0-dev libgtk-4-dev
Expand Down
Loading
Loading