HandBrake / HandBrake-docs

HandBrake Documentation
https://handbrake.fr/docs/
Creative Commons Attribution Share Alike 4.0 International
191 stars 89 forks source link

Update translations for 1.3.0 release. #88

Closed bradleysepos closed 4 years ago

bradleysepos commented 4 years ago

English content changes:

diff -ur source/docs/en/1.2.0/advanced/chapter-markers.markdown source/docs/en/1.3.0/advanced/chapter-markers.markdown
--- source/docs/en/1.2.0/advanced/chapter-markers.markdown  2019-11-09 17:18:24.000000000 -0500
+++ source/docs/en/1.3.0/advanced/chapter-markers.markdown  2019-11-09 17:18:39.000000000 -0500
@@ -14,21 +14,21 @@
 ---

 Chapter Markers
-=============================
+===============

 ## Chapters

-HandBrake can copy Chatper Markers from your source to the MP4 or MKV output file.
+HandBrake can copy chapter markers from your source to the MP4, MKV, or WebM output file.

-In HandBrake, if you click on the 'Chapters' tab, you'll see a list of detected chapters. HandBrake will automatically generated chapter names in the following format:  "Chatper n" where n is the chapter number.
+In HandBrake, if you click on the Chapters tab, you'll see a list of detected chapters. HandBrake will automatically generate chapter names in the following format:  "Chatper n" where n is the chapter number.

 ![Chapters Tab](../../images/windows/chapters-1.0.0.png "Chapters Tab")

-## Renaming Chapters.
+## Renaming chapters

-If you wish, you can re-name these by simply simply altering the names shown in the chapters tab.
+If you wish, you can rename these by simply simply altering the names shown in the chapters tab.

-You can also import or export the set of chapter markers.  HandBrake supports importing of CSV (Command seperated Values) files.
+You can also import or export the set of chapter markers. HandBrake supports importing of CSV (Command seperated Values) files.

 Click the Import button to choose a CSV file. The file must be in the following format:

@@ -44,4 +44,4 @@

 ## Sources without chapters

-Unfortunatly, HandBrake can not currently add chapter markers if they did not already exist in the source.
+Unfortunately, HandBrake can not currently add chapter markers if they did not already exist in the source.
diff -ur source/docs/en/1.2.0/advanced/subtitles.markdown source/docs/en/1.3.0/advanced/subtitles.markdown
--- source/docs/en/1.2.0/advanced/subtitles.markdown    2019-11-09 17:18:24.000000000 -0500
+++ source/docs/en/1.3.0/advanced/subtitles.markdown    2019-11-09 17:18:39.000000000 -0500
@@ -38,6 +38,8 @@
 - Hard Burn: This means the subtitles are written on top of the image permanently. They cannot be turned on or off like on the DVD.
 - Soft Subtitles: This means the subtitles will appear as separate selectable tracks in your output file. With the correct playback software, you’ll be able to enable / disable these subtitles as required.

+Soft subtitles are currently unsupported in the WebM container.
+
 The following subtitle types as supported as follows:

 - Bluray PGS Subtitles
diff -ur source/docs/en/1.2.0/cli/command-line-reference.markdown source/docs/en/1.3.0/cli/command-line-reference.markdown
--- source/docs/en/1.2.0/cli/command-line-reference.markdown    2019-11-09 17:18:24.000000000 -0500
+++ source/docs/en/1.3.0/cli/command-line-reference.markdown    2019-11-09 17:18:39.000000000 -0500
@@ -19,7 +19,7 @@
 The following details all the available options in the command line interface. This information may be accessed at any time by running `HandBrakeCLI --help`.

     Usage: HandBrakeCLI [options] -i <source> -o <destination>
-    
+
     General Options --------------------------------------------------------------

        -h, --help              Print help
@@ -51,10 +51,10 @@
        --queue-import-file <filename>
                                Import an encode queue file created by the GUI
            --no-dvdnav         Do not use dvdnav for reading DVDs
-    
-    
+
+
     Source Options ---------------------------------------------------------------
-    
+
        -i, --input <string>    Set input file or device ("source")
        -t, --title <number>    Select a title to encode (0 to scan all titles
                                only, default: 1)
@@ -73,21 +73,23 @@
        --start-at-preview <number>
                                Start encoding at a given preview.
        --start-at <string:number>
-                               Start encoding at a given duration (in seconds),
-                               frame, or pts (on a 90kHz clock)
-                               (e.g. duration:10, frame:300, pts:900000)
+                               Start encoding at a given offset in seconds,
+                               frames, or pts (on a 90kHz clock)
+                               (e.g. seconds:10, frames:300, pts:900000).
        --stop-at  <string:number>
-                               Stop encoding at a given duration (in seconds),
-                               frame, or pts (on a 90kHz clock)
-                               (e.g. duration:10, frame:300, pts:900000)
-    
-    
+                               Stop encoding after a given duration in seconds,
+                               frames, or pts (on a 90kHz clock) has passed
+                               (e.g. seconds:10, frames:300, pts:900000).
+                               Duration is relative to --start-at, if specified.
+
+
     Destination Options ----------------------------------------------------------
-    
+
        -o, --output <filename> Set destination file name
        -f, --format <string>   Select container format:
                                    av_mp4
                                    av_mkv
+                                   av_webm
                                default: auto-detected from destination file name)
        -m, --markers           Add chapter markers
            --no-markers        Disable preset chapter markers
@@ -102,10 +104,10 @@
        --inline-parameter-sets Create adaptive streaming compatible output.
                                Inserts parameter sets (SPS and PPS) inline
                                in the video stream before each IDR.
-    
-    
+
+
     Video Options ----------------------------------------------------------------
-    
+
        -e, --encoder <string>  Select video encoder:
                                    x264
                                    x264_10bit
@@ -169,10 +171,10 @@
                                timing if it's below that rate.
                                If none of these flags are given, the default
                                is --pfr when -r is given and --vfr otherwise
-    
-    
+
+
     Audio Options ----------------------------------------------------------------
-    
+
            --audio-lang-list <string>
                                Specify a comma separated list of audio
                                languages you would like to select from the
@@ -218,6 +220,7 @@
                                Defaults:
                                    av_mp4   ca_aac
                                    av_mkv   ca_aac
+                                   av_webm  vorbis
            --audio-copy-mask <string>
                                Set audio codecs that are permitted when the
                                "copy" audio encoder option is specified
@@ -249,8 +252,8 @@
                                Separate tracks by commas.
                                Defaults:
                                    none             up to dpl2
-                                   ca_aac           up to dpl2
-                                   ca_haac          up to dpl2
+                                   ca_aac           up to 7point1
+                                   ca_haac          up to 7point1
                                    ac3              up to 5point1
                                    eac3             up to 5point1
                                    mp3              up to dpl2
@@ -281,16 +284,34 @@
                                    rectangular
                                    triangular
                                    triangular_hp
-                                   triangular_ns
+                                   lipshitz_ns
                                Separate tracks by commas.
                                Supported by encoder(s):
+                                   none
+                                   ca_aac
+                                   ca_haac
+                                   copy:aac
+                                   ac3
+                                   copy:ac3
+                                   eac3
+                                   copy:eac3
+                                   copy:truehd
+                                   copy:dts
+                                   copy:dtshd
+                                   mp3
+                                   copy:mp3
+                                   vorbis
                                    flac16
+                                   flac24
+                                   copy:flac
+                                   opus
+                                   copy
        -A, --aname <string>    Set audio track name(s).
                                Separate tracks by commas.
-    
-    
+
+
     Picture Options --------------------------------------------------------------
-    
+
        -w, --width  <number>   Set storage width in pixels
        -l, --height <number>   Set storage height in pixels
            --crop   <top:bottom:left:right>
@@ -335,10 +356,10 @@
                                    ntsc (same as 601)
                                    pal
                                (default: auto-detected from source)
-    
-    
+
+
     Filters Options --------------------------------------------------------------
-    
+
        --comb-detect[=string]  Detect interlace artifacts in frames.
                                If not accompanied by the decomb or deinterlace
                                filters, this filter only logs the interlaced
@@ -514,10 +535,10 @@
                                    width=w:height=h:color=c:x=x:y=y
        -g, --grayscale         Grayscale encoding
        --no-grayscale          Disable preset 'grayscale'
-    
-    
+
+
     Subtitles Options ------------------------------------------------------------
-    
+
       --subtitle-lang-list <string>
                                Specify a comma separated list of subtitle
                                languages you would like to select from the
@@ -554,7 +575,7 @@
                                Example: "1,2,3" for multiple tracks.
                                If "string" is omitted, the first track is
                                forced.
-          --subtitle-burned[=number]
+          --subtitle-burned[=number, "native", or "none"]
                                "Burn" the selected subtitle into the video
                                track. If "subtitle" is omitted, the first
                                track is burned. "subtitle" is an index into
@@ -607,3 +628,23 @@
                                the video track.
                                If 'number' is omitted, the first SRT is burned.
                                'number' is a 1-based index into the 'srt-file' list
+         --ssa-file <string>   SubStationAlpha SSA filename(s), separated by
+                               commas.
+         --ssa-offset <string> Offset (in milliseconds) to apply to the SSA
+                               file(s), separated by commas. If not specified,
+                               zero is assumed. Offsets may be negative.
+         --ssa-lang <string>   SSA track language as an ISO 639-2 code
+                               (e.g. fre, eng, spa, dut, et cetera)
+                               If not specified, then 'und' is used.
+                               Separate by commas.
+         --ssa-default[=number]
+                               Flag the selected SSA as the default subtitle
+                               to be displayed during playback.
+                               Setting no default means no subtitle will be
+                               automatically displayed. If 'number' is omitted,
+                               the first SSA is the default.
+                               'number' is a 1-based index into the 'ssa-file' list
+         --ssa-burn[=number]   "Burn" the selected SSA subtitle into
+                               the video track.
+                               If 'number' is omitted, the first SSA is burned.
+                               'number' is a 1-based index into the 'ssa-file' list
diff -ur source/docs/en/1.2.0/developer/build-bsd.markdown source/docs/en/1.3.0/developer/build-bsd.markdown
--- source/docs/en/1.2.0/developer/build-bsd.markdown   2019-11-09 17:18:25.000000000 -0500
+++ source/docs/en/1.3.0/developer/build-bsd.markdown   2019-11-09 17:18:39.000000000 -0500
@@ -30,6 +30,11 @@

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

+List available tags in the HandBrake 1.3.x release series, and check out the most recent.
+
+    git tag --list | grep ^1\.3\.
+    git checkout refs/tags/$(git tag -l | grep -E '^1\.3\.[0-9]+$' | tail -n 1)
+
 Build HandBrake. To build the command line interface only, disable the graphical interface by appending `--disable-gtk`.

     ./configure --launch-jobs=$(sysctl -n hw.ncpu) --launch
diff -ur source/docs/en/1.2.0/developer/build-linux.markdown source/docs/en/1.3.0/developer/build-linux.markdown
--- source/docs/en/1.2.0/developer/build-linux.markdown 2019-11-09 17:18:25.000000000 -0500
+++ source/docs/en/1.3.0/developer/build-linux.markdown 2019-11-09 17:18:39.000000000 -0500
@@ -24,12 +24,13 @@

 - [Arch](install-dependencies-arch.html)
 - [CentOS](install-dependencies-centos.html)
+- [Clear](install-dependencies-clear.html)
 - [Debian](install-dependencies-debian.html)
 - [Fedora](install-dependencies-fedora.html)
 - [Gentoo](install-dependencies-gentoo.html)
 - [Ubuntu](install-dependencies-ubuntu.html)

