HandBrake Documentation

HandBrake für Windows bauen

Kommandozeileninterface und LibHB

Um die HandBrake CLI und LibHB(hb.dll) für Windows zu bauen, benötigt man Linux und eine aktuelle MinGW-w64 toolchain. Empfohlen ist Ubuntu 18.04 LTS (Bionic Beaver); andere Distributionen könnten auch funktionieren. Auf jeden Fall empfehlen wir die MinGW-w64 toolchain mithilfe unserer Anweisungen und dem mitgeliefertem Script zu installieren, da die meisten als Paket angebotenen Versionen Probleme haben, die zu einem nicht funktionierenden Build führen können.

Die folgenden Anweisungen sind für Ubuntu 18.04 LTS (Bionic Beaver).

Abhängigkeiten:

• autoconf
• automake
• build-essential
• cmake
• curl
• gcc
• git
• libtool
• libtool-bin
• m4
• make
• nasm
• patch
• pkg-config
• python
• tar
• yasm
• zlib1g-dev

Zusätzliche MinGW-w64 toolchain Abhängigkeiten:

• bison
• bzip2
• flex
• g++
• gzip
• pax

Abhängigkeiten installieren:

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

Installiere zusätzliche Abhängigkeiten die für den Build der MinGW-w64 toolchain benötigt werden:

sudo apt-get install bison bzip2 flex g++ gzip pax

Klone das HandBrake Repository:

git clone https://github.com/HandBrake/HandBrake.git && cd HandBrake

Liste alle verfügbaren Tags in der HandBrake 1.2.x Release Serie, und checke den aktuellsten aus.

git tag --list | grep ^1\.2\.
git checkout refs/tags/$(git tag -l | grep -E '^1\.2\.[0-9]+$' | tail -n 1)

Baue die MinGW-w64 toolchain mit dem mitgelieferten Script und ersetze username durch deinen Benutzernamen. Du kannst natürlich einen anderen Ausgabepfad einstellen wenn du möchtest.

scripts/mingw-w64-build x86_64 /home/username/toolchains/

Dieser Prozess wird ein paar Minuten in Anspruch nehmen und dir nach Abschluss Anweisungen geben, wie du die erstellten Binaries zum PATH deiner Umgebung hinzufügen kannst. Mache dies jetzt.

Baue HandBrake. Für Audio mit höherer Qualität, aktivere den FDK AAC Kodierer indem du --enable-fdk-aac anhängst. Builds die FDK AAC inkludieren dürfen nur für persönlichen Gebrauch genutzt werden und dürfen nicht weitergegeben werden.¹

./configure --cross=x86_64-w64-mingw32 --enable-qsv --enable-vce --enable-nvenc --launch-jobs=$(nproc) --launch

Wenn der Prozess abgeschlossen ist, findest du HandBrakeCLI.exe in deinem build Ordner und hb.dll in dem build/libhb Verzeichnis.

Um von Vorne zu beginnen, lösche einfach das build Verzeichnis.

rm -rf build

Grafische Benutzeroberfläche

Die folgenden Tools werden benötigt um die GUI zu bauen und zu starten.

• Microsoft Visual Studio Community
• Einen Git Client
  • Source Tree (empfohlen)
  • Client inkludiert in Visual Studio 2015 oder neuer
• hb.dll (siehe die oben angeführten Anweisungen um LibHB zu bauen, oder lade sie von https://handbrake.fr/nightly.php) herunter.
• JetBrains ReSharper (optional)
  • Sehr empfohlen für Entwickler die an der Arbeit der Windows UI interessiert sind
  • Aktive, reguläre Kontributoren können eine gratis ReSharper Lizenz für quelloffene Projekte beim HandBrake Team anfragen, courtesy JetBrains

Klone https://github.com/HandBrake/HandBrake.git mit deinem Git Client.

Der Quellcode für die GUI befindet sich im win\CS Ordner und der Name der Projektdatei ist HandBrake.sln. Stelle sicher, dass HandBrakeWPF als Startup Projekt im Solution Explorer eingestellt ist, indem du einen Rechtsklick auf den Namen ausführst und “Set as startup projekt” auswählst.

Um die GUI zu bauen, wähle Build Solution aus dem Build Menü.

Wenn der Prozess abgeschlossen ist, finde den Ausgabeordner wo HandBrake.exe erstellt wird (üblicherweise in win\CS\HandBrakeWPF\bin\,,,, abhängig vom gewählten build profil). Kopiere hb.dll in diesen Ordner. Dies schließt den Build Prozess ab.