4.0 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 Windows | HandBrake | https://handbrake.fr/ | Latest | English | en |
|
2017 HandBrake Team | Creative Commons Attribution-ShareAlike 4.0 International | CC BY-SA 4.0 | https://handbrake.fr/docs/license.html |
Building HandBrake for Windows
Command line interface and LibHB
Building the HandBrake [CLI](abbr:Command Line Interface) 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.
Dependencies:
- cmake
- curl
- gcc
- git
- libtool
- m4
- make
- patch
- python
- tar
- wget
- yasm
Additional MinGW-w64 toolchain dependencies:
- bison
- bzip2
- flex
- g++
- gunzip
- pax
Install dependencies.
sudo apt-get update
sudo apt-get install cmake curl gcc git intltool libtool m4 make patch python tar wget yasm
Install the additional dependencies required to build the MinGW-w64 toolchain.
sudo apt-get install bison bzip2 flex g++ gunzip pax
Clone the HandBrake repository.
git clone https://github.com/HandBrake/HandBrake.git && cd HandBrake
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.
Build HandBrake.
./configure --cross=x86_64-w64-mingw32 --enable-qsv --launch-jobs=$(nproc) --launch
If you wish to use a higher quality AAC encoder, you can use the --enable-fdk-aac option. Please note that by doing so, HandBrake can NO LONGER BE DISTRIBUTED and can only be used for personal use. The FDK AAC encoder is not GPLv2 compatible.
When complete, you will find HandBrakeCLI.exe in the build directory and hb.dll in build/libhb.
To start over, simply remove the build directory.
if [[ "$(basename $(pwd))" == "build" ]]; then cd ..; fi
rm -rf build
Graphical interface
The following tools are required to build and run the [GUI](abbr:Graphical User Interface).
- Microsoft Visual Studio Community
- Source Tree git client
- Any git client will do. Our preference is SourceTree but both GitHub and Visual Studio 2015+ have their own git clients too if you prefer.
hb.dll(see the LibHB build instructions preceding these, or download from https://handbrake.fr/nightly.php)- Jetbrains Resharper
- Optional but if your considering developing on the Windows UI, we highly recommend you check it out!
- Jetbrains are kind enough to provide open-source licenses to us, so regular and active contributors to the HandBrake project can apply to us for one.
Clone 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.