mirror of
https://github.com/HandBrake/HandBrake-docs.git
synced 2025-12-12 07:44:19 -06:00
80 lines
3.1 KiB
Markdown
80 lines
3.1 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: 2016 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 Windows [CLI](abbr:Command Line Interface) and LibHB (hb.dll) 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, as most packaged versions have issues that can produce non-functioning builds.
|
|
|
|
The following instructions are for Ubuntu 16.04 LTS.
|
|
|
|
Dependencies:
|
|
|
|
- git
|
|
- yasm [minimum recommended version: 1.3]
|
|
- libtool
|
|
- intltool
|
|
- cmake
|
|
- gcc
|
|
- make
|
|
- patch
|
|
- tar
|
|
- m4
|
|
- python 2 [minimum recommended version: 2.7.1]
|
|
- curl
|
|
- wget
|
|
|
|
Install all dependencies.
|
|
|
|
sudo apt-get install git yasm libtool intltool cmake gcc make patch tar m4 python curl wget
|
|
|
|
Clone the HandBrake repository.
|
|
|
|
git clone https://github.com/HandBrake/HandBrake.git && cd HandBrake
|
|
|
|
Build the MinGW-w64 toolchain using the provided 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.
|
|
|
|
Compile HandBrake.
|
|
|
|
./configure --cross=x86_64-w64-mingw32 --enable-x265 --enable-qsv --launch-jobs=1 --launch
|
|
|
|
When complete, you will find `HandBrakeCLI.exe` in the `build` directory and `hb.dll` in `build/libhb`.
|
|
|
|
|
|
## Graphical interface
|
|
|
|
The following tools are required to build and run the [GUI](abbr:Graphical User Interface).
|
|
|
|
- [Microsoft Visual Studio Community Edition](https://www.visualstudio.com/en-us/products/visual-studio-community-vs.aspx)
|
|
- [Source Tree](https://www.sourcetreeapp.com) 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://handbrake.fr/nightly.php))
|
|
|
|
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: right-click on HandBrakeWPF and select "Set as startup project".
|
|
|
|
To build the GUI, select Build Solution from the Build menu.
|
|
|
|
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.
|