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 Fedora 28 oder neuer und Ubuntu 18.04 LTS (Bionic Beaver) oder neuer; 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.

Installationsanleitung für Fedora

Folgende Anweisungen felten für Fedora 28 bis 30.

Grundlegende Voraussetzungen um Kommandos starten zu können: - sudo (for normal user accounts)

Abhängigkeiten: - Development Tools - C Development Tools and Libraries - cmake - gcc-c++ - git - libtool - m4 - make - meson - nasm - ninja-build - patch - python - tar - zlib-devel

Abhängigkeiten installieren:

sudo dnf update
sudo dnf groupinstall "Development Tools" "C Development Tools and Libraries"
sudo dnf install cmake gcc-c++ git libtool m4 make meson nasm ninja-build patch python tar zlib-devel

Zusätzliche Abhängigkeiten die für das erstellen der MinGW-w64 toolchain benötigt werden:

sudo dnf install bison bzip2 curl flex g++ gzip pax

Installationsanleitung für Ubuntu

Folgende Anweisungen felten für Ubuntu 18.04 LTS (Bionic Beaver) bis 19.10 (Eoan Ermine).

Grundlegende Voraussetzungen um Kommandos starten zu können: - sudo (for normal user accounts)

Abhängigkeiten:

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

Zusätzliche Abhängigkeiten für Ubuntu 18.10 und neuer: - meson

Zusätzliche Abhängigkeiten für Ubuntu 18.04 LTS: - python3-pip - meson (via pip3)

Zusätzliche MinGW-w64 toolchain Abhängigkeiten:

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

Abhängigkeiten installieren:

sudo apt-get update
sudo apt-get install automake autoconf autopoint build-essential cmake gcc git intltool libtool libtool-bin m4 make nasm ninja-build patch pkg-config python tar zlib1g-dev

Falls du Ubuntu 18.10 oder neuer verwendest, musst du folgendes installieren:

sudo apt-get install meson

Solltest du Ubuntu 18.04 LTS verwenden, installiere folgendes:

sudo apt-get install python3-pip
sudo pip3 install meson

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

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

Bauen der MinGW-w64 toolchain und HandBrake

Klone das HandBrake Repository:

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

Liste verfügbare Tags in der HandBrake 1.3.x Release Serie und checke den aktuellsten aus.

git tag --list | grep ^1\.3\.
git checkout refs/tags/$(git tag -l | grep -E '^1\.3\.[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 --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)
  • 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, und checke den Tag aktuellsten in der HandBrake 1.3.x Release Serie aus.

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.