docs: Add first draft of Building HandBrake for Linux.

Instructions for Ubuntu 14.04 LTS (Trusty Tahr) and Ubuntu 16.04 LTS (Xenial Xerus).
This commit is contained in:
Bradley Sepos 2016-11-14 23:16:19 -05:00
parent 56c3c04048
commit 7301a04294
2 changed files with 98 additions and 0 deletions

View File

@ -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 <bradley@bradleysepos.com> (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

View File

@ -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)