-HandBrake's experimental support for Intel Quick Sync Video on Linux requires the [Intel Media SDK](https://github.com/Intel-Media-SDK/MediaSDK/releases).
+HandBrake’s optional experimental support for Intel Quick Sync Video on Linux requires installing the Intel Media SDK and its dependencies. See the [Intel Media SDK Releases](https://github.com/Intel-Media-SDK/MediaSDK/releases) page and [Intel Media SDK Build Instructions](https://github.com/Intel-Media-SDK/MediaSDK#how-to-build).

 ## Building HandBrake

@@ -37,12 +38,12 @@

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

-List available tags in the HandBrake 1.2.x release series, and check out the most recent.
+List available tags in the HandBrake 1.3.x release series, and check out the most recent.

-    git tag --list | grep ^1\.2\.
-    git checkout refs/tags/$(git tag -l | grep -E '^1\.2\.[0-9]+$' | tail -n 1)
+    git tag --list | grep ^1\.3\.
+    git checkout refs/tags/$(git tag -l | grep -E '^1\.3\.[0-9]+$' | tail -n 1)

-Build HandBrake. To enable experimental support for Intel QSV via the [Intel Media SDK](https://github.com/Intel-Media-SDK/MediaSDK/releases), append `--enable-qsv`. To build the command line interface only, disable the graphical interface by appending `--disable-gtk`.
+Build HandBrake. To enable experimental support for Intel Quick Sync Video, append `--enable-qsv`. To build the command line interface only, disable the graphical interface by appending `--disable-gtk`.

     ./configure --launch-jobs=$(nproc) --launch

diff -ur source/docs/en/1.2.0/developer/build-mac.markdown source/docs/en/1.3.0/developer/build-mac.markdown
--- source/docs/en/1.2.0/developer/build-mac.markdown   2019-11-09 17:18:24.000000000 -0500
+++ source/docs/en/1.3.0/developer/build-mac.markdown   2019-11-09 17:18:39.000000000 -0500
@@ -16,37 +16,46 @@
 Building HandBrake for Mac
 ==========================

-Building HandBrake for Mac requires an Apple computer with a 64-bit Intel processor running OS X 10.13.6 High Sierra or later[^mojave-dark-mode], and the following dependencies.
+Building HandBrake for Mac requires an Apple computer with a 64-bit Intel processor running macOS 10.14.3 Mojave or later, and the following dependencies.

-- [Xcode](https://developer.apple.com/xcode/) 10 or later
+- [Xcode](https://developer.apple.com/xcode/) 10.3 or later
   - free Apple Developer registration required, or install from the Mac App Store
 - [Command Line Tools for Xcode](https://developer.apple.com/download/more/)
   - free Apple Developer registration required, or install using `xcode-select --install`
+- [Python](https://www.python.org/downloads/) 3.7.0 or later
+  - ensure your Python installation has properly created `/Library/Frameworks/Python.framework/Versions/<version>`

 Additional dependencies (may be built via included script):

-- autoconf
-- automake
-- cmake (3.8.2 or later recommended)
-- libtool
+- autoconf 2.69 or later
+- automake 1.15 or later
+- cmake 3.1.0 or later
+- libtool 2.4.6 or later
+- meson 0.47.0 or later
 - nasm 2.13 or later
-- pkg-config
-- yasm 1.2.0 or later (1.3.0 or later recommended)
+- ninja 1.8.0 or later
+- pkg-config 0.29.0 or later

-Install Xcode[^xcode-install] and open it once. Approve any prompts to install additional tools. You may quit Xcode after it has finished loading.
+Install Xcode and open it once. Approve any prompts to install additional tools. You may quit Xcode after it has finished loading.

-Install Command Line Tools for Xcode[^xcode-cli-tools].
+Install Command Line Tools for Xcode using the package installer provided by Apple[^xcode-cli-tools], or using `xcode-select`.

     xcode-select --install

+Install Python 3 using the latest package installer provided by [Python](https://www.python.org/downloads/).
+
+If you installed Python 3 from a different source, such as Homebrew, it is necessary to check whether Python 3 can properly open HTTPS connections. The following test prints `0` for success, or `1` for failure. Upon failure, you will need to ensure SSL certificates are installed and accessible to your Python 3 installation, or remove the installation and reinstall from the official package.
+
+    python3 -c 'from urllib.request import urlopen; test = lambda x=exec("def f():\n try:\n  urlopen(\"https://handbrake.fr\", timeout=10)\n  return 0\n except:  return 1"): f(); result = test(); exit(result)'; echo $?
+
 Clone the HandBrake repository.

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

-List available tags in the HandBrake 1.2.x release series, and check out the most recent.
+List available tags in the HandBrake 1.3.x release series, and check out the most recent.

-    git tag --list | grep ^1\.2\.
-    git checkout refs/tags/$(git tag -l | grep -E '^1\.2\.[0-9]+$' | tail -n 1)
+    git tag --list | grep ^1\.3\.
+    git checkout refs/tags/$(git tag -l | grep -E '^1\.3\.[0-9]+$' | tail -n 1)

 You may build and install the additional dependencies using the included script. Feel free to choose a different output path, if desired.

@@ -56,7 +65,7 @@

 Build HandBrake. To build the command line interface only, disable the graphical interface by appending `--disable-xcode`.

-    ./configure --launch-jobs=$(sysctl -n hw.ncpu) --launch
+    ./configure --launch-jobs=$(sysctl -n hw.activecpu) --launch

 When complete, you will find `HandBrakeCLI` in the `build/xroot` directory. If the graphical interface is enabled, you will also find `HandBrake.app` in this directory.

@@ -68,10 +77,6 @@

     rm -rf build

-[^mojave-dark-mode]: HandBrake must be built on macOS 10.4 Mojave or later to enable Dark Mode toolbar icons. Building on earlier macOS, even with latest Xcode, will result in Light Mode toolbar icons being displayed in Dark Mode.
-
-[^xcode-install]: Make sure Xcode is installed at `/Applications/Xcode.app`. When using an Xcode Beta release, you may need to rename `Xcode-beta.app` to `Xcode.app`.
-
 [^xcode-cli-tools]: When installing Command Line Tools for Xcode using the package installer (instead of `xcode-select --install`), make sure to install the package that corresponds to the installed Xcode version. A mismatch between the installed Xcode and Command Line Tools versions may cause problems.

 [^default-path]: `/usr/local/bin` is included in the system's `PATH` by default. It is not necessary to add it to your environment's `PATH` when installing the additional dependencies to `/usr/local`.
diff -ur source/docs/en/1.2.0/developer/build-windows.markdown source/docs/en/1.3.0/developer/build-windows.markdown
--- source/docs/en/1.2.0/developer/build-windows.markdown   2019-11-09 17:18:25.000000000 -0500
+++ source/docs/en/1.3.0/developer/build-windows.markdown   2019-11-09 17:18:39.000000000 -0500
@@ -18,17 +18,60 @@

 ## Command line interface and LibHB

-Building the HandBrake [CLI](abbr:Command Line Interface) and LibHB (`hb.dll`) for Windows requires Linux and a recent [MinGW-w64](https://mingw-w64.org/) toolchain. Ubuntu 18.04 LTS (Bionic Beaver) is recommended; other distros may work as well. In all cases, we recommend you build the MinGW-w64 toolchain using our instructions and the included script, as most packaged versions have issues that can produce non-functioning builds.
+Building the HandBrake [CLI](abbr:Command Line Interface) and LibHB (`hb.dll`) for Windows requires Linux and a recent [MinGW-w64](https://mingw-w64.org/) toolchain. Fedora 28 or later, or Ubuntu 18.04 LTS (Bionic Beaver) or later are recommended; other distros may work as well. In all cases, we recommend you build the MinGW-w64 toolchain using our instructions and the included script, as some packaged versions have issues that can produce non-functioning builds.

-The following instructions are for Ubuntu 18.04 LTS (Bionic Beaver).
+### Installing dependencies on Fedora
+
+The following instructions are for [Fedora](https://getfedora.org) 28 through 30.
+
+Basic requirements to run commands:
+
+- sudo (for normal user accounts)
+
+Dependencies:
+
+- Development Tools
+- C Development Tools and Libraries
+- cmake
+- gcc-c++
+- git
+- libtool
+- m4
+- make
+- meson
+- nasm
+- ninja-build
+- patch
+- python
+- tar
+- zlib-devel
+
+Install dependencies.
+
+    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
+
+Install the additional dependencies required to build the MinGW-w64 toolchain.
+
+    sudo dnf install bison bzip2 curl flex g++ gzip pax
+
+
+### Installing dependencies on Ubuntu
+
+The following instructions are for [Ubuntu](https://www.ubuntu.com) 18.04 LTS (Bionic Beaver) through 19.10 (Eoan Ermine).
+
+Basic requirements to run commands:
+
+- sudo (for normal user accounts)

 Dependencies:

 - autoconf
 - automake
+- autopoint
 - build-essential
 - cmake
-- curl
 - gcc
 - git
 - libtool
@@ -36,17 +79,27 @@
 - m4
 - make
 - nasm
+- ninja-build
 - patch
 - pkg-config
 - python
 - tar
-- yasm
 - zlib1g-dev

+Additional dependencies for Ubuntu 18.10 and later:
+
+- meson
+
+Additional Ubuntu 18.04 LTS dependencies:
+
+- python3-pip
+- meson (via pip3)
+
 Additional MinGW-w64 toolchain dependencies:

 - bison
 - bzip2
+- curl
 - flex
 - g++
 - gzip
@@ -55,20 +108,32 @@
 Install dependencies.

     sudo apt-get update
-    sudo apt-get install automake autoconf build-essential cmake curl gcc git intltool libtool libtool-bin m4 make nasm patch pkg-config python tar yasm zlib1g-dev
+    sudo apt-get install automake autoconf autopoint build-essential cmake gcc git intltool libtool libtool-bin m4 make nasm patch pkg-config python tar zlib1g-dev
+
+If you are running Ubuntu 18.10 or later, install the additional dependencies.
+
+    sudo apt-get install meson
+
+If you are running Ubuntu 18.04 LTS, the `meson` package is too old. Install a newer version provided by the [Python Package Index](https://pypi.org/).
+
+    sudo apt-get install python3-pip
+    sudo pip3 install meson

 Install the additional dependencies required to build the MinGW-w64 toolchain.

-    sudo apt-get install bison bzip2 flex g++ gzip pax
+    sudo apt-get install bison bzip2 curl flex g++ gzip pax
+
+
+### Building the MinGW-w64 toolchain and HandBrake

 Clone the HandBrake repository.

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

-List available tags in the HandBrake 1.2.x release series, and check out the most recent.
+List available tags in the HandBrake 1.3.x release series, and check out the most recent.

-    git tag --list | grep ^1\.2\.
-    git checkout refs/tags/$(git tag -l | grep -E '^1\.2\.[0-9]+$' | tail -n 1)
+    git tag --list | grep ^1\.3\.
+    git checkout refs/tags/$(git tag -l | grep -E '^1\.3\.[0-9]+$' | tail -n 1)

 Build the MinGW-w64 toolchain using the included script, where `username` is your user name. Feel free to choose a different output path, if desired.

@@ -78,7 +143,7 @@

 Build HandBrake. For higher quality audio, enable the FDK AAC encoder by appending `--enable-fdk-aac`. Builds including FDK AAC must be for personal use only and may not be distributed.[^fdk-aac-license]

-    ./configure --cross=x86_64-w64-mingw32 --enable-qsv --enable-vce --enable-nvenc --launch-jobs=$(nproc) --launch
+    ./configure --cross=x86_64-w64-mingw32 --launch-jobs=$(nproc) --launch

 When complete, you will find `HandBrakeCLI.exe` in the `build` directory and `hb.dll` in `build/libhb`.

@@ -100,7 +165,7 @@
   - Highly recommended for developers interested in working on the Windows UI
   - Active, regular contributors may request a free for open source ReSharper license from the HandBrake Team, courtesy JetBrains

-Clone `https://github.com/HandBrake/HandBrake.git` using your git client.
+Clone `https://github.com/HandBrake/HandBrake.git` using your git client, and check out the most recent tag in the 1.3.x release series.

 Source code for the GUI resides in the `win\CS` folder and the solution file is named `HandBrake.sln`. Make sure HandBrakeWPF is set as the startup project in the Solution Explorer by right-clicking the name and selecting "Set as startup project".

diff -ur source/docs/en/1.2.0/developer/flatpak-repo.markdown source/docs/en/1.3.0/developer/flatpak-repo.markdown
--- source/docs/en/1.2.0/developer/flatpak-repo.markdown    2019-11-09 17:18:25.000000000 -0500
+++ source/docs/en/1.3.0/developer/flatpak-repo.markdown    2019-11-09 17:18:39.000000000 -0500
@@ -17,6 +17,7 @@
 =================================================

 ## Install dependencies
+
 Install flatpak and flatpak-builder

     sudo dnf install flatpak flatpak-builder
@@ -27,19 +28,22 @@

 Install flatpak freedesktop SDK.

-    flatpak install flathub org.freedesktop.Sdk//1.6
+    flatpak install flathub org.freedesktop.Sdk//18.08

 Install flatpak freedesktop runtime platform.

-    flatpak install flathub org.freedesktop.Platform//1.6
+    flatpak install flathub org.freedesktop.Platform//18.08

 ## Create a new HandBrake flatpak bundle
-This may be done on a different machine than the repo.

 From the HandBrake source tree, update build versions by running configure

     ./configure --flatpak

+Or to build HandBrake with Quick Sync Video support and HandBrake's Intel MediaSDK flatpak plugin
+
+    ./configure --flatpak --enable-qsv
+
 Build signed flatpak packages for GUI and CLI.

     cd build
@@ -61,11 +65,13 @@
 If PGP_ID is omitted, the OSTree commit will be unsigned.

 ## Install flatpak bundle
+
 To use the flatpak bundle directly instead of importing it into a repository and then installing from the repository:

     flatpak install <flatpak-bundle>

 ## Add OSTree repo to flatpak repo list (Optional)
+
 This is only for test purposes currently.  Ultimately, we might want to establish an "official" repo location that we publish new bundles to.  Currently, the repo is just a product of the build and is not meant to be reused across builds.

 Add the new repository to your flatpak remotes
@@ -77,6 +83,7 @@
     flatpak --user remote-add --no-gpg-verify <repo-name> <repo-dir>

 ## Check repo and application (Optional)
+
 List contents of the repo

     flatpak --user remote-ls <repo-name>
@@ -86,6 +93,7 @@
     flatpak --user install <repo-name> <app-name>

 # Maintaining a separate OSTree repository
+
 There are situations where you don't want to keep your repository on the same server as you built the flatpak on.  Rather than exporting the entire repo-dir that is built by flatpak-builder, you can import your bundles into a seperate OSTree repository.

 ## Create a new empty repository
@@ -95,6 +103,7 @@
 \```

 ## Add flatpakrepo file to the repository
+
 This file is used by flatpak clients to add your repoitory to their list of remotes.

 Create a file named \<yourproject\>.flatpakrepo in \<repo-dir\>.  The format looks like this:
@@ -132,6 +141,7 @@
 \```

 ## Host your repository with a web server
+
 For test purposes, I just use pythons builtin web server.

 \```
@@ -141,9 +151,9 @@
 Note, requires python 3.7 or above.

 ## Publish the location of \<yourproject\>.flatpakrepo
+
 Users can add your repository to their list of remotes with:

 \```
 flatpak remote-add --if-not-exists yourproject https://dl.yourproject.org:8080/repo/yourproject.flatpakrepo
 \```
-
diff -ur source/docs/en/1.2.0/developer/install-dependencies-arch.markdown source/docs/en/1.3.0/developer/install-dependencies-arch.markdown
--- source/docs/en/1.2.0/developer/install-dependencies-arch.markdown   2019-11-09 17:18:24.000000000 -0500
+++ source/docs/en/1.3.0/developer/install-dependencies-arch.markdown   2019-11-09 17:18:39.000000000 -0500
@@ -16,7 +16,7 @@
 Installing dependencies on Arch
 ===============================

-The following instructions are for [Arch](https://www.archlinux.org) 2018.05.01 (HandBrake [CLI](abbr:Command Line Interface) only).
+The following instructions are for [Arch](https://www.archlinux.org) 2019.09.01.

 Basic requirements to run commands:

@@ -42,17 +42,43 @@
 - libvorbis
 - libvpx
 - libxml2
+- meson
 - nasm
+- ninja
+- numactl
 - opus
 - python2
 - speex
 - x264
 - x265
 - xz
-- yasm
+
+Graphical interface dependencies:
+
+- dbus-glib
+- gstreamer
+- gst-libav
+- gst-plugins-base
+- intltool
+- libgudev
+- libnotify
+- webkit2gtk
+
+Intel Quick Sync Video dependencies (optional):
+
+- libva
+- libdrm

 Install dependencies.

-    sudo pacman -S base-devel cmake flac fontconfig freetype2 fribidi git harfbuzz jansson lame libass libbluray libogg libsamplerate libtheora libvorbis libvpx libxml2 nasm opus python2 speex x264 x265 xz yasm
+    sudo pacman -S base-devel cmake flac fontconfig freetype2 fribidi git harfbuzz jansson lame libass libbluray libogg libsamplerate libtheora libvorbis libvpx libxml2 meson nasm ninja numactl opus python2 speex x264 x265 xz
+
+To build the GTK [GUI](abbr:Graphical User Interface), install the graphical interface dependencies. Requires the GNOME desktop and associated packages, e.g. installed using `pacman -S xorg xorg-server && pacman -S gnome gnome-extra`.
+
+    sudo pacman -S dbus-glib gstreamer gst-libav gst-plugins-base intltool libgudev libnotify webkit2gtk
+
+To build with Intel Quick Sync Video support, install the QSV dependencies.
+
+    sudo pacman -S libva libdrm

 Arch is now prepared to build HandBrake. See [Building HandBrake for Linux](build-linux.html) for further instructions.
diff -ur source/docs/en/1.2.0/developer/install-dependencies-centos.markdown source/docs/en/1.3.0/developer/install-dependencies-centos.markdown
--- source/docs/en/1.2.0/developer/install-dependencies-centos.markdown 2019-11-09 17:18:25.000000000 -0500
+++ source/docs/en/1.3.0/developer/install-dependencies-centos.markdown 2019-11-09 17:18:39.000000000 -0500
@@ -16,9 +16,96 @@
 Installing dependencies on CentOS
 =================================

+## CentOS 8
+
+The following instructions are for [CentOS](https://centos.org) 8.0.
+
+Basic requirements to run commands:
+
+- curl
+- sudo (for normal user accounts)
+
+Dependencies:
+
+- Development Tools
+- cmake
+- fribidi-devel
+- git
+- jansson-devel
+- numactl-devel
+- python3
+- xz-devel
+
+Additional dependencies not available in the base repository:
+
+- lame-devel [PowerTools]
+- libass-devel [EPEL]
+- libogg-devel [PowerTools]
+- libsamplerate-devel [PowerTools]
+- libtheora-devel [PowerTools]
+- libvorbis-devel [PowerTools]
+- libvpx-devel [PowerTools]
+- meson [PowerTools]
+- nasm [PowerTools]
+- ninja-build [PowerTools]
+- opus-devel [PowerTools]
+- speex-devel [PowerTools]
+- x264-devel [RPM Fusion]
+
+Graphical interface dependencies:
+
+- dbus-glib-devel
+- gstreamer1-devel
+- gstreamer1-plugins-base-devel
+- intltool
+- libnotify-devel
+- webkit2gtk3-devel
+
+Additional graphical interface dependencies not available in the base repository:
+
+- gstreamer1-libav [RPM Fusion]
+- libgudev1-devel [PowerTools]
+
+Intel Quick Sync Video dependencies (optional):
+
+- libva-devel
+- libdrm-devel
+
+Install dependencies.
+
+    sudo dnf update
+    sudo dnf groupinstall "Development Tools"
+    sudo dnf install cmake fribidi-devel git jansson-devel numactl-devel python3 opus-devel xz-devel
+
+Enable the CentOS PowerTools repository and install related additional dependencies.
+
+    sudo dnf config-manager --set-enabled PowerTools
+    sudo dnf install lame-devel libogg-devel libsamplerate-devel libtheora-devel libvorbis-devel meson nasm ninja-build opus-devel speex-devel
+
+Install the [EPEL](https://fedoraproject.org/wiki/EPEL) repository and related additional dependencies.
+
+    sudo dnf install epel-release
+    sudo dnf install libass-devel
+
+Install the [RPM Fusion](http://rpmfusion.org) Free repository and related additional dependencies.
+
+    sudo dnf localinstall --nogpgcheck https://download1.rpmfusion.org/free/el/rpmfusion-free-release-8.noarch.rpm
+    sudo dnf install x264-devel
+
+To build the GTK [GUI](abbr:Graphical User Interface), install the graphical interface dependencies.
+
+    sudo dnf install dbus-glib-devel gstreamer1-devel gstreamer1-libav gstreamer1-plugins-base-devel intltool libgudev1-devel libnotify-devel webkit2gtk3-devel
+
+To build with Intel Quick Sync Video support, install the QSV dependencies.
+
+    sudo dnf install libva-devel libdrm-devel
+
+CentOS is now prepared to build HandBrake. See [Building HandBrake for Linux](build-linux.html) for further instructions.
+
+
 ## CentOS 7

-The following instructions are for [CentOS](https://centos.org) 7.6 x86_64.
+The following instructions are for [CentOS](https://centos.org) 7.7.

 Basic requirements to run commands:

@@ -28,7 +115,6 @@
 Dependencies:

 - Development Tools
-- Additional Development
 - fribidi-devel
 - git
 - jansson-devel
@@ -36,6 +122,8 @@
 - libsamplerate-devel
 - libtheora-devel
 - libvorbis-devel
+- numactl-devel
+- python3
 - speex-devel
 - xz-devel

@@ -44,10 +132,12 @@
 - devtoolset-7 [SCL] (optional/recommended for HandBrake [CLI](abbr:Command Line Interface))
 - lame-devel [RPM Fusion]
 - libass-devel [EPEL]
+- libvpx
+- meson [EPEL]
 - nasm [NASM]
+- ninja-build [EPEL]
 - opus-devel [EPEL EL6]
 - x264-devel [RPM Fusion]
-- yasm [EPEL]

 Graphical interface dependencies:

@@ -64,16 +154,21 @@
 - devtoolset-7 [SCL]
 - gstreamer1-libav [RPM Fusion]

+Intel Quick Sync Video dependencies (optional):
+
+- libva-devel
+- libdrm-devel
+
 Install dependencies.

     sudo yum update
-    sudo yum groupinstall "Development Tools" "Additional Development"
-    sudo yum install fribidi-devel git jansson-devel libogg-devel libsamplerate-devel libtheora-devel libvorbis-devel opus-devel speex-devel xz-devel
+    sudo yum groupinstall "Development Tools"
+    sudo yum install fribidi-devel git jansson-devel libogg-devel libsamplerate-devel libtheora-devel libvorbis-devel numactl-devel python3 opus-devel speex-devel xz-devel

 Install the [EPEL](https://fedoraproject.org/wiki/EPEL) repository and related additional dependencies.

     sudo yum install epel-release
-    sudo yum install libass-devel yasm
+    sudo yum install libass-devel meson ninja-build

 The `opus-devel` package provided by CentOS 7 is too old. Install a newer version provided by EPEL for CentOS 6[^opus-el6].

@@ -84,6 +179,30 @@
     sudo curl -L 'https://nasm.us/nasm.repo' -o /etc/yum.repos.d/nasm.repo
     sudo yum install nasm

+The `libvpx-devel` package provided by CentOS 7 is too old. Build and install a newer version from source[^libvpx-source].
+
+    # remove old package if installed
+    sudo yum remove libvpx-devel
+
+    # libvpx
+    curl -L https://github.com/webmproject/libvpx/archive/v1.8.1.tar.gz -o libvpx-1.8.1.tar.gz
+    tar -xf libvpx-1.8.1.tar.gz
+    cd libvpx-1.8.1
+    ./configure --enable-shared --enable-static --as=nasm --enable-pic --enable-runtime-cpu-detect --enable-vp8 --enable-vp9
+    make -j$(nproc)
+    sudo make install
+    ..
+
+    # make shared libraries findable
+    export CFLAGS="${CFLAGS:-} -I/usr/local/include"
+    export LDFLAGS="${LDFLAGS:-} -L/usr/local/lib"
+    echo 'export CFLAGS="${CFLAGS:-} -I/usr/local/include"' >> "${HOME}/.bashrc"
+    echo 'export LDFLAGS="${LDFLAGS:-} -L/usr/local/lib"' >> "${HOME}/.bashrc"
+    if ! grep '\/usr\/local\/lib' /etc/ld.so.conf >/dev/null 2>&1; then
+        echo '/usr/local/lib' | sudo tee --append /etc/ld.so.conf
+        sudo ldconfig
+    fi
+
 The `lame-devel` and `x264-devel` packages are now provided by the RPM Fusion repository. If you previously installed the [ZMREPO](https://zmrepo.zoneminder.com) repository for these packages, remove them and the repository before continuing.

     # Only necessary if previously installed ZMREPO
@@ -95,20 +214,32 @@
     sudo yum localinstall --nogpgcheck https://download1.rpmfusion.org/free/el/rpmfusion-free-release-7.noarch.rpm
     sudo yum install lame-devel x264-devel

+To build the GTK [GUI](abbr:Graphical User Interface), install the graphical interface dependencies.
+
+    sudo yum install dbus-glib-devel gstreamer1-devel gstreamer1-libav gstreamer1-plugins-base-devel intltool libgudev1-devel libnotify-devel webkitgtk4-devel
+
+To build with Intel Quick Sync Video support, install the QSV dependencies.
+
+    sudo yum install libva-devel libdrm-devel
+
 The GNU Compiler Collection and related packages provided by CentOS 7 are old. Install and enable a newer version provided by Software Collections (SCL)[^gcc-scl]. This is recommended for building the HandBrake [CLI](abbr:Command Line Interface) and required for building the GTK [GUI](abbr:Graphical User Interface).

     sudo yum install centos-release-scl
     sudo yum install devtoolset-7
     sudo scl enable devtoolset-7 bash  # launches a bash session with the appropriate tools enabled

-To build the GTK [GUI](abbr:Graphical User Interface), install the graphical interface dependencies.
-
-    sudo yum install dbus-glib-devel gstreamer1-devel gstreamer1-libav gstreamer1-plugins-base-devel intltool libgudev1-devel libnotify-devel webkitgtk4-devel
+    # make shared libraries findable by root
+    export CFLAGS="${CFLAGS:-} -I/usr/local/include"
+    export LDFLAGS="${LDFLAGS:-} -L/usr/local/lib"
+    echo 'export CFLAGS="${CFLAGS:-} -I/usr/local/include"' >> "${HOME}/.bashrc"
+    echo 'export LDFLAGS="${LDFLAGS:-} -L/usr/local/lib"' >> "${HOME}/.bashrc"

-CentOS is now prepared to build the HandBrake [CLI](abbr:Command Line Interface). See [Building HandBrake for Linux](build-linux.html) for further instructions.
+CentOS is now prepared to build HandBrake. See [Building HandBrake for Linux](build-linux.html) for further instructions.

 [^opus-el6]: Installing newer packages than those available in the base repository may lead to incompatibility with other software expecting specific package versions.

 [^nasm-repo]: Installing newer packages than those available in the base repository may lead to incompatibility with other software expecting specific package versions.

-[^gcc-scl]: SCL packages are isolated from base repository versions of similar packages. You can enable these packages using the `scl` command line tool. When you are finished using these packages, simply log out of the active shell. New sessions will use the packages provided by the base repository.
+[^libvpx-source]: Installing newer packages than those available in the base repository may lead to incompatibility with other software expecting specific package versions.
+
+[^gcc-scl]: SCL packages are isolated from base repository versions of similar packages. You can enable these packages using the `scl` command line tool. When you are finished using these packages, simply log out of the active shell to resume using packages provided by the base repository.
Only in source/docs/en/1.3.0/developer: install-dependencies-clear.markdown
diff -ur source/docs/en/1.2.0/developer/install-dependencies-debian.markdown source/docs/en/1.3.0/developer/install-dependencies-debian.markdown
--- source/docs/en/1.2.0/developer/install-dependencies-debian.markdown 2019-11-09 17:18:25.000000000 -0500
+++ source/docs/en/1.3.0/developer/install-dependencies-debian.markdown 2019-11-09 17:18:39.000000000 -0500
@@ -16,7 +16,7 @@
 Installing dependencies on Debian
 =================================

-The following instructions are for [Debian](https://www.debian.org) 9.4 (Stretch) x86_64.
+The following instructions are for [Debian](https://www.debian.org) 9.11 Stretch through 10.1 Buster.

 Basic requirements to run commands:

@@ -39,6 +39,7 @@
 - libjansson-dev
 - liblzma-dev
 - libmp3lame-dev
+- libnuma-dev
 - libogg-dev
 - libopus-dev
 - libsamplerate-dev
@@ -49,18 +50,25 @@
 - libvorbis-dev
 - libx264-dev
 - libxml2-dev
+- libvpx-dev
 - m4
 - make
+- ninja-build
 - patch
 - pkg-config
 - python
 - tar
-- yasm
 - zlib1g-dev

-Additional dependencies not available in the base repository:
+Additional Debian 10 dependencies:

-- nasm [Debian sid]
+- meson
+- nasm
+
+Additional Debian 9 dependencies not available in the base repository:
+
+- meson [backports]
+- nasm [sid]

 Graphical interface dependencies:

@@ -73,21 +81,41 @@
 - libgtk-3-dev
 - libgudev-1.0-dev
 - libnotify-dev
-- libwebkitgtk-3.0-dev
+- libwebkit2gtk-4.0-dev (libwebkitgtk-3.0-dev for Debian 9)
+
+Intel Quick Sync Video dependencies (optional):
+
+- libva-dev
+- libdrm-dev

 Install dependencies.

     sudo apt-get update
-    sudo apt-get install autoconf automake build-essential cmake git libass-dev libbz2-dev libfontconfig1-dev libfreetype6-dev libfribidi-dev libharfbuzz-dev libjansson-dev liblzma-dev libmp3lame-dev libogg-dev libopus-dev libsamplerate-dev libspeex-dev libtheora-dev libtool libtool-bin libvorbis-dev libx264-dev libxml2-dev m4 make patch pkg-config python tar yasm zlib1g-dev
+    sudo apt-get install autoconf automake build-essential cmake git libass-dev libbz2-dev libfontconfig1-dev libfreetype6-dev libfribidi-dev libharfbuzz-dev libjansson-dev liblzma-dev libmp3lame-dev libnuma-dev libogg-dev libopus-dev libsamplerate-dev libspeex-dev libtheora-dev libtool libtool-bin libvorbis-dev libx264-dev libxml2-dev libvpx-dev m4 make ninja-build patch pkg-config python tar zlib1g-dev
+
+If you are running Debian 10, install the additional dependencies.
+
+    sudo apt-get install meson nasm

-The `nasm` package provided by Debian 9 is too old. Install a newer version provided by Debian sid (unstable/development distribution)[^nasm-sid].
+If you are running Debian 9, the `meson` package is too old. Install a newer version provided by the backports repository.
+
+    sudo add-apt-repository -s 'deb http://deb.debian.org/debian stretch-backports main'
+    sudo apt-get update
+    sudo apt-get -t stretch-backports install meson
+
+If you are running Debian 9, the `nasm` package is too old. Install a newer version provided by Debian sid (unstable/development distribution)[^nasm-sid].

     sudo curl -L 'http://ftp.debian.org/debian/pool/main/n/nasm/nasm_2.13.03-1_amd64.deb' -o /var/cache/apt/archives/nasm_2.13.03-1_amd64.deb
     sudo dpkg -i /var/cache/apt/archives/nasm_2.13.03-1_amd64.deb

 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
+    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
+    sudo apt-get install libwebkit2gtk-4.0-dev || sudo apt-get install libwebkitgtk-3.0-dev
+
+To build with Intel Quick Sync Video support, install the QSV dependencies.
+
+    sudo apt-get install libva-dev libdrm-dev

 Debian is now prepared to build HandBrake. See [Building HandBrake for Linux](build-linux.html) for further instructions.

diff -ur source/docs/en/1.2.0/developer/install-dependencies-fedora.markdown source/docs/en/1.3.0/developer/install-dependencies-fedora.markdown
--- source/docs/en/1.2.0/developer/install-dependencies-fedora.markdown 2019-11-09 17:18:25.000000000 -0500
+++ source/docs/en/1.3.0/developer/install-dependencies-fedora.markdown 2019-11-09 17:18:39.000000000 -0500
@@ -16,7 +16,7 @@
 Installing dependencies on Fedora
 =================================

-The following instructions are for [Fedora](https://getfedora.org) 26 Workstation and later.
+The following instructions are for [Fedora](https://getfedora.org) 28 through 30.

 Basic requirements to run commands:

@@ -25,7 +25,7 @@
 Dependencies:

 - Development Tools
-- Development Libraries
+- C Development Tools and Libraries
 - bzip2-devel
 - cmake
 - fontconfig-devel
@@ -44,16 +44,19 @@
 - libtool
 - libvorbis-devel
 - libxml2-devel
+- libvpx-devel
 - m4
 - make
+- meson
 - nasm
+- ninja-build
+- numactl-devel
 - opus-devel
 - patch
 - python
 - speex-devel
 - tar
 - xz-devel
-- yasm
 - zlib-devel

 Additional dependencies not available in the base repository:
@@ -71,23 +74,31 @@
 - intltool
 - libgudev1-devel
 - libnotify-devel
-- webkit2gtk3-devel (webkitgtk4-devel for Fedora 27, webkitgtk3-devel for Fedora 26)
+- webkit2gtk3-devel
+
+Intel Quick Sync Video dependencies (optional):
+
+- libva-devel
+- libdrm-devel

 Install dependencies.

-    sudo yum update
-    sudo yum groupinstall "Development Tools" "Development Libraries"
-    sudo yum install bzip2-devel cmake fontconfig-devel freetype-devel fribidi-devel gcc-c++ git harfbuzz-devel jansson-devel lame-devel lbzip2 libass-devel libogg-devel libsamplerate-devel libtheora-devel libtool libvorbis-devel libxml2-devel m4 make nasm opus-devel patch python speex-devel tar xz-devel yasm zlib-devel
+    sudo dnf update
+    sudo dnf groupinstall "Development Tools" "C Development Tools and Libraries"
+    sudo dnf install bzip2-devel cmake fontconfig-devel freetype-devel fribidi-devel gcc-c++ git harfbuzz-devel jansson-devel lame-devel lbzip2 libass-devel libogg-devel libsamplerate-devel libtheora-devel libtool libvorbis-devel libxml2-devel libvpx-devel m4 make meson nasm ninja-build numactl-devel opus-devel patch python speex-devel tar xz-devel zlib-devel

 Install the [RPM Fusion](http://rpmfusion.org) Free repository and related additional dependencies.

-    sudo yum localinstall --nogpgcheck https://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-$(cat /etc/system-release | awk '{ print $3}').noarch.rpm
-    sudo yum install x264-devel
+    sudo dnf localinstall --nogpgcheck https://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-$(cat /etc/system-release | awk '{ print $3}').noarch.rpm
+    sudo dnf install x264-devel

 To build the GTK [GUI](abbr:Graphical User Interface), install the graphical interface dependencies.

-    sudo yum groupinstall "X Software Development" "GNOME Software Development"
-    sudo yum install dbus-glib-devel gstreamer1-devel gstreamer1-libav gstreamer1-plugins-base-devel intltool libgudev1-devel libnotify-devel
-    sudo yum install webkit2gtk3-devel || sudo yum install webkitgtk4-devel || sudo yum install webkitgtk3-devel
+    sudo dnf groupinstall "X Software Development" "GNOME Software Development"
+    sudo dnf install dbus-glib-devel gstreamer1-devel gstreamer1-libav gstreamer1-plugins-base-devel intltool libgudev1-devel libnotify-devel webkit2gtk3-devel
+
+To build with Intel Quick Sync Video support, install the QSV dependencies.
+
+    sudo dnf install libva-devel libdrm-devel

 Fedora is now prepared to build HandBrake. See [Building HandBrake for Linux](build-linux.html) for further instructions.
diff -ur source/docs/en/1.2.0/developer/install-dependencies-freebsd.markdown source/docs/en/1.3.0/developer/install-dependencies-freebsd.markdown
--- source/docs/en/1.2.0/developer/install-dependencies-freebsd.markdown    2019-11-09 17:18:24.000000000 -0500
+++ source/docs/en/1.3.0/developer/install-dependencies-freebsd.markdown    2019-11-09 17:18:39.000000000 -0500
@@ -16,7 +16,7 @@
 Installing dependencies on FreeBSD
 ==================================

-The following instructions are for [FreeBSD](https://www.freebsd.org) 11.1 x86_64.
+The following instructions are for [FreeBSD](https://www.freebsd.org) 11 and 12.

 Basic requirements to run commands:

@@ -49,15 +49,17 @@
 - libtheora
 - libtool
 - libvorbis
+- libvpx
 - libx264
 - libxml2
 - lzma
+- meson
 - nasm
+- ninja
 - opus
 - pkgconf
 - python
 - speex
-- yasm

 Graphical interface dependencies:

@@ -80,7 +82,7 @@

 Install dependencies.

-    sudo pkg install autoconf automake bash bzip2 cmake flac fontconfig freetype2 fribidi git gcc lzma m4 gmake patch gtar harfbuzz jansson libass libiconv libogg libsamplerate libtheora libtool libvorbis libx264 libxml2 nasm opus pkgconf python speex yasm
+    sudo pkg install autoconf automake bash bzip2 cmake flac fontconfig freetype2 fribidi git gcc lzma m4 gmake patch gtar harfbuzz jansson libass libiconv libogg libsamplerate libtheora libtool libvorbis libvpx libx264 libxml2 meson nasm ninja opus pkgconf python speex

 Build and install the `lame` source port.

@@ -89,8 +91,8 @@
     sudo portsnap update
     LASTDIR="`pwd`"
     cd /usr/ports/audio/lame
-    sudo make install
-    cd "LASTDIR"
+    sudo make install || sudo make reinstall
+    cd "$LASTDIR"

 To build the GTK [GUI](abbr:Graphical User Interface), install the graphical interface dependencies.

diff -ur source/docs/en/1.2.0/developer/install-dependencies-gentoo.markdown source/docs/en/1.3.0/developer/install-dependencies-gentoo.markdown
--- source/docs/en/1.2.0/developer/install-dependencies-gentoo.markdown 2019-11-09 17:18:25.000000000 -0500
+++ source/docs/en/1.3.0/developer/install-dependencies-gentoo.markdown 2019-11-09 17:18:39.000000000 -0500
@@ -16,7 +16,7 @@
 Installing dependencies on Gentoo
 =================================

-The following instructions are for [Gentoo](https://gentoo.org) profile `default/linux/amd64/17.0` with Portage snapshot 20180520 (HandBrake [CLI](abbr:Command Line Interface) only).
+The following instructions are for [Gentoo](https://gentoo.org) profile `default/linux/amd64/17.1` with Portage snapshot 20190915 (HandBrake [CLI](abbr:Command Line Interface) only).

 Basic requirements to run commands:

@@ -34,15 +34,19 @@
 - libsamplerate
 - libtheora
 - libvorbis
+- libvpx
 - app-arch/lzma
+- meson
 - nasm
+- ninja
+- numactl
 - opus
 - speex
 - x264

 Install dependencies.

-    sudo emerge --ask fribidi dev-vcs/git harfbuzz jansson lame libass libogg libsamplerate libtheora libvorbis app-arch/lzma nasm opus speex x264
+    sudo emerge --ask fribidi dev-vcs/git harfbuzz jansson lame libass libogg libsamplerate libtheora libvorbis libvpx app-arch/lzma meson nasm ninja numactl opus speex x264

 Gentoo is now prepared to build HandBrake. See [Building HandBrake for Linux](build-linux.html) for further instructions.

diff -ur source/docs/en/1.2.0/developer/install-dependencies-ubuntu.markdown source/docs/en/1.3.0/developer/install-dependencies-ubuntu.markdown
--- source/docs/en/1.2.0/developer/install-dependencies-ubuntu.markdown 2019-11-09 17:18:24.000000000 -0500
+++ source/docs/en/1.3.0/developer/install-dependencies-ubuntu.markdown 2019-11-09 17:18:39.000000000 -0500
@@ -16,7 +16,7 @@
 Installing dependencies on Ubuntu
 =================================

-The following instructions are for [Ubuntu](https://www.ubuntu.com) 18.04 LTS (Bionic Beaver).
+The following instructions are for [Ubuntu](https://www.ubuntu.com) 18.04 LTS (Bionic Beaver) through 19.10 (Eoan Ermine).

 Basic requirements to run commands:

@@ -26,6 +26,7 @@

 - autoconf
 - automake
+- autopoint
 - build-essential
 - cmake
 - git
@@ -38,6 +39,7 @@
 - libjansson-dev
 - liblzma-dev
 - libmp3lame-dev
+- libnuma-dev
 - libogg-dev
 - libopus-dev
 - libsamplerate-dev
@@ -48,16 +50,26 @@
 - libvorbis-dev
 - libx264-dev
 - libxml2-dev
+- libvpx-dev
 - m4
 - make
 - nasm
+- ninja-build
 - patch
 - pkg-config
 - python
 - tar
-- yasm
 - zlib1g-dev

+Additional dependencies for Ubuntu 18.10 and later:
+
+- meson
+
+Additional Ubuntu 18.04 LTS dependencies:
+
+- python3-pip
+- meson (via pip3)
+
 Graphical interface dependencies:

 - gstreamer1.0-libav
@@ -70,15 +82,33 @@
 - libgtk-3-dev
 - libgudev-1.0-dev
 - libnotify-dev
-- libwebkitgtk-3.0-dev
+- libwebkit2gtk-4.0-dev
+
+Intel Quick Sync Video dependencies (optional):
+
+- libva-dev
+- libdrm-dev

 Install dependencies.

     sudo apt-get update
-    sudo apt-get install autoconf automake build-essential cmake git libass-dev libbz2-dev libfontconfig1-dev libfreetype6-dev libfribidi-dev libharfbuzz-dev libjansson-dev liblzma-dev libmp3lame-dev libogg-dev libopus-dev libsamplerate-dev libspeex-dev libtheora-dev libtool libtool-bin libvorbis-dev libx264-dev libxml2-dev m4 make nasm patch pkg-config python tar yasm zlib1g-dev
+    sudo apt-get install autoconf automake autopoint build-essential cmake git libass-dev libbz2-dev libfontconfig1-dev libfreetype6-dev libfribidi-dev libharfbuzz-dev libjansson-dev liblzma-dev libmp3lame-dev libnuma-dev libogg-dev libopus-dev libsamplerate-dev libspeex-dev libtheora-dev libtool libtool-bin libvorbis-dev libx264-dev libxml2-dev libvpx-dev m4 make nasm ninja-build patch pkg-config python tar zlib1g-dev
+
+If you are running Ubuntu 18.10 or later, install the additional dependencies.
+
+    sudo apt-get install meson
+
+If you are running Ubuntu 18.04 LTS, the `meson` package is too old. Install a newer version provided by the [Python Package Index](https://pypi.org/).
+
+    sudo apt-get install python3-pip
+    sudo pip3 install meson

 To build the GTK [GUI](abbr:Graphical User Interface), install the graphical interface dependencies.

-    sudo apt-get install gstreamer1.0-libav 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
+    sudo apt-get install gstreamer1.0-libav 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 libwebkit2gtk-4.0-dev
+
+To build with Intel Quick Sync Video support, install the QSV dependencies.
+
+    sudo apt-get install libva-dev libdrm-dev

 Ubuntu is now prepared to build HandBrake. See [Building HandBrake for Linux](build-linux.html) for further instructions.
diff -ur source/docs/en/1.2.0/get-handbrake/download-and-install.markdown source/docs/en/1.3.0/get-handbrake/download-and-install.markdown
--- source/docs/en/1.2.0/get-handbrake/download-and-install.markdown    2019-11-09 17:18:24.000000000 -0500
+++ source/docs/en/1.3.0/get-handbrake/download-and-install.markdown    2019-11-09 17:18:39.000000000 -0500
@@ -128,6 +128,22 @@

 HandBrake is now installed. You may eject the disk image and move it to the Trash.

+### Mac Gatekeeper
+
+The first time you attempt to launch HandBrake, your Mac may present this message to you[^gatekeeper-disabled]:
+
+![Mac Gatekeeper message](../../images/mac/gatekeeper-message-1.1.0.png "Gatekeeper may present this message when launching HandBrake for the first time.")
+
+This message doesn't mean anything is wrong; rather, it indicates that HandBrake is not part of Apple's paid program to validate Mac applications. Select `OK` to dismiss the Gatekeeper message.
+
+Hold down the `Control` key and select the HandBrake icon to bring up the shortcut menu. Select `Open` and your Mac will ask whether you are certain you wish to open HandBrake. Confirm that you want to trust HandBrake by again selecting `Open`.[^gatekeeper-instructions]
+
+![Opening HandBrake using Finder's shortcut menu](../../images/mac/shortcut-menu-open-1.1.0.png "Launching HandBrake using the Open option in the Finder's shortcut menu will bypass the initial Gatekeeper message.")
+
+![Gatekeeper message with Open option](../../images/mac/gatekeeper-message-quarantine-1.1.0.png "Gatekeeper may also present this message when launching HandBrake for the first time. Selecting Open will tell Gatekeeper to trust HandBrake.")
+
+Now HandBrake is up and running. You should not have to repeat this process in the near future.
+
 <!-- /.system-macos -->
 <!-- .system-windows -->

@@ -186,3 +202,7 @@
 [^third-party-utilities-1]: HandBrake is not associated with any third-party checksum utilities. Only use software from vendors you trust.

 [^third-party-utilities-2]: HandBrake is not associated with any third-party checksum utilities. Only use software from vendors you trust.
+
+[^gatekeeper-disabled]: If Gatekeeper is disabled on your Mac, you may not see this message.
+
+[^gatekeeper-instructions]: These instructions are taken directly from Apple's Gatekeeper support documents. You can learn more about Gatekeeper [here](https://support.apple.com/en-us/HT202491).
diff -ur source/docs/en/1.2.0/index.markdown source/docs/en/1.3.0/index.markdown
--- source/docs/en/1.2.0/index.markdown 2019-11-09 17:18:24.000000000 -0500
+++ source/docs/en/1.3.0/index.markdown 2019-11-09 17:18:39.000000000 -0500
@@ -16,7 +16,7 @@
 Welcome
 =======

-Welcome to the English documentation for HandBrake 1.2.0 through 1.2.2.
+Welcome to the English documentation for HandBrake 1.3.0.

 Here are some quick links to get you started:

diff -ur source/docs/en/1.2.0/introduction/about.markdown source/docs/en/1.3.0/introduction/about.markdown
--- source/docs/en/1.2.0/introduction/about.markdown    2019-11-09 17:18:25.000000000 -0500
+++ source/docs/en/1.3.0/introduction/about.markdown    2019-11-09 17:18:39.000000000 -0500
@@ -20,18 +20,18 @@

 HandBrake is an open-source video transcoder available for Linux, Mac, and Windows. Everyone can use HandBrake to make videos *for free*.

-HandBrake is a post-production tool. Its primary purpose is to convert videos from supported [source formats](../technical/source-formats.html) to MP4 or MKV format. If you wish to make changes to your `Source` video, please use an appropriate [video editing software](https://en.wikipedia.org/wiki/List_of_video_editing_software).
+HandBrake is a post-production tool. Its primary purpose is to convert videos from supported [source formats](../technical/source-formats.html) to MP4, MKV, or WebM format. If you wish to make changes to your `Source` video, please use an appropriate [video editing software](https://en.wikipedia.org/wiki/List_of_video_editing_software).

 ## What HandBrake does

 HandBrake takes videos you already have and makes new ones that work on your mobile phone, tablet, TV media player, game console, computer, or web browser—nearly anything that supports modern video formats.

-HandBrake works with most common video files and formats, including ones created by consumer and professional video cameras, mobile devices such as phones and tablets, game and computer screen recordings, and DVD and Blu-ray discs. HandBrake leverages tools such as FFmpeg, x264, and x265 to create new MP4 or MKV video files from these `Sources`.
+HandBrake works with most common video files and formats, including ones created by consumer and professional video cameras, mobile devices such as phones and tablets, game and computer screen recordings, and DVD and Blu-ray discs. HandBrake leverages tools such as FFmpeg, x264, and x265 to create new MP4, MKV, or WebM video files from these `Sources`.

 HandBrake **does**:

-- Convert nearly any video to MP4 or MKV
+- Convert nearly any video to MP4, MKV, or WebM
 - Crop and resize video
 - Restore old and low-quality video
 - Remove combing artifacts caused by interlacing and telecine
diff -ur source/docs/en/1.2.0/table-of-contents.markdown source/docs/en/1.3.0/table-of-contents.markdown
--- source/docs/en/1.2.0/table-of-contents.markdown 2019-11-09 17:18:25.000000000 -0500
+++ source/docs/en/1.3.0/table-of-contents.markdown 2019-11-09 17:18:39.000000000 -0500
@@ -52,13 +52,13 @@

 - [Using the queue](advanced/queue.html)
   *Set up multiple encode jobs at once*
-- [Point-to-point encoding](advanced/point-to-point.html)
-- [Custom presets](advanced/custom-presets.html)
-- [Audio and subtitle defaults](advanced/audio-subtitle-defaults.html)
-- [Resizing video](advanced/resizing-video.html)
-- [Preserving surround sound](advanced/surround-sound.html)
-- [Adding subtitles](advanced/subtitles.html)
-- [Adding chapter markers](advanced/chapter-markers.html)
+- [Point-to-point encoding](advanced/point-to-point.html)<span class="notice draft"><span>draft</span></span>
+- [Custom presets](advanced/custom-presets.html)<span class="notice draft"><span>draft</span></span>
+- [Audio and subtitle defaults](advanced/audio-subtitle-defaults.html)<span class="notice draft"><span>draft</span></span>
+- [Resizing video](advanced/resizing-video.html)<span class="notice draft"><span>draft</span></span>
+- [Preserving surround sound](advanced/surround-sound.html)<span class="notice draft"><span>draft</span></span>
+- [Adding subtitles](advanced/subtitles.html)<span class="notice draft"><span>draft</span></span>
+- [Adding chapter markers](advanced/chapter-markers.html)<span class="notice draft"><span>draft</span></span>

 <!-- - [Managing Audio Tracks](advanced/managing-audio.html) -->
 <!-- - [Post-processing metadata](advanced/post-processing.html) -->
@@ -85,14 +85,14 @@

 <!-- ## Advanced workflows part 2

-- [Understanding source types](advanced/video-sources.html)
-- [Selecting a container format and encoders](advanced/containers.html)
-- [Selecting a video angle](advanced/video-angles.html)
-- [Working with frame rates](advanced/frame-rates.html)
-- [Adjusting audio quality](advanced/audio-quality.html)
-- [Progressive download support](advanced/web-optimised.html)
-- [Compatibility with legacy devices](advanced/old-ipod-support.html)
-- [Automatically naming files](advanced/automatic-file-naming.html)
+- [Understanding source types](advanced/video-sources.html)<span class="notice draft"><span>draft</span></span>
+- [Selecting a container format and encoders](advanced/containers.html)<span class="notice draft"><span>draft</span></span>
+- [Selecting a video angle](advanced/video-angles.html)<span class="notice draft"><span>draft</span></span>
+- [Working with frame rates](advanced/frame-rates.html)<span class="notice draft"><span>draft</span></span>
+- [Adjusting audio quality](advanced/audio-quality.html)<span class="notice draft"><span>draft</span></span>
+- [Progressive download support](advanced/web-optimised.html)<span class="notice draft"><span>draft</span></span>
+- [Compatibility with legacy devices](advanced/old-ipod-support.html)<span class="notice draft"><span>draft</span></span>
+- [Automatically naming files](advanced/automatic-file-naming.html)<span class="notice draft"><span>draft</span></span>
 -->

 ## Getting help
@@ -107,7 +107,7 @@

 ## More information

-- [Project history](about/history.html)
+- [Project history](about/history.html)<span class="notice draft"><span>draft</span></span>
 - [Contributing](contributing/contribute.html)
   *How you can get involved*

@@ -115,7 +115,7 @@
 ## CLI documentation

 - [Command line reference](cli/command-line-reference.html)
-- [CLI options list](cli/cli-options.html)
+- [CLI options list](cli/cli-options.html)<span class="notice draft"><span>draft</span></span>

 ## Technical documentation
@@ -126,28 +126,31 @@
   *Types of video files HandBrake can read*
 - [Official presets](technical/official-presets.html)
   *Technical summary of the official presets*
+- [Performance](technical/performance.html)
+  *How various settings affect encoding speed*
 - Video
-  - [Video encoders](technical/video-codecs.html)
-  - [Video encoding speed](technical/video-encoding-performance.html)
-  - [Constant quality versus average bit rate](technical/video-cq-vs-abr.html)
-  - [x264 presets and tunes](technical/video-x264-presets-tunes.html)
-  - [x264 profile and level](technical/video-x264-profiles-levels.html)
-  - [Video angles](technical/video-angles.html)
-  - [Anamorphic video](technical/anamorphic-guide.html)
-  - [Modulus](technical/modulus.html)
-  - [Frame rate](technical/frame-rates.html)
-  - [Intel QuickSync Video (QSV) options](technical/video-qsv-options.html)
+  - [Video codecs](technical/video-codecs.html)<span class="notice draft"><span>draft</span></span>
+  - [Constant quality versus average bit rate](technical/video-cq-vs-abr.html)<span class="notice draft"><span>draft</span></span>
+  - [Presets and tunes](technical/video-presets-tunes.html)<span class="notice draft"><span>draft</span></span>
+  - [Profiles and levels](technical/video-profiles-levels.html)<span class="notice draft"><span>draft</span></span>
+  - [Video angles](technical/video-angles.html)<span class="notice draft"><span>draft</span></span>
+  - [Anamorphic video](technical/anamorphic-guide.html)<span class="notice draft"><span>draft</span></span>
+  - [Modulus](technical/modulus.html)<span class="notice draft"><span>draft</span></span>
+  - [Frame rate](technical/frame-rates.html)<span class="notice draft"><span>draft</span></span>
+- Hardware encoders
   - [AMD VCE](technical/video-vce.html)
-  - [NVidia NVENC](technical/video-nvenc.html)
+  - [Apple VideoToolbox](technical/video-videotoolbox.html)
+  - [Intel QuickSync Video](technical/video-qsv.html)
+  - [Nvidia Nvenc](technical/video-nvenc.html)
 - Audio
-  - [Dynamic range compression](technical/dynamic-range-compression.html)
-  - [Audio quality](technical/audio-quality.html)
+  - [Dynamic range compression](technical/dynamic-range-compression.html)<span class="notice draft"><span>draft</span></span>
+  - [Audio quality](technical/audio-quality.html)<span class="notice draft"><span>draft</span></span>
 - Files and compatibility
-  - [Container formats](technical/containers.html)
-  - [iPod 5th Generation support](technical/old-ipod-support.html)
-  - [Automatic file naming](technical/automatic-file-naming.html)
+  - [Container formats](technical/containers.html)<span class="notice draft"><span>draft</span></span>
+  - [iPod 5th Generation support](technical/old-ipod-support.html)<span class="notice draft"><span>draft</span></span>
+  - [Automatic file naming](technical/automatic-file-naming.html)<span class="notice draft"><span>draft</span></span>
 - Filters
-  - [Filters summary](technical/filters-summary.html)
+  - [Filters summary](technical/filters-summary.html)<span class="notice draft"><span>draft</span></span>

 <!--
 - [Web optimized](technical/web-optimised.html)
@@ -162,9 +165,9 @@
   - [Building HandBrake for BSD](developer/build-bsd.html)
     - Installing dependencies on [FreeBSD](developer/install-dependencies-freebsd.html)
   - [Building HandBrake for Linux](developer/build-linux.html)
-    - Installing dependencies on [Arch](developer/install-dependencies-arch.html) / [CentOS](developer/install-dependencies-centos.html) / [Debian](developer/install-dependencies-debian.html) / [Fedora](developer/install-dependencies-fedora.html) / [Gentoo](developer/install-dependencies-gentoo.html) / [Ubuntu](developer/install-dependencies-ubuntu.html)
+    - Installing dependencies on [Arch](developer/install-dependencies-arch.html) / [CentOS](developer/install-dependencies-centos.html) / [Clear](developer/install-dependencies-clear.html) / [Debian](developer/install-dependencies-debian.html) / [Fedora](developer/install-dependencies-fedora.html) / [Gentoo](developer/install-dependencies-gentoo.html) / [Ubuntu](developer/install-dependencies-ubuntu.html)
   - [Building HandBrake for Mac](developer/build-mac.html)
   - [Building HandBrake for Windows](developer/build-windows.html)
 - Packaging HandBrake
-  - [Flatpak apps for Linux](developer/flatpak-repo.html)
+  - [Flatpak apps for Linux](developer/flatpak-repo.html)<span class="notice draft"><span>draft</span></span>
     *Fully-contained applications compatible with multiple Linux distributions*
diff -ur source/docs/en/1.2.0/technical/anamorphic-guide.markdown source/docs/en/1.3.0/technical/anamorphic-guide.markdown
--- source/docs/en/1.2.0/technical/anamorphic-guide.markdown    2019-11-09 17:18:25.000000000 -0500
+++ source/docs/en/1.3.0/technical/anamorphic-guide.markdown    2019-11-09 17:18:39.000000000 -0500
@@ -106,7 +106,7 @@

 Now, how do we go about doing this?

-Vide on a computer is stored in a container file, be it .mp4 or .mkv or .avi or .ogm or something else. Inside that container are tracks or streams. Usually, there will be one video track and one audio track.
+Video on a computer is stored in a container file, be it .mp4 or .mkv or .avi or .ogm or something else. Inside that container are tracks or streams. Usually, there will be one video track and one audio track.

 The smart way of handling anamorphic is to store the display information in the video track. And this is exactly what HandBrake does:

diff -ur source/docs/en/1.2.0/technical/automatic-file-naming.markdown source/docs/en/1.3.0/technical/automatic-file-naming.markdown
--- source/docs/en/1.2.0/technical/automatic-file-naming.markdown   2019-11-09 17:18:25.000000000 -0500
+++ source/docs/en/1.3.0/technical/automatic-file-naming.markdown   2019-11-09 17:18:39.000000000 -0500
@@ -25,8 +25,19 @@
 Here you can define the default path where output files will be stored, and the format the file name will take.

 By default, it will be {source}-{title}
-You can add in addition to this: {chapters}

+These are all of the placeholder field options:
+* Live Update:
+  * {source}
+  * {title}
+  * {chapters}
+* Non-live Update: These only change if you scan a new source, change title or chapters.
+  * {date}
+  * {time}
+  * {creation-date}
+  * {creation-time}
+  * {quality}
+  * {bitrate}

 ### Source Name Handling.

diff -ur source/docs/en/1.2.0/technical/containers.markdown source/docs/en/1.3.0/technical/containers.markdown
--- source/docs/en/1.2.0/technical/containers.markdown  2019-11-09 17:18:25.000000000 -0500
+++ source/docs/en/1.3.0/technical/containers.markdown  2019-11-09 17:18:39.000000000 -0500
@@ -1,6 +1,6 @@
 ---
 Type:            article
-Title:           Formats / containers
+Title:           Container formats
 Project:         HandBrake
 Project_URL:     https://handbrake.fr/
 Project_Version: 1.2.0
@@ -13,18 +13,18 @@
 License_URL:     https://handbrake.fr/docs/license.html
 ---

-Formats / containers
-=============================
+Container formats
+=================

 Containers are files that wrap around video and audio tracks—indexing and organizing the streams for playback—in addition to providing advanced features, like chapters similar to those on DVDs.

-HandBrake supports two widely supported formats. MKV and MP4 (Sometimes seen as M4v)
+HandBrake creates the widely supported container formats MKV and MP4 (sometimes seen as M4V), in addition to the [WebM](https://www.webmproject.org/) container format, which is subset of MKV.

 ## Features 

-Features and playback compatiblity varies between MKV and MP4. The following is a summary of some of these differences:
+Features and playback compatiblity varies between MKV, WebM, and MP4. The following is a summary of some of these differences:

-- In an MP4 file, you can store MPEG-4 video created by ffmpeg or x264.
+- In an MP4 container, you can store MPEG-4 video created by ffmpeg or x264.
   - Supports H.264, H.265, MPEG-4, MPEG-2 video. 
   - It stores audio in the AAC format. It is also possible to pass through Dolby Digital 5.1 Surround Sound (AC3) audio from a DVD in an MP4 file, although it is a new standard and not widely supported. VLC can decode it, and the AppleTV can pass it through to a surround sound receiver. 
   - MP4 also supports chapters, for which HandBrake uses Apple's chapter format. 
@@ -33,15 +33,20 @@
   - The MP4 format can also be optimized for "fast start" progressive downloads over the Web. 
   - It can also include "soft" text subtitles that can be turned on or off, instead of always being hard burned into the video frames.

-- In an MKV, you can store MPEG-4 video created by ffmpeg or x264, or Theora video. 
+- In an MKV container, you can store MPEG-4 video created by ffmpeg or x264, or Theora video. 
   - Supports H.264, H.265, MPEG-4, MPEG-2 video and VP3 (Vorbis) 
   - It stores audio in the AAC, MP3, Vorbis or FLAC formats. It can also pass through the Dolby Digital 5.1 (AC3) and Digital Theater Systems (DTS) surround sound formats used by DVDs. 
   - It supports chapters, as well as [VariableFrameRate Variable Frame Rate] video. 
   - It can include "soft" subtitles that can be turned on or off, instead of always being hard burned into the video frame. These can either be bitmap images of the subtitles included on a DVD (known as vobsub) or text.

-## MP4 vs M4v
+- In a WebM container, you can store VP8 or VP9 video.
+  - Supports VP8 and VP9 video codecs.
+  - It stores audio in either Vorbis or Opus formats.
+  - It can include "hard" burned in subtitles. "Soft" subtitles are currently unsupported.

-They are the exact same file, the only difference is the extension. MP4 vs M4v.
+## MP4 vs M4V
+
+They are the exact same file, the only difference is the extension. MP4 vs M4V.

 For MP4 files, HandBrake will automatically use the extension M4V when you pass-through audio (AC3), use SRT subtitles or have chapter markers enabled.

diff -ur source/docs/en/1.2.0/technical/official-presets.markdown source/docs/en/1.3.0/technical/official-presets.markdown
--- source/docs/en/1.2.0/technical/official-presets.markdown    2019-11-09 17:18:25.000000000 -0500
+++ source/docs/en/1.3.0/technical/official-presets.markdown    2019-11-09 17:18:39.000000000 -0500
@@ -60,20 +60,27 @@

 HandBrake's Web `Presets` use the broadly compatible [MP4 container](https://en.wikipedia.org/wiki/MPEG-4_Part_14) and are tailored for sharing videos on the Internet.

+Discord Nitro `Presets` are designed to guarantee video up to a certain duration will produce a file less than 50 [MB](abbr:megabytes) for use with [Discord Nitro Classic](https://discordapp.com/nitro) or 100 [MB](abbr:megabytes) for use with [Discord Nitro](https://discordapp.com/nitro). Likewise, Discord `Presets` are designed to guarantee video up to a certain duration will produce a file less than 8 [MB](abbr:megabytes) for use with [Discord](https://discordapp.com/) free accounts. The maximum duration is part of each `Preset` name. Audio quality is slightly reduced, and visually noisy/grainy or high motion scenes may show a reduction in quality in order to achieve the target file size.
+
 Gmail `Presets` are designed to guarantee video up to a certain duration will produce a file less than 25 [MB](abbr:megabytes) for attaching to an email.[^email-size-limit] The maximum duration is part of each `Preset` name. Audio quality is slightly reduced, and visually noisy/grainy or high motion scenes may show a reduction in quality in order to achieve the target file size.

 Vimeo YouTube `Presets` produce videos suitable for uploading to popular video hosting services.[^video-hosting-services] `Presets` marked HQ are designed to deliver higher quality while encoding in a resonable amount of time.

-| Preset                        | Type | Video | Audio      | Picture Quality   | Encoding Speed | File Size     |
-|-------------------------------|------|-------|------------|-------------------|----------------|---------------|
-| Gmail Large 3 Minutes 720p30  | MP4  | H.264 | AAC stereo | Depends on source | Fast           | 25 MB or less |
-| Gmail Medium 5 Minutes 480p30 | MP4  | H.264 | AAC stereo | Depends on source | Fast           | 25 MB or less |
-| Gmail Small 10 Minutes 288p30 | MP4  | H.264 | AAC mono   | Depends on source | Fast           | 25 MB or less |
-| Vimeo YouTube HQ 2160p60 4K   | MP4  | H.264 | AAC stereo | High              | Medium         | Large         |
-| Vimeo YouTube HQ 1440p60 2.5K | MP4  | H.264 | AAC stereo | High              | Medium         | Large         |
-| Vimeo YouTube HQ 1080p60      | MP4  | H.264 | AAC stereo | High              | Medium         | Large         |
-| Vimeo YouTube HQ 720p60       | MP4  | H.264 | AAC stereo | High              | Medium         | Large         |
-| Vimeo YouTube 720p30          | MP4  | H.264 | AAC stereo | Standard          | Medium         | Average       |
+| Preset                                   | Type | Video | Audio      | Picture Quality   | Encoding Speed | File Size         |
+|------------------------------------------|------|-------|------------|-------------------|----------------|-------------------|
+| Discord Nitro Large 3-6 Minutes 1080p30  | MP4  | H.264 | AAC stereo | Depends on source | Fast           | 50/100 MB or less |
+| Discord Nitro Medium 5-10 Minutes 720p30 | MP4  | H.264 | AAC stereo | Depends on source | Fast           | 50/100 MB or less |
+| Discord Nitro Small 10-20 Minutes 480p30 | MP4  | H.264 | AAC stereo | Depends on source | Fast           | 50/100 MB or less |
+| Discord Small 2 Minutes 360p30           | MP4  | H.264 | AAC mono   | Depends on source | Very Fast      |      8 MB or less |
+| Discord Tiny 5 Minutes 240p30            | MP4  | H.264 | AAC mono   | Depends on source | Very Fast      |      8 MB or less |
+| Gmail Large 3 Minutes 720p30             | MP4  | H.264 | AAC stereo | Depends on source | Fast           |     25 MB or less |
+| Gmail Medium 5 Minutes 480p30            | MP4  | H.264 | AAC stereo | Depends on source | Fast           |     25 MB or less |
+| Gmail Small 10 Minutes 288p30            | MP4  | H.264 | AAC mono   | Depends on source | Fast           |     25 MB or less |
+| Vimeo YouTube HQ 2160p60 4K              | MP4  | H.264 | AAC stereo | High              | Medium         |             Large |
+| Vimeo YouTube HQ 1440p60 2.5K            | MP4  | H.264 | AAC stereo | High              | Medium         |             Large |
+| Vimeo YouTube HQ 1080p60                 | MP4  | H.264 | AAC stereo | High              | Medium         |             Large |
+| Vimeo YouTube HQ 720p60                  | MP4  | H.264 | AAC stereo | High              | Medium         |             Large |
+| Vimeo YouTube 720p30                     | MP4  | H.264 | AAC stereo | Standard          | Medium         |           Average |

 ## Devices presets

@@ -107,10 +114,6 @@
 | Roku 720p30 Surround                | MP4     | H.264     | AAC stereo; Dolby Digital (AC-3) | Medium         |
 | Roku 576p25                         | MP4     | H.264     | AAC stereo                       | Medium         |
 | Roku 480p30                         | MP4     | H.264     | AAC stereo                       | Medium         |
-| Windows Mobile 1080p30              | MP4     | H.264     | AAC stereo                       | Medium         |
-| Windows Mobile 720p30               | MP4     | H.264     | AAC stereo                       | Medium         |
-| Windows Mobile 540p30               | MP4     | H.264     | AAC stereo                       | Medium         |
-| Windows Mobile 480p30               | MP4     | H.264     | AAC stereo                       | Medium         |
 | Xbox 1080p30 Surround               | MP4     | H.264     | AAC stereo; Dolby Digital (AC-3) | Medium         |
 | Xbox Legacy 1080p30 Surround        | MP4     | H.264     | AAC stereo; Dolby Digital (AC-3) | Medium         |

@@ -159,6 +162,15 @@

 From time to time, official `Presets` may be deprecated or removed. Compatible replacements are listed here.

+### Windows Mobile presets
+
+| Preset                 | Compatible Preset      | Notes                                                                                        |
+|------------------------|------------------------|----------------------------------------------------------------------------------------------|
+| Windows Mobile 1080p30 | General > Fast 1080p30 | Later Windows Mobile and Windows Phone devices, and Windows 10 Mobile devices.               |
+| Windows Mobile 720p30  | General > Fast 720p30  | Add vbv-bufsize=10000:vbv-maxrate=10000 to the additional encoder options for older devices. |
+| Windows Mobile 540p30  | General > Fast 480p30  | Add vbv-bufsize=4000:vbv-maxrate=4000 to the additional encoder options for older devices.   |
+| Windows Mobile 480p30  | General > Fast 480p30  | Add vbv-bufsize=2000:vbv-maxrate=2000 to the additional encoder options for older devices.   |
+
 ### Legacy 0.10.x presets

 | Preset              | Compatible Preset                | Notes                                                                                                                                   |
Only in source/docs/en/1.3.0/technical: performance.markdown
diff -ur source/docs/en/1.2.0/technical/source-formats.markdown source/docs/en/1.3.0/technical/source-formats.markdown
--- source/docs/en/1.2.0/technical/source-formats.markdown  2019-11-09 17:18:25.000000000 -0500
+++ source/docs/en/1.3.0/technical/source-formats.markdown  2019-11-09 17:18:39.000000000 -0500
@@ -1,6 +1,6 @@
 ---
 Type:            article
-Title:           Source formats
+Title:           Supported source formats
 Project:         HandBrake
 Project_URL:     https://handbrake.fr/
 Project_Version: 1.2.0
@@ -13,8 +13,8 @@
 License_URL:     https://handbrake.fr/docs/license.html
 ---

-Source formats
-==============
+Supported source formats
+========================

 One of HandBrake's strengths is its ability to open a wide variety of video formats. HandBrake uses [FFmpeg](https://ffmpeg.org/) under the hood and generally can open whatever FFmpeg will, in addition to disc-based formats like DVD and Blu-ray.

@@ -28,15 +28,15 @@

 ## Screen and game recordings, web videos, video editing projects, and other computer-related sources

-Some screen recording softwares can export or record directly to video files HandBrake can open. Common video file types are MP4 or M4V, MKV, MPG or MPEG, AVI, and WMV.
+Some screen recording softwares can export or record directly to video files HandBrake can open. Common video file types are MP4 or M4V, MKV, MOV, MPG or MPEG, AVI, and WMV.

 HandBrake can open web videos in FLV, WEBM, MP4, and many other formats.

-Videos made using consumer video editing software such as [iMovie](https://www.apple.com/mac/imovie/) must first be exported to a common video format for compatibility with HandBrake.
+Videos made using consumer video editing software such as [iMovie](https://www.apple.com/mac/imovie/) and [Shotcut](https://www.shotcut.org/) must first be exported to a common video format for compatibility with HandBrake.

 ## Professional video production formats

-HandBrake can open a number of production formats produced by professional video cameras and [NLE](abbr:Non-linear editing system)s, including [ProRes](https://en.wikipedia.org/wiki/Apple_ProRes) and [DNxHD](https://en.wikipedia.org/wiki/DNxHD_codec).
+HandBrake can open a number of production formats produced by professional video cameras and [NLE](abbr:Non-linear editing system)s, including [MXF](https://en.wikipedia.org/wiki/Material_Exchange_Format), [MPEG-TS](https://en.wikipedia.org/wiki/MPEG_transport_stream), and [QuickTime](https://en.wikipedia.org/wiki/QuickTime), along with common video codecs such as [CineForm](https://en.wikipedia.org/wiki/CineForm), [DNxHD](https://en.wikipedia.org/wiki/DNxHD_codec), [DNxHR](https://en.wikipedia.org/wiki/DNxHR_codec), [ProRes](https://en.wikipedia.org/wiki/Apple_ProRes), [XAVC](https://en.wikipedia.org/wiki/XAVC), and [XDCAM](https://en.wikipedia.org/wiki/XDCAM).

 ## DVD, Blu-ray, AVCHD/AVCHD Lite[^avchd-partial-support], and HD-DVD[^hddvd-partial-support] discs or disc backups

diff -ur source/docs/en/1.2.0/technical/system-requirements.markdown source/docs/en/1.3.0/technical/system-requirements.markdown
--- source/docs/en/1.2.0/technical/system-requirements.markdown 2019-11-09 17:18:25.000000000 -0500
+++ source/docs/en/1.3.0/technical/system-requirements.markdown 2019-11-09 17:18:39.000000000 -0500
@@ -24,14 +24,14 @@

 ### Linux

-- Processor: Intel Core 2 Duo, AMD Athlon X2, or better
+- Processor: Intel Core i3, AMD FX / 2014+ APU, or better
 - Free Memory:
-  - 256 MB for transcoding standard definition video
-  - 1 GB for transcoding high definition video
-  - 2 GB or more for transcoding 4K video
+  - 512 MB for transcoding standard definition video
+  - 1.5 GB for transcoding high definition video
+  - 4 GB or more for transcoding 4K video
 - Screen Resolution: 1024x768 or better
 - System Storage:
-  - 50 MB for the HandBrake app
+  - 100 MB for the HandBrake app
   - 2 GB or more recommended for processing and storing your new videos

 <!-- /.system-linux -->
@@ -40,16 +40,15 @@

 ### Mac

-- Processor: Intel Core 2 Duo or better
-  - 32-bit Intel Macs (2007 and earlier) cannot run recent 64-bit HandBrake releases
-  - 2010 models and newer are recommended, as older Macs are often quite slow for processing video
+- Processor: Intel Core i3 or better
+  - 2012 models and newer are recommended as older Macs are often quite slow for processing video
 - Free Memory:
-  - 256 MB for transcoding standard definition video
-  - 1 GB for transcoding high definition video
-  - 2 GB or more for transcoding 4K video
+  - 512 MB for transcoding standard definition video
+  - 1.5 GB for transcoding high definition video
+  - 4 GB or more for transcoding 4K video
 - Screen Resolution: 1024x768 or better
 - System Storage:
-  - 50 MB for the HandBrake app
+  - 100 MB for the HandBrake app
   - 2 GB or more recommended for processing and storing your new videos

 <!-- /.system-macos -->
@@ -58,11 +57,11 @@

 ### Windows

-- Processor: Intel Core 2 Duo, AMD Athlon X2, or better
+- Processor: Intel Core i3, AMD FX / 2014+ APU, or better
 - Free Memory:
-  - 256 MB for transcoding standard definition video
-  - 1 GB for transcoding high definition video
-  - 2 GB or more for transcoding 4K video
+  - 512 MB for transcoding standard definition video
+  - 1.5 GB for transcoding high definition video
+  - 4 GB or more for transcoding 4K video
 - Screen Resolution: 1024x768 or better (higher if running in High-DPI Mode, above 96 DPI or 100%)
 - System Storage:
   - 50 MB for the HandBrake app
@@ -70,7 +69,14 @@

 <!-- /.system-windows -->

-HandBrake's QuickSync feature is only supported on Windows. Experimental Linux support requires building from source with `--enable-qsv`. QuickSync requires a 2nd generation (Sandy Bridge) or newer Intel Core series processor with integrated Intel HD Graphics enabled.
+## Hardware Encoders
+
+Please see the specific documentation pages for these encoders for further details.
+
+- [AMD VCE](video-vce.html)
+- [Apple VideoToolbox](video-videotoolbox.html)
+- [Intel QuickSync Video](video-qsv.html)
+- [Nvidia Nvenc](video-nvenc.html)

 ## Software

@@ -79,7 +85,7 @@
 | Status      | Description                                                                                                                                              |
 |-------------|----------------------------------------------------------------------------------------------------------------------------------------------------------|
 | Supported   | HandBrake is tested working on these system versions. The HandBrake Team and community members provide volunteer support, and issue reports are welcome. |
-| Deprecated  | HandBrake should work on these system versions. Support is near end of life. Limited functionality and other issues will likely not be addressed.        |
+| Deprecated  | HandBrake may work on these system versions. Support is near end of life. Limited functionality and other issues will likely not be addressed.           |
 | Unsupported | HandBrake does not work on these system versions. No support will be provided. Please update to enjoy the latest features and bug fixes.                 |

 <!-- .system-linux -->
@@ -94,14 +100,18 @@

 | Ubuntu Version     | Status              | Last Compatible Version |
 |--------------------|---------------------|-------------------------|
+| 19.04 LTS Xenial   | Supported           |                         |
 | 18.04 LTS Bionic   | Supported           |                         |
-| 16.04 LTS Xenial   | Supported           |                         |
+| 16.04 LTS Xenial   | Unsupported         | HandBrake 1.1.2         |
 | 14.04 LTS Trusty   | Unsupported         | HandBrake 1.1.2         |

 #### Flatpak

 Requires a recent Linux distribution and `flatpak` package.

+The download is availabe from our main site, and also [FlatHub](https://flathub.org/apps/details/fr.handbrake.ghb)
+
+
 #### Other

 For other distributions, compile from source using the [Linux instructions](../developer/build-linux.html) or [BSD instructions](../developer/build-bsd.html).
@@ -111,16 +121,17 @@

 ### Mac

-- macOS 10.10 Yosemite and later
+- macOS 10.11 Yosemite and later
 - [VLC](https://www.videolan.org/vlc/) is recommended for previewing/playing MKV (Matroska) media files

 | macOS Version      | Status              | Last Compatible Version | Notes                              |
 |--------------------|---------------------|-------------------------|------------------------------------|
+| 10.15 Catalina     | Supported           |                         | Requires HandBrake 1.2.2 or later. |
 | 10.14 Mojave       | Supported           |                         | Requires HandBrake 1.1.2 or later. |
 | 10.13 High Sierra  | Supported           |                         |                                    |
 | 10.12 Sierra       | Supported           |                         |                                    |
 | 10.11 El Capitan   | Deprecated in 1.2.0 |                         |                                    |
-| 10.10 Yosemite     | Deprecated in 1.2.0 |                         |                                    |
+| 10.10 Yosemite     | Unsupported         | HandBrake 1.1.2         |                                    |
 | 10.9 Mavericks     | Unsupported         | HandBrake 1.1.2         |                                    |
 | 10.8 Mountain Lion | Unsupported         | HandBrake 1.1.2         |                                    |
 | 10.7 Lion          | Unsupported         | HandBrake 1.1.2         |                                    |
@@ -132,7 +143,7 @@
 ### Windows

 - Windows 7 Service Pack 1 (64-bit) or later
-- Microsoft .NET Framework 4.7.1 or later
+- Microsoft .NET Framework 4.8 or later
 - [VLC](https://www.videolan.org/vlc/) is recommended for previewing/playing media files

 | Windows Version | Status              | Last Compatible Version |
diff -ur source/docs/en/1.2.0/technical/video-codecs.markdown source/docs/en/1.3.0/technical/video-codecs.markdown
--- source/docs/en/1.2.0/technical/video-codecs.markdown    2019-11-09 17:18:25.000000000 -0500
+++ source/docs/en/1.3.0/technical/video-codecs.markdown    2019-11-09 17:18:39.000000000 -0500
@@ -1,77 +1,68 @@
 ---
 Type:            article
-Title:           Video Codecs
+Title:           Video codecs
 Project:         HandBrake
 Project_URL:     https://handbrake.fr/
 Project_Version: 1.2.0
 Language:        English
 Language_Code:   en
-Authors:         [ Scott (s55) ]
+Authors:         [ Bradley Sepos <bradley@bradleysepos.com> (BradleyS), Scott (s55) ]
 Copyright:       2019 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
 ---

-Video Codecs
+Video codecs
 ============

- 
+The following video codecs are available for encoding in HandBrake.

--   H.264 (x264): For MPEG-4 part 10, also known as H.264/AVC.
+- H.264 (x264):

-    -   This is HandBrakes default encoder. It provides excellent performance,
-        filesizes and quality.
+    - MPEG-4 Part 10, also known as H.264/AVC
+    - Provides excellent quality, performance, and file size
+    - Widely supported by media players, including mobile devices

-    -   It is widely supported by players and mobile devices.
+- H.264 (Intel QuickSync):

--   H.264 (Intel QuickSync): For MPEG-4 part 10, also known as H.264/AVC.
+    - MPEG-4 Part 10, also known as H.264/AVC
+    - Hardware based encoder available on Intel processors with Intel HD Graphics (Haswell or newer series CPUs recommended for best quality and file size)
+    - Very fast with significantly lower CPU usage than software H.264 encoders such as x264
+    - Produces larger (but usually not significantly larger) file sizes and slightly lower quality to an equivalent x264 encode, a trade-off that is typically acceptable, especially on lower performance systems

-    -   Available on Intel processors with Intel HD Graphics.
+- H.265 (x265)

-    -   QuickSync is a hardware based H.264 encoder so is very fast, with
-        significantly lower CPU usage than x264.
+    - MPEG-H Part 2, also known as H.265/HEVC
+    - Successor to H.264/AVC offering higher quality encodes and smaller file sizes
+    - Current strengths of x265 are improved quality and compression for low bit rate encodes, and for ultra high definition content
+    - Significantly slower than software H.264/AVC encoders
+    - Limited device compatibility compared to H.264/AVC, but this is improving rapidly

-    -   Intel Haswell or newer CPU's are recommended as these offer the best
-        results in terms of Quality and Filesize.
+- MPEG-4 (ffmpeg):

-    -   You can typically expect larger (but usually not significantly larger)
-        file sizes and slightly lower quality to an equivilent x264 encode. This
-        is a trade off that is fine for most.
+    - MPEG-4 Part 2, also known as MPEG-4 Visual
+    - Predecessor to H.264/AVC offering fast encoding with lower overall quality than H.264/AVC
+    - Compatible with older devices, inexpensive DVD/flash/network players

--   H.265 (x265): Also known as HEVC
+- MPEG-2 (ffmpeg):

-    -   This is the next generation of encoder that offers even higher quality
-        encodes and better filesizes over H.264
+    - MPEG-2 Part 2, also known as MPEG-2 Visual and H.262
+    - Predecessor to MPEG-4 Visual offering very fast encoding with lower quality than modern codecs
+    - Creates larger files than modern encoders

-    -   Note, encoding to H.265 is a significantly more complicated process, so
-        it is expected to be slower than HandBrake's H.264 encoders.
+- VP9 (libvpx):

-    -   Playback support is rather limited at the moment, particularly with
-        mobile devices but this should improve drastically throughout 2015/16
+    - Developed by Google and the successor to VP8, VP9 is a free and open video codec
+    - Comparable to HEVC/H.265 in quality and file size
+    - Slower encoding compared to x265

--   MPEG-4 (ffmpeg): HandBrake offers FFmpeg's MPEG-4 part 2 encoder for fast,
-    low quality encoding.
+- VP8 (libvpx):

-    -   Better support from older devices such as DVD players and cheap "MP4
-        Players"
+    - Developed by On2 Technologies and acquired by Google, VP8 is a free and open video codec
+    - Successor to Theora offering significant improvements, comparable to H.264/AVC

-    -   Lower quality than the H.264 encode option but typically faster encodes.
+- Theora:

--   MPEG-2 (ffmpeg): HandBrake offers FFmpeg's MPEG-2 part 2 encoder for fast,
-    low quality encoding.
-
-    -   Fast Encoding, but requires larger files than MPEG-4 for the same
-        quality level. Useful for testing but not much else.
-
--   VP8 (Libvpx):
-
-    -   A free and open video codec which offers significant improvements over
-        Theora.
-
--   VP3 (Theora): HandBrake can also encode Theora video. Theora video with
-    Vorbis audio in the Matroska container represents a truly free option for
-    multimedia encoding.
-
-    -   However, Theora has yet to reach maturity when measured by quality at a
-        given bitrate.
+    - Developed by Xiph.Org Foundation and based on On2 Technologies' VP3, Theora is a free and open video codec
+    - Comparable to MPEG-4 Visual in quality and file size
diff -ur source/docs/en/1.2.0/technical/video-encoding-performance.markdown source/docs/en/1.3.0/technical/video-encoding-performance.markdown
--- source/docs/en/1.2.0/technical/video-encoding-performance.markdown  2019-11-09 17:18:25.000000000 -0500
+++ source/docs/en/1.3.0/technical/video-encoding-performance.markdown  2019-11-09 17:18:39.000000000 -0500
@@ -1,6 +1,6 @@
 ---
 Type:            article
-Title:           Video Encoding Speed
+Title:           Video encoding performance
 Project:         HandBrake
 Project_URL:     https://handbrake.fr/
 Project_Version: 1.2.0
@@ -11,58 +11,10 @@
 License:         Creative Commons Attribution-ShareAlike 4.0 International
 License_Abbr:    CC BY-SA 4.0
 License_URL:     https://handbrake.fr/docs/license.html
+Redirect_URL:    performance.html
 ---

-Video Encoding Speed
-=============================
-
-## How is encoding speed measured?
-
-The speed at which your source is encoded is measured in frames per second (fps). That is, how many still images from your video are encoded each second?
-So for example, if your encode is running at 100fps, and your source is a 25fps PAL DVD, then your encoding at 4x real time.
-
-
-## What affects encoding speed?
-
-There are many factors what affect encode performance. The hardware you are running on, the encoder settings you choose and source file itself.
-
-### Hardware
-
-The hardware you run on can have a large effect on performance. HandBrake can scale well up to 6 to 8 CPU cores with diminishing returns thereafter.
-So a 4 core CPU can be nearly twice as fast as a dual Core equivalent, however a 16 core may not be twice as fast as an 8 core but may still offer significant increases in performance. 
-The CPU scaling curve does vary greatly by source and settings used.
-
-HandBrake also supports encoding in ASIC hardware with Intel QuickSync, Nvidia NVEnc, and AMD VCE.
-
-See our [System Requirements](../technical/system-requirements.html) for details on recommended hardware for running HandBrake.
-
-### Settings
-
-Settings play a large part in encoding performance.  Most of the encoders expose many configuration options which allow you to tune the encoders. In HandBrake we've simplified this to a "Video Preset" slider. This offers a range of presets from Ultrafast to Placebo (which is very slow).  This slider trades off speed vs quality and file size. Using faster presets and reduces quality OR increase file size. Using slower presets uses more complex algorithms to compress the video which takes more time offering an overall better result.
-
-For x264 and x265, the Medium preset is a good trade off between quality, file size and speed but you can adjust this slider to suit your needs.
-
-
-<!-- .system-windows -->
-
-![HandBrake's Video Quality Settings](../../images/windows/video-quality-1.0.0.png "HandBrake's Video Quality Settings")
-
-<!-- /.system-windows -->
-
-
-Filters are another thing that has a big effect. Particularly if you use Denoise NLMeans. This is a very memory intensive operation so can drastically slow your encodes down. Again, there are settings for the filters that tune them for speed vs quality so you can see widely different results depending on what preset / tune you use.
-
-<!-- .system-windows -->
-
-![HandBrake's Video Filter Settings](../../images/windows/video-filters-1.0.0.png "HandBrake's Video Filter Settings")
-
-<!-- /.system-windows -->
-
-### Source
-
-Your source will have an effect on performance in several ways.
-For example, a 1080P HD video will take longer to encode using the same settings and hardware than a 576P file.  This is because there are 5 times as many pixels to process in the 1080P file.
-Another aspect that can affect performance is what the format of the input file is. For example the H.264 decoder is highly optimised but lesser used codecs may not be so well optimised.  Within a codec, Baseline H.264 will be far quicker and less CPU intensive to decode than High Profile H.264. This is because the decoding algorithms used are simpler, thus, you have more CPU time to spend on encoding.
-
-
+Video encoding performance
+==========================

+This article has been moved to [Performance](performance.html).
diff -ur source/docs/en/1.2.0/technical/video-nvenc.markdown source/docs/en/1.3.0/technical/video-nvenc.markdown
--- source/docs/en/1.2.0/technical/video-nvenc.markdown 2019-11-09 17:18:25.000000000 -0500
+++ source/docs/en/1.3.0/technical/video-nvenc.markdown 2019-11-09 17:18:39.000000000 -0500
@@ -1,73 +1,67 @@
 ---
 Type:            article
-Title:           Nvidia NVEnc Encoder
+Title:           Nvidia Nvenc
 Project:         HandBrake
 Project_URL:     https://handbrake.fr/
 Project_Version: 1.2.0
 Language:        English
 Language_Code:   en
-Authors:         [ Scott (s55) ]
+Authors:         [ Bradley Sepos <bradley@bradleysepos.com> (BradleyS), Scott (s55) ]
 Copyright:       2019 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
 ---

-Nvidia NVEnc Encoder
-==========================
+Nvidia Nvenc
+============

-Supported Hardware and Configurations 
---------------
-- Nvidia GeForce GTX 10 and RTX 20 Series graphics cards are supported. 
-- Driver "399.24" or later must be installed. 
-- Windows 7 SP1 and Later. (Linux *may* work but via the command line interface only)
+## Supported Hardware and Configurations 

+- Nvidia GeForce GTX Pascal (1050+) and RTX Turing (1650+, 2060+) series GPU or better
+- Nvidia Graphics Driver 418.81 or later
+- Windows 10
+- Experimental Linux support is available in HandBrake’s command line interface

-Please note, these are not hard limits and the feature *may* work on older series and operating systems, but this is not officially supported.
+Please note, these are not hard limits. Hardware encoding via Nvenc *might* work on older series GPUs and older operating systems, but this is not officially supported.

-Enabling support
---------------
-Support for the NVEnc encoder can be enabled in preferences under the video tab. If your system is not supported, the option will be greyed out.
+## Enabling support

+Support for the Nvidia Nvenc encoder is enabled in preferences on the video tab. If your system is not supported, the option will be disabled.

-Performance
---------------
-Take note that only the encode portion of the encode pipeline is done on the Nvidia ASIC hardware. 
-Every stage prior and after in the pipeline including (decoding, filters, a/v sync, muxing etc.) all happen on the CPU. As a result, it is normal to have high, or 100% CPU utilisation during encodes. 
+## Performance

-It is common, particularly on lower end hardware that the CPU may be a bottleneck for the Nvidia encoder. To minimise this effect, turn off any filters that you do not require. 
+Only video encoding is performed by the hardware encoder. Every stage prior to and after video encoding including decoding, filters, audio/video sync, audio encoding, muxing, etc., is performed by the CPU. As a result, it is normal to have high (even 100%) CPU utilisation during encodes.

+It is common, particularly on lower-end hardware, for the CPU to be a bottleneck for the hardware video encoder. To minimize this effect, disable any filters that you do not require.

-Using the Advanced Options
---------------
-NvEnc does have a limited set of advanced encoder options that can be used.  Generally speaking is is not recommended to change these parameters. The built-in presets offer a good range of options.
+## Advanced options

-From the command line, you can use the --encopts parameter as follows:
+The Nvidia Nvenc hardware encoder has a limited set of advanced encoder options. Generally speaking, it is not recommended to change these parameters, as the built-in presets offer a good range of options for common uses.

-    --encopts="option1=value1:option2=value2"
+From HandBrake’s command line interface, use the `--encopts` parameter as follows:

+    --encopts="option1=value1:option2=value2"

-From the graphical user interface, just set the options in the dedicated options text box on the Video tab.
+From HandBrake’s graphical interface, set the options in the `Advanced Options` field on the `Video` tab:

     option1=value1:option2=value2

-Option Types
---------------
+### Option value types
+
 The following value types are supported (each option only accepts one value type):

-- integer
+- integer  
   A number that can be written without a fractional or decimal component.

-- boolean
-  0 means off (or disabled).
+- boolean  
+  0 means off (or disabled).  
   1 means on (or enabled).

-- string
-  Takes a setting defined as s string. See comment for details. 
+- string  
+  An alphanumeric string of characters. See the option’s comments for acceptable values.

-  
-Available Options
---------------
+### Options list

 | Option           | Type        | H.264 | H.265 | Comment                                                                        |
 |------------------|-------------|------------------------------------------------------------------------------------------------|
@@ -76,11 +70,8 @@
 | spatial-aq       | boolean     |   X   |   X   | For H.265, use "spatial_aq" for H.265 encodes. Note the underscore             |
 | aq-strength      | int         |   X   |   X   | When Spatial AQ is enabled, the scale is from 1 (low) - 15 (aggressive)        |
 | nonref_p         | boolean     |   X   |   X   | Enable automatic insertion of non-reference P-frames                           |
-| strict_gop       | boolean     |   X   |   X   | Minimise GOP to GOP rate fluctuations                                          |
+| strict_gop       | boolean     |   X   |   X   | Minimize GOP to GOP rate fluctuations                                          |
 | weighted_pred    | boolean     |   X   |   X   |                                                                                |
 | rc-lookahead     | int         |   X   |   X   | 0 to 27                                                                        |
 | b_adapt          | boolean     |   X   |       | Set this to 0 to disable adaptive B-frame decision when lookahead is enabled   |
 | no-scenecut      | boolean     |   X   |   X   | 1 = Disable adaptive I-frame insertion at scene cuts when using lookahead      |
-
-
-
Only in source/docs/en/1.3.0/technical: video-presets-tunes.markdown
Only in source/docs/en/1.3.0/technical: video-profiles-levels.markdown
diff -ur source/docs/en/1.2.0/technical/video-qsv-options.markdown source/docs/en/1.3.0/technical/video-qsv-options.markdown
--- source/docs/en/1.2.0/technical/video-qsv-options.markdown   2019-11-09 17:18:25.000000000 -0500
+++ source/docs/en/1.3.0/technical/video-qsv-options.markdown   2019-11-09 17:18:39.000000000 -0500
@@ -1,148 +1,20 @@
 ---
 Type:            article
-Title:           Intel QuickSync Encoder Options
+Title:           Intel QuickSync
 Project:         HandBrake
 Project_URL:     https://handbrake.fr/
 Project_Version: 1.2.0
 Language:        English
 Language_Code:   en
-Authors:         [ Scott (s55) ]
+Authors:         [ Bradley Sepos <bradley@bradleysepos.com> (BradleyS), Scott (s55) ]
 Copyright:       2019 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
+Redirect_URL:    video-qsv.html
 ---

-Intel Quick Sync Video Advanced Configuration
-==========================
+CLI guide
+=========

-Using the Advanced Options
---------------
-
-From the command line, you can use the --encopts parameter as follows:
-
-   --encopts="option1=value1:option2=value2"
-
-
-From the graphical user interface, just set the options in the dedicated text box:
-
-   option1=value1:option2=value2
-
-Option Types
---------------
-The following value types are supported (each option only accepts one value type):
-
-- integer
-  A number that can be written without a fractional or decimal component.
-
-- float
-  The finite decimal representation of a real number.
-
-- boolean
-  0 means off (or disabled).
-  1 means on (or enabled).
-
-Available Options
---------------
-
-- target-usage (or tu) <integer>
-  - Sets the trade-off between quality and speed, from 1 (best quality) to 7 (best speed).
-  - Default: 2
-
-- num-ref-frame (or ref) <integer>
-  - Number of reference frames, from 1 to 16.
-  - 0 means unspecified (set at runtime by the implementation).
-  - Default: 0 (unspecified)
-
-- gop-ref-dist <integer>  
-  - Distance between I or P reference frames, from 1 to 16.
-  - -1 means automatic (4 in constant QP mode, 3 otherwise).
-  - 0 means unspecified (set at runtime by the implementation).
-  - 1 means B-frames will not be used.
-  - Default: -1 (automatic)
-  - Note: may be sanitized to a lower value in some cases to avoid hangs.
-
-- gop-pic-size (or keyint) <integer>
-  - Number of pictures within the current GOP (aka "keyframe interval").
-  - -1 means automatic (32 in constant QP mode, 1 second long otherwise).
-  - 0 means unspecified (set at runtime by the implementation).
-  - 1 means only I-frames will be used.
-  - 2 means B-frames will not be used.
-  - Default: -1 (automatic)
-
-- cavlc <boolean>
-  - Use CAVLC instead of CABAC entropy coding. Reduces compression efficiency.
-  - It may improve encoding performance slightly, especially on older hardware.
-  - Note: you can also use ''cabac'' (same as ''cavlc'' with reversed meaning).
-  - Default: 0 (CAVLC off, CABAC on)
-
-- b-pyramid <integer>
-  - Enables or disables "Pyramidal B-frames" which can improve compression efficiency.
-  - It may be incompatible with some playback devices (such as the first generation AppleTV).
-  - Note that this options modifies other parameters (gop-ref-dist, num-ref-frame, gop-pic-size).
-  - -1 means automatic (on in constant QP mode, off otherwise).
-  - 0 means off (disabled).
-  - 1 means on (enabled).
-  - Default: -1 (automatic)
-  - Caveats: requires hardware support (4th gen. Intel Core processor or equivalent), and driver support for version 1.6 of the Media SDK API.
-
-- mbbrc <boolean>
-  - Enables macroblock-level bitrate control that generally improves subjective visual quality.
-  - It may have a negative impact on performance and objective visual quality metrics.
-  - Default: 1 (on)
-  - Note: not compatible with Constant QP or !LookAhead rate control methods (ignored).
-  - Caveats: requires hardware support (4th gen. Intel Core processor or equivalent), and driver support for version 1.6 of the Media SDK API.
-
-- extbrc <boolean>
-  - Use extended bitrate control algorithms.
-  - It generally improves objective visual quality metrics and subjective visual quality,
-  - but can also lead to violation of HRD conformance and may significantly reduce performance.
-  - Default: 0 (off)
-  - Note: not compatible with Constant QP or !LookAhead rate control methods (ignored).
-  - Caveats: requires driver support for version 1.6 of the Media SDK API.
-
-- trellis <integer>
-  - Enables trellis quantization.
-  - 0 means trellis is disabled.
-  - 1 means trellis is enabled for I-frames only.
-  - 2 means trellis is enabled for I and P-frames.
-  - 3 means trellis is enabled for all frames (I, P and B).
-  - Default: 0 (disabled)
-  - Note: ignored if the target-usage is too low (usually, only works in combination with tu=1).
-  - Caveats: requires hardware support (4th gen. Intel Core processor or equivalent), and driver support for version 1.7 of the Media SDK API.
-
-- lookahead (or la) <boolean>
-  - Use the !LookAhead (LA or LA_ICQ) bitrate control algorithm.
-  - Default: 1 (on)
-  - Caveats: requires hardware support (4th gen. Intel Core processor or equivalent), and driver support for version 1.7 (1.8 for LA_ICQ) of the Media SDK API.
-
-- lookahead-depth (or la-depth) <integer>
-  - If !LookAhead bitrate control is enabled, number of frames that are analyzed before encoding, from 11 to 60.
-  - Default: 40
-  - Note: may be sanitized to a lower value in some cases to avoid hangs.
-  - Caveats: requires hardware support (4th gen. Intel Core processor or equivalent), and driver support for version 1.7 of the Media SDK API.
-
-- force-cqp <boolean>
-  - In Constant Quality mode, use Constant QP rate control, even if Intelligent Constant Quality is available.
-  - Default: 0 (ICQ enabled if available)
-
-- cqp-offset-i <integer>   |  cqp-offset-p <integer>  |   cqp-offset-b <integer>
-  - In constant QP (CQP) bitrate control mode, specify offset from the global quality/QP value for I, P and B-frames.
-  - Defaults are 0, 2 and 4, respectively.
-
-- vbv-maxrate <integer>
-  - Sets the maximum rate the VBV buffer should be assumed to refill at, in kilobits per second (Kbps).
-  - Default: 0 (set at runtime by the implementation)
-  - Note: not compatible with Constant QP, Intelligent Constant Quality or !LookAhead rate control methods (ignored).
-
-- vbv-bufsize <integer>
-  - Sets the size of the VBV buffer in kilobits (Kb).
-  - Default: 0 (set at runtime by the implementation)
-  - Note: not compatible with Constant QP, Intelligent Constant Quality or !LookAhead rate control methods (ignored).
-
-- vbv-init <float>
-  - Sets how full the VBV Buffer must be before playback starts.
-  - If it is less than 1, then the initial fill is: vbv-init * vbv-bufsize.
-  - Otherwise it is interpreted as the initial fill in kilobits (Kb).
-  - Default: 0 (set at runtime by the implementation)
-  - Note: not compatible with Constant QP, Intelligent Constant Quality or !LookAhead rate control methods (ignored).
+This article has been moved to [Intel QuickSync Video (QSV)](video-qsv.html).
Only in source/docs/en/1.3.0/technical: video-qsv.markdown
diff -ur source/docs/en/1.2.0/technical/video-vce.markdown source/docs/en/1.3.0/technical/video-vce.markdown
--- source/docs/en/1.2.0/technical/video-vce.markdown   2019-11-09 17:18:25.000000000 -0500
+++ source/docs/en/1.3.0/technical/video-vce.markdown   2019-11-09 17:18:39.000000000 -0500
@@ -1,71 +1,67 @@
 ---
 Type:            article
-Title:           AMD VCE Encoder
+Title:           AMD VCE
 Project:         HandBrake
 Project_URL:     https://handbrake.fr/
 Project_Version: 1.2.0
 Language:        English
 Language_Code:   en
-Authors:         [ Scott (s55) ]
+Authors:         [ Bradley Sepos <bradley@bradleysepos.com> (BradleyS), Scott (s55) ]
 Copyright:       2019 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
 ---

-AMD VCE Encoder
-==========================
+AMD VCE
+=======

-Supported Hardware and Configurations 
---------------
-- AMD Radeon RX 400 Series, Vega or better
-- Windows 10
+## Supported hardware 

-Please note, these are not hard limits and the feature *may* work on older cards and operating systems, but this is not officially supported.
+- AMD Radeon RX 400, 500, Vega/II, Navi series GPU or better
+- Ubuntu Linux 18.04.3 or later, Windows 10

-Enabling support
---------------
-Support for the VCE encoder can be enabled in preferences under the video tab. If your system is not supported, the option will be greyed out.
+Please note, these are not hard limits. Hardware encoding via VCE *might* work on older series GPUs and older operating systems, but this is not officially supported.

+On Ubuntu Linux, [AMD Radeon Software for Linux version 19.20 or later](https://www.amd.com/en/support/kb/release-notes/rn-amdgpu-unified-linux) is required to use the VCE encoder. Install using the `amdgpu-pro-install` script according to AMD’s [installation guide](https://amdgpu-install.readthedocs.io/en/latest/). Additionally, you must manually install the `amf-amdgpu-pro` package included in the download.

-Performance
---------------
-Take note that only the encode portion of the encode pipeline is done on the AMD hardware. 
-Every stage prior and after in the pipeline including (decoding, filters, a/v sync, muxing etc.) all happen on the CPU. As a result, it is normal to have high, or 100% CPU utilisation during encodes. 
+## Enabling support

-It is common, particularly on lower end hardware that the CPU may be a bottleneck for the encoder. To minimise this effect, turn off any filters that you do not require. 
+Support for the AMD VCE encoder is enabled in preferences on the video tab. If your system is not supported, the option will be disabled.

+## Performance

-Using the Advanced Options
---------------
-VCE does have a limited set of advanced encoder options that can be used.  Generally speaking is is not recommended to change these parameters. The built-in presets offer a good range of options.
+Only video encoding is performed by the hardware encoder. Every stage prior to and after video encoding including decoding, filters, audio/video sync, audio encoding, muxing, etc., is performed by the CPU. As a result, it is normal to have high (even 100%) CPU utilisation during encodes.

-From the command line, you can use the --encopts parameter as follows:
+It is common, particularly on lower-end hardware, for the CPU to be a bottleneck for the hardware video encoder. To minimize this effect, disable any filters that you do not require.

-    --encopts="option1=value1:option2=value2"
+## Advanced options
+
+The AMD VCE hardware encoder has a limited set of advanced encoder options. Generally speaking, it is not recommended to change these parameters, as the built-in presets offer a good range of options for common uses.
+
+From HandBrake’s command line interface, use the `--encopts` parameter as follows:

+    --encopts="option1=value1:option2=value2"

-From the graphical user interface, just set the options in the dedicated options text box on the Video tab.
+From HandBrake’s graphical interface, set the options in the `Advanced Options` field on the `Video` tab:

     option1=value1:option2=value2

-Option Types
---------------
+### Option value types
+
 The following value types are supported (each option only accepts one value type):

-- integer
+- integer  
   A number that can be written without a fractional or decimal component.

-- boolean
-  0 means off (or disabled).
+- boolean  
+  0 means off (or disabled).  
   1 means on (or enabled).

-- string
-  Takes a setting defined as s string. See comment for details. 
-
+- string  
+  An alphanumeric string of characters. See the option’s comments for acceptable values.

-Available Options
---------------
+### Options list

 | Option           | Type        | H.264 | H.265 | Comment                                                                        |
 |------------------|-------------|------------------------------------------------------------------------------------------------|
Only in source/docs/en/1.3.0/technical: video-videotoolbox.markdown
Only in source/docs/en/1.2.0/technical: video-x264-presets-tunes.markdown
Only in source/docs/en/1.2.0/technical: video-x264-profiles-levels.markdown
bradleysepos commented 4 years ago

Ping @raderb. 😸

raderb commented 4 years ago

Ah a new release :D. Thanks for the diff, I will start working on it as soon as I have the time.

bradleysepos commented 4 years ago

Thanks, no rush!

raderb commented 4 years ago

Updated documentation in PR #93