mirror of
https://github.com/HandBrake/HandBrake-docs.git
synced 2025-12-11 23:39:12 -06:00
101 lines
4.0 KiB
Markdown
101 lines
4.0 KiB
Markdown
---
|
|
Type: article
|
|
Title: Building HandBrake for Windows
|
|
Project: HandBrake
|
|
Project_URL: https://handbrake.fr/
|
|
Project_Version: Latest
|
|
Language: English
|
|
Language_Code: en
|
|
Authors: [ Bradley Sepos <bradley@bradleysepos.com> (BradleyS), Scott (s55) ]
|
|
Copyright: 2017 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 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](https://mingw-w64.org/) 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](https://www.visualstudio.com/vs/community/)
|
|
- [Source Tree](https://www.sourcetreeapp.com) 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](https://handbrake.fr/nightly.php))
|
|
- [Jetbrains Resharper](https://www.jetbrains.com/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.
|