Building HandBrake for Windows
Command line interface and LibHB
Building the HandBrake CLI and LibHB (
hb.dll) for Windows requires Linux and a recent MinGW-w64 toolchain. Ubuntu 16.04 LTS or later is recommended; other distros may work as well. In all cases, we recommend you build the MinGW-w64 toolchain using our instructions and the included script, as most packaged versions have issues that can produce non-functioning builds.
The following instructions are for Ubuntu 16.04 LTS.
Install all dependencies.
sudo apt-get install cmake curl gcc git intltool libtool m4 make patch python tar wget yasm
Clone the HandBrake repository.
git clone https://github.com/HandBrake/HandBrake.git && cd HandBrake
Check out the most recent tag in the HandBrake 1.0.x release series.
git checkout refs/tags/$(git tag -l | grep -E '^1\.0\.[0-9]+$' | tail -n 1)
Build the MinGW-w64 toolchain using the included script, where
username is your user name. Feel free to choose a different output path, if desired.
scripts/mingw-w64-build x86_64 /home/username/toolchains/
This process will take a few minutes, then provide you with instructions for adding the resulting binaries location to your environment’s
PATH. Do this now.
./configure --cross=x86_64-w64-mingw32 --enable-qsv --launch-jobs=$(nproc) --launch
When complete, you will find
HandBrakeCLI.exe in the
build directory and
To start over, simply remove the
if [[ "$(basename $(pwd))" == "build" ]]; then cd ..; fi rm -rf build
The following tools are required to build and run the GUI.
- Microsoft Visual Studio Community
- Source Tree git client (optional)
- Visual Studio 2015 has built-in git support, if you prefer it
hb.dll(see the LibHB build instructions preceding these, or download from https://handbrake.fr/nightly.php)
https://github.com/HandBrake/HandBrake.git using your git client.
Source code for the GUI resides in the
win\CS folder and the solution file is named
HandBrake.sln. Make sure HandBrakeWPF is set as the startup project in the Solution Explorer by right-clicking the name and selecting “Set as startup project”.
To build the GUI, select Build Solution from the Build menu.
When complete, locate the output folder where
HandBrake.exe is created (typically in
win\CS\HandBrakeWPF\bin\..., depending on the selected build profile). Copy
hb.dll to this folder. This completes the build process.