diff --git a/source/docs/en/latest/developer/build-linux.markdown b/source/docs/en/latest/developer/build-linux.markdown new file mode 100644 index 00000000..f2cd0b3f --- /dev/null +++ b/source/docs/en/latest/developer/build-linux.markdown @@ -0,0 +1,97 @@ +--- +Type: article +State: draft +Title: Building HandBrake for Linux +Project: HandBrake +Project_URL: https://handbrake.fr/ +Project_Version: Latest +Language: English +Language_Code: en +Authors: Bradley Sepos (BradleyS) +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 Linux +============================ + +## Ubuntu + +The following instructions are for Ubuntu 14.04 LTS (Trusty Tahr) and Ubuntu 16.04 LTS (Xenial Xerus). + +Dependencies: + +- autoconf +- build-essential +- cmake +- git +- libass-dev +- libbz2-dev +- libfontconfig1-dev +- libfreetype6-dev +- libfribidi-dev +- libharfbuzz-dev +- libjansson-dev +- libmp3lame-dev +- libogg-dev +- libopus-dev +- libsamplerate-dev +- libtheora-dev +- libtool +- libvorbis-dev +- libx264-dev +- libxml2-dev +- m4 1.4.17 or later +- make +- patch +- python 2.7.1 or later (python 3 is currently not supported) +- tar +- yasm 1.2.0 or later (1.3.0 or later recommended) +- zlib1g-dev + +Additional Ubuntu 16.04 LTS dependencies: + +- libtool-bin + +Graphical interface dependencies: + +- intltool +- libappindicator-dev +- libdbus-glib-1-dev +- libglib2.0-dev +- libgstreamer1.0-dev +- libgstreamer-plugins-base1.0-dev +- libgtk-3-dev +- libgudev-1.0-dev +- libnotify-dev +- libwebkitgtk-3.0-dev + +Install dependencies. + + sudo apt-get install autoconf build-essential cmake git libass-dev libbz2-dev libfontconfig1-dev libfreetype6-dev libfribidi-dev libharfbuzz-dev libjansson-dev libmp3lame-dev libogg-dev libopus-dev libsamplerate-dev libtheora-dev libtool libvorbis-dev libx264-dev libxml2-dev m4 make patch python tar yasm zlib1g-dev + +If you are running Ubuntu 16.04 LTS, install the additional dependencies. + + sudo apt-get install libtool-bin + +To build the GTK [GUI](abbr:Graphical User Interface), install the graphical interface dependencies. + + sudo apt-get install intltool libappindicator-dev libdbus-glib-1-dev libglib2.0-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev libgtk-3-dev libgudev-1.0-dev libnotify-dev libwebkitgtk-3.0-dev + +## Building + +Clone the HandBrake repository. + + git clone https://github.com/HandBrake/HandBrake.git && cd HandBrake + +Build HandBrake. To build the command line interface only, disable the GTK GUI by appending `--disable-gtk`. + + ./configure --launch-jobs=$(nproc 2>/dev/null) --launch + +When complete, you will find `HandBrakeCLI` in the `build` directory. If enabled, you will also find `ghb` in the `build/gtk/src` directory. + +Install HandBrake, including icon and desktop files to populate the Applications menu (optional). + + cd build && sudo make install diff --git a/source/docs/en/latest/table-of-contents.markdown b/source/docs/en/latest/table-of-contents.markdown index 3d4e7ffc..4cfae95d 100644 --- a/source/docs/en/latest/table-of-contents.markdown +++ b/source/docs/en/latest/table-of-contents.markdown @@ -147,6 +147,7 @@ Table of contents - Releases - [Linux Flatpaks](developer/flatpak-repo.html) - Building HandBrake + - [Building HandBrake for Linux](developer/build-linux.html) - [Building HandBrake for Mac](developer/build-mac.html) - [Building HandBrake for Windows](developer/build-windows.html)