<!-- src: https://trac.ffmpeg.org/wiki/CompilationGuide/Ubuntu -->

# Compile FFmpeg on Ubuntu


This basic guide supports **Ubuntu Xenial Xerus 16.04** and will enable several external encoding and decoding libraries: libfaac (AAC encoder), libfdk-aac (AAC encoder), libmp3lame (MP3 encoder), libopencore-amr (AMR encoder/decoder), librtmp (for additional RTMP protocols), libtheora (Theora encoder), libvorbis (Vorbis encoder), libvpx (VP8 encoder/decoder), and libx264 (H.264 encoder). These are optional and may be omitted if desired. This guide will also install many filters (see the filter list in the [Filtering Guide][1].

**Note:** Copy and paste the whole code box for each step.

## Preparation

Remove any existing packages:

```ssh
sudo apt -y  remove ffmpeg x264 libav-tools libvpx-dev libx264-dev
```
Get the dependencies (**Ubuntu Desktop** users):

```ssh
sudo apt-get update
sudo apt-get -y install build-essential checkinstall git libfaac-dev libgpac-dev \
  libjack-jackd2-dev libmp3lame-dev libopencore-amrnb-dev libopencore-amrwb-dev \
  librtmp-dev libsdl1.2-dev libtheora-dev libva-dev libvdpau-dev libvorbis-dev \
  libx11-dev libxfixes-dev pkg-config texi2html yasm zlib1g-dev
```

Get the dependencies (**Ubuntu Server** or headless users):

```ssh
sudo apt-get update
sudo apt-get -y install build-essential checkinstall git libfaac-dev libgpac-dev \
  libmp3lame-dev libopencore-amrnb-dev libopencore-amrwb-dev librtmp-dev libtheora-dev \
  libvorbis-dev pkg-config texi2html yasm zlib1g-dev
```
## Installation


### Install Yasm:

An assembler for x86 optimizations used by x264 and FFmpeg. Highly recommended or your resulting build may be very slow.

```ssh
cd ~/ffmpeg_sources
wget http://www.tortall.net/projects/yasm/releases/yasm-1.3.0.tar.gz
tar xzvf yasm-1.3.0.tar.gz
cd yasm-1.3.0
./configure --prefix="$HOME/ffmpeg_build" --bindir="$HOME/bin"
make
make install
```
### Install nasm:

NASM assembler. Required for compilation of x264 and other tools.

```ssh
cd ~/ffmpeg_sources
wget http://www.nasm.us/pub/nasm/releasebuilds/2.13.01/nasm-2.13.01.tar.bz2
tar xjvf nasm-2.13.01.tar.bz2
cd nasm-2.13.01
./autogen.sh
PATH="$HOME/bin:$PATH" ./configure --prefix="$HOME/ffmpeg_build" --bindir="$HOME/bin"
PATH="$HOME/bin:$PATH" make
make install
```

### libx264 | H.264 video encoder

Requires ffmpeg to be configured with --enable-gpl --enable-libx264. See the [H.264 Encoding Guide][2] for more information and usage examples.

If your repository provides libx264-dev version ≥ 118 then you can install that instead of compiling:

```ssh
sudo apt-get install libx264-dev
```

Otherwise you can compile:

```ssh
cd ~/ffmpeg_sources
wget http://download.videolan.org/pub/x264/snapshots/last_x264.tar.bz2
tar xjvf last_x264.tar.bz2
cd x264-snapshot*
PATH="$HOME/bin:$PATH" ./configure --prefix="$HOME/ffmpeg_build" --bindir="$HOME/bin" --enable-static --disable-opencl
PATH="$HOME/bin:$PATH" make
make install
```

**Note:** You can download the nightly [x264 source snapshot][3] as an alternative to using `git`.

### libx265 | H.265/HEVC video encoder. 

See the [H.265 Encoding Guide][4] for more information and usage examples.

If your repository provides libx265-dev version ≥ 68 then you can install that instead of compiling:

```ssh
sudo apt-get install libx265-dev
```

Otherwise you can compile:

```ssh
sudo apt-get install cmake mercurial
cd ~/ffmpeg_sources
hg clone https://bitbucket.org/multicoreware/x265
cd ~/ffmpeg_sources/x265/build/linux
PATH="$HOME/bin:$PATH" cmake -G "Unix Makefiles" -DCMAKE_INSTALL_PREFIX="$HOME/ffmpeg_build" -DENABLE_SHARED:bool=off ../../source
make
make install
```

### libfdk-aac | AAC audio encoder.

See the [AAC Audio Encoding Guide][5] for more information and usage examples.

Requires ffmpeg to be configured with --enable-libfdk-aac (and --enable-nonfree if you also included --enable-gpl).

If your repository provides libfdk-aac-dev then you can install that instead of compiling:

```ssh
sudo apt-get install libfdk-aac-dev
```

Otherwise you can compile:

```ssh
cd ~/ffmpeg_sources
wget -O fdk-aac.tar.gz https://github.com/mstorsjo/fdk-aac/tarball/master
tar xzvf fdk-aac.tar.gz
cd mstorsjo-fdk-aac*
autoreconf -fiv
./configure --prefix="$HOME/ffmpeg_build" --disable-shared
make
make install
```
### libmp3lame | MP3 audio encoder.

Requires ffmpeg to be configured with --enable-libmp3lame.

If your repository provides `libmp3lame-dev` version ≥ 3.98.3 then you can install that instead of compiling:

```ssh
sudo apt-get install libmp3lame-dev
```

Otherwise you can compile:

```ssh
cd ~/ffmpeg_sources
wget http://downloads.sourceforge.net/project/lame/lame/3.99/lame-3.99.5.tar.gz
tar xzvf lame-3.99.5.tar.gz
cd lame-3.99.5
./configure --prefix="$HOME/ffmpeg_build" --enable-nasm --disable-shared
make
make install
```

### libopus | Opus audio decoder and encoder.

Requires ffmpeg to be configured with --enable-libopus.

If your repository provides `libopus-dev` version ≥ 1.1 then you can install that instead of compiling:

```ssh
sudo apt-get install libopus-dev
```

Otherwise you can compile:

```ssh
cd ~/ffmpeg_sources
wget https://archive.mozilla.org/pub/opus/opus-1.1.5.tar.gz
tar xzvf opus-1.1.5.tar.gz
cd opus-1.1.5
./configure --prefix="$HOME/ffmpeg_build" --disable-shared
make
make install
```

### libvpx | VP8/VP9 video encoder and decoder. See the VP8 Video Encoding Guide for more information and usage examples.

Requires ffmpeg to be configured with --enable-libvpx.

If your repository provides `libvpx-dev` version ≥ 0.9.7 then you can install that instead of compiling:

```ssh
sudo apt-get install libvpx-dev
```

Otherwise you can compile:

```ssh
sudo apt-get install git
cd ~/ffmpeg_sources
git clone --depth 1 https://chromium.googlesource.com/webm/libvpx.git
cd libvpx
PATH="$HOME/bin:$PATH" ./configure --prefix="$HOME/ffmpeg_build" --disable-examples --disable-unit-tests
PATH="$HOME/bin:$PATH" make
make install
```

**Note:** You can download a [libvpx source snapshot][6] as an alternative to using `git`.

### FFmpeg

```ssh
cd ~/ffmpeg_sources
git clone --depth 1 https://git.ffmpeg.org/ffmpeg.git
cd ffmpeg
PATH="$HOME/bin:$PATH" PKG_CONFIG_PATH="$HOME/ffmpeg_build/lib/pkgconfig" ./configure \
  --prefix="$HOME/ffmpeg_build" \
  --pkg-config-flags="--static" \
  --extra-cflags="-I$HOME/ffmpeg_build/include" \
  --extra-ldflags="-L$HOME/ffmpeg_build/lib" \
  --bindir="$HOME/bin" \
  --enable-gpl \
  --enable-libass \
  --enable-libfdk-aac \
  --enable-libfreetype \
  --enable-libmp3lame \
  --enable-libopencore-amrnb \
  --enable-libopencore-amrwb \
  --enable-librtmp \
  --enable-libopus \
  --enable-libtheora \
  --enable-libvorbis \
  --enable-libvpx \
  --enable-libx264 \
  --enable-libx265 \
  --enable-nonfree \
  --enable-version3 \
  --enable-x11grab \
PATH="$HOME/bin:$PATH" make
make install
hash -r
```

**Note:** You can download the nightly [FFmpeg source snapshot][7] as an alternative to using `git`.

```ssh
cd ~/ffmpeg_sources
wget http://ffmpeg.org/releases/ffmpeg-snapshot.tar.bz2
tar xjvf ffmpeg-snapshot.tar.bz2
cd ffmpeg
PATH="$HOME/bin:$PATH" PKG_CONFIG_PATH="$HOME/ffmpeg_build/lib/pkgconfig" ./configure \
  --prefix="$HOME/ffmpeg_build" \
  --pkg-config-flags="--static" \
  --extra-cflags="-I$HOME/ffmpeg_build/include" \
  --extra-ldflags="-L$HOME/ffmpeg_build/lib" \
  --bindir="$HOME/bin" \
  --enable-gpl \
  --enable-libass \
  --enable-libfdk-aac \
  --enable-libfreetype \
  --enable-libmp3lame \
  --enable-libopencore-amrnb \
  --enable-libopencore-amrwb \
  --enable-librtmp \
  --enable-libopus \
  --enable-libtheora \
  --enable-libvorbis \
  --enable-libvpx \
  --enable-libx264 \
  --enable-libx265 \
  --enable-nonfree
PATH="$HOME/bin:$PATH" make
make install
hash -r
```

**Note:** Ubuntu Server users should omit `--enable-x11grab`.

### Finish

Installation is now complete and FFmpeg is now ready for use. You can keep the x264, libvpx, and ffmpeg directories in your home directory if you plan on updating later. See Updating FFmpeg below for more details. Some optional steps are next followed by instructions on updating FFmpeg and finally instructions on reverting all changes made by this guide.

## Optional Installation

### qt-faststart

This is a useful tool if you're showing your H.264 in MP4 videos on the web. It relocates some data in the video to allow playback to begin before the file is completely downloaded. Usage: `qt-faststart input.mp4 output.mp4`.

```ssh
cd ~/ffmpeg
make tools/qt-faststart
make install
```

## Updating FFmpeg

Development of FFmpeg is active and an occasional update can give you new features and bug fixes. First you need to delete (or move) the old files:

```ssh
sudo apt -y remove ffmpeg x264 libx264-dev libvpx-dev
sudo apt update
sudo apt -y install build-essential checkinstall git libfaac-dev libgpac-dev \
  libjack-jackd2-dev libmp3lame-dev libopencore-amrnb-dev libopencore-amrwb-dev \
  librtmp-dev libsdl1.2-dev libtheora-dev libva-dev libvdpau-dev libvorbis-dev \
  libx11-dev libxfixes-dev texi2html yasm zlib1g-dev
```

Or just removing the source and build directories.

```ssh
rm -rf ~/ffmpeg_build ~/ffmpeg_sources ~/bin/{ffmpeg,ffprobe,ffplay,ffserver,x264,x265}
```

Now just follow the guide from the beginning.

### x264

```ssh
cd ~/ffmpeg_sources
cd x264-snapshot*
make distclean
git pull
```

Now run `./configure`, `make`, and `make install` as shown in the install x264 section.

### libvpx

```ssh
cd ~/ffmpeg_sources
cd ~/libvpx
make clean
git pull
```

Now run `./configure`, `make`, and `make install` as shown in the install libvpx section.

### FFmpeg

```ssh
cd ~/ffmpeg_sources
cd ~/ffmpeg
make distclean
git pull
```

Now run `./configure`, `make`, and `make install` as shown in the install FFmpeg section.

## Reverting Changes Made by This Guide

To remove FFmpeg/x264 and other packages added for this guide:
```ssh
rm -rf ~/ffmpeg_build ~/ffmpeg_sources ~/bin/{ffmpeg,ffprobe,ffplay,ffserver,x264,x265,nasm}
sudo apt autoremove autoconf automake build-essential cmake libass-dev libfreetype6-dev \
  libmp3lame-dev libopus-dev libsdl2-dev libtheora-dev libtool libva-dev libvdpau-dev \
  libvorbis-dev libvpx-dev libx264-dev libxcb1-dev libxcb-shm0-dev ibxcb-xfixes0-dev mercurial texinfo zlib1g-dev
sed -i '/ffmpeg_build/c\' ~/.manpath
hash -r
```

Or remove the packages and manually remove the directories created by this guide:
```ssh
sudo apt -y autoremove build-essential checkinstall fdk-aac ffmpeg git libfaac-dev libgpac-dev \
  libjack-jackd2-dev libmp3lame-dev librtmp-dev libsdl1.2-dev libtheora-dev libva-dev libvdpau-dev \
  libvorbis-dev libvpx libx11-dev libxfixes-dev pkg-config qt-faststart texi2html x264 yasm zlib1g-dev
hash -r
```

Lastly, delete the `x264`, `fdk-aac`, `libvpx`, and `ffmpeg` directories in your home folder.


[1]: https://trac.ffmpeg.org/wiki/FilteringGuide#ListofFilters
[2]: https://trac.ffmpeg.org/wiki/Encode/H.264
[3]: http://download.videolan.org/pub/x264/snapshots/last_x264.tar.bz2
[4]: https://trac.ffmpeg.org/wiki/Encode/H.265
[5]: https://trac.ffmpeg.org/wiki/Encode/AAC
[6]: http://code.google.com/p/webm/downloads/list
[7]: http://ffmpeg.org/releases/ffmpeg-snapshot.tar.bz2