HandBrake-docs/source/docs/en/latest/developer/build-linux.markdown
Bradley Sepos 7301a04294 docs: Add first draft of Building HandBrake for Linux.
Instructions for Ubuntu 14.04 LTS (Trusty Tahr) and Ubuntu 16.04 LTS (Xenial Xerus).
2016-11-14 23:19:50 -05:00

2.7 KiB

Type, State, Title, Project, Project_URL, Project_Version, Language, Language_Code, Authors, Copyright, License, License_Abbr, License_URL
Type State Title Project Project_URL Project_Version Language Language_Code Authors Copyright License License_Abbr License_URL
article draft Building HandBrake for Linux HandBrake https://handbrake.fr/ Latest English en Bradley Sepos <bradley@bradleysepos.com> (BradleyS) 2016 HandBrake Team Creative Commons Attribution-ShareAlike 4.0 International CC BY-SA 4.0 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