HandBrake/HandBrake-docs
1
0
Fork 0
mirror of https://github.com/HandBrake/HandBrake-docs.git synced 2025-12-10 00:44:52 -06:00
Code Issues Packages Projects Releases 1 Wiki Activity

docs: Update Windows via Ubuntu build guide.

Browse Source
This commit is contained in:
Bradley Sepos 2019-10-14 17:01:11 -04:00
parent 9265b80e19
commit 35285acca4
No known key found for this signature in database
GPG Key ID: DEADE2F57D42D9C7
1 changed files with 22 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
source/docs/en/latest/developer/build-windows.markdown
View File

@ -18,9 +18,9 @@ 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 18.04 LTS (Bionic Beaver) 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.
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 18.04 LTS (Bionic Beaver) 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 some packaged versions have issues that can produce non-functioning builds.
The following instructions are for Ubuntu 18.04 LTS (Bionic Beaver).
The following instructions are for [Ubuntu](https://www.ubuntu.com) 18.04 LTS (Bionic Beaver) through 19.10 (Eoan Ermine).
Dependencies:
@ -36,6 +36,7 @@ Dependencies:
- m4
- make
- nasm
- ninja-build
- patch
- pkg-config
- python
@ -43,6 +44,15 @@ Dependencies:
- yasm
- zlib1g-dev
Additional dependencies for Ubuntu 18.10 and later:
- meson
Additional Ubuntu 18.04 LTS dependencies:
- python3-pip
- meson (via pip3)
Additional MinGW-w64 toolchain dependencies:
- bison
@ -57,6 +67,15 @@ Install dependencies.
sudo apt-get update
sudo apt-get install automake autoconf build-essential cmake curl gcc git intltool libtool libtool-bin m4 make nasm patch pkg-config python tar yasm zlib1g-dev
If you are running Ubuntu 18.10 or later, install the additional dependencies.
sudo apt-get install meson
If you are running Ubuntu 18.04 LTS, the `meson` package is too old. Install a newer version provided by the [Python Package Index](https://pypi.org/).
sudo apt-get install python3-pip
sudo pip3 install meson
Install the additional dependencies required to build the MinGW-w64 toolchain.
sudo apt-get install bison bzip2 flex g++ gzip pax
@ -73,7 +92,7 @@ This process will take a few minutes, then provide you with instructions for add
Build HandBrake. For higher quality audio, enable the FDK AAC encoder by appending `--enable-fdk-aac`. Builds including FDK AAC must be for personal use only and may not be distributed.[^fdk-aac-license]
./configure --cross=x86_64-w64-mingw32 --enable-qsv --enable-vce --enable-nvenc --launch-jobs=$(nproc) --launch
./configure --cross=x86_64-w64-mingw32 --launch-jobs=$(nproc) --launch
When complete, you will find `HandBrakeCLI.exe` in the `build` directory and `hb.dll` in `build/libhb`.