search

HandBrake / HandBrake-docs

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

Update German documentation for HandBrake 1.5.0. #157

Closed bradleysepos closed 2 years ago

bradleysepos commented 2 years ago

Our German translator has stepped aside due to Real Life™. If anyone would like to pick this up, here are the English documentation changes between 1.3.0 and 1.5.0.

Search for "Only in" for lines indicating added/removed files, there are a few. Please make edits to source/docs/de/1.5.0/* and submit your changes as one or more pull requests. Thanks! 😸

Only in source/docs/en/1.3.0/advanced: audio-defaults.markdown
diff -ur source/docs/en/1.3.0/advanced/audio-subtitle-defaults.markdown source/docs/en/1.5.0/advanced/audio-subtitle-defaults.markdown
--- source/docs/en/1.3.0/advanced/audio-subtitle-defaults.markdown  2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/advanced/audio-subtitle-defaults.markdown  2022-01-18 04:50:48.000000000 -0500
@@ -19,11 +19,18 @@

 Instead, we store behaviour rules for automatically selecting audio and subtitle tracks each time you scan a new source or select a title.

-In order to configure the track selection behaviour, click the "Configure Defaults" button on the Audio or Subtitle Defaults tab.
+In order to configure the track selection behaviour, click the "Selection Behaviour" button on the Audio or Subtitle Defaults tab.
+
+![Audio Defaults Access Button](../../images/windows/audio-configure-defaults-button-win-1.4.0.png "Audio Defaults Window")

 ### Audio Defaults

-![Audio Defaults Window](../../images/windows/audio-defaults-1.0.0.png "Audio Defaults Window")
+<!-- .system-macos -->
+![Audio Defaults Window](../../images/mac/audio-defaults-mac-1.4.0.png "Audio Defaults Window")
+<!-- /.system-macos -->
+<!-- .system-windows -->
+![Audio Defaults Window](../../images/windows/audio-defaults-win-1.4.0.png "Audio Defaults Window")
+<!-- /.system-windows -->

 - Track Selection Behaviour
   - None
@@ -32,17 +39,28 @@
     - The first track that matches the each of the languages in the "Chosen Languages", otherwise the first track will be selected.
   - All matching selected languages
     - All the tracks that match the "Chosen Languages".
-- Choose Languages
-  - Move any languages you are interested in into the "Chosen Languages" list in order to have tracks selected based on the track selection behaviour.
+    
+- Languages
+  - Select the languages you wish to encode. Note that not all sources will have track languages. You may also have to use the "Unknown" option or "Any" options to have tracks added in that case.
+
 - Auto Passthru
   - HandBrake can pass thru several different audio formats. There are separate options the audio encoder dropdown for these. When you select "Auto Passthru", it will pass thru any of those supported types.  You can limit what it will automatically passthru. For example, if you only ever want AC3 or DTS passthru, but not any of the other choices, untick the relevant checkboxes.

 - Fallback Encoder
   - When you have a passthru encoder selected, if the source track format does not match this format, HandBrake will automatically re-encode the track. The fallback encoder is the default encoder it will fallback to.  
+  
+- Track Layout
+  - You can define the audio tracks you want added for each language in the track entry panel at the bottom of the window.
+  - When selecting a passthru encoder, the Bitrate, mixdown, samplerate controls apply to the fallback encoder should that be used instead of the passthru option selected. 

 ### Subtitle Defaults

-![Subtitle Defaults Window](../../images/windows/subtitle-defaults-1.0.0.png "Subtitle Defaults Window")
+<!-- .system-macos -->
+![Subtitle Defaults Window](../../images/mac/subtitle-defaults-mac-1.4.0.png "Audio Defaults Window")
+<!-- /.system-macos -->
+<!-- .system-windows -->
+![Subtitle Defaults Window](../../images/windows/subtitle-defaults-win-1.4.0.png "Subtitle Defaults Window")
+<!-- /.system-windows -->

 - Track Selection Behaviour
   - None
@@ -51,14 +69,18 @@
     - The first subtitle track for each "Chosen Language" will be added, where supported by the output container. 
   - All matching selected languages
    - All subtitle track(s) for each "Chosen Language" will be added, where supported by the output container. 
+   
 - Burn in Behaviour
   HandBrake can burn in 1 subtitle track to an encoded file. There are 3 behavioural options you can choose from for this checkbox to be automatically selected.
   - Foreign Audio Scan
   - First Track
   - Foreign Audio Preferred, else first
+  
 - Choose Languages
   - Move any languages you are interested in into the "Chosen Languages" list in order to have tracks selected based on the track selection behaviour.
+  
 - Add Closed Captions when available
   - Close captions are text based subtitles supported by both MP4 and MKV. If you select this option, HandBrake will automatically copy them to the output file.
+  
 - Add Foreign Audio Scan
   - HandBrake can perform a scan of the source title / file to try and detect if there is a portions of a title that are in a foreign language. If it detects one, it will add the subtitle track automatically. 
diff -ur source/docs/en/1.3.0/advanced/custom-presets.markdown source/docs/en/1.5.0/advanced/custom-presets.markdown
--- source/docs/en/1.3.0/advanced/custom-presets.markdown   2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/advanced/custom-presets.markdown   2022-01-18 04:50:48.000000000 -0500
@@ -17,13 +17,39 @@

 HandBrake comes with many built-in presets which cover the most common use case scenarios. However there are many scenarios and devices that many not be covered.

-You can create your own presets by clicking the "Add" button on the preset pane.
+On the main window, below the title selection controls, you can click the "Save New Preset" button to create your own preset.

-![Preset Controls](../../images/windows/preset-controls-1.0.0.png "Preset Controls")
+<!-- .system-linux -->
+<!-- /.system-linux -->
+<!-- .system-macos -->
+![macOS Preset Controls](../../images/windows/preset-controls-mac-1.4.0.png "Preset Controls (macOS)")
+<!-- /.system-macos -->
+<!-- .system-windows -->
+![Windows Preset Controls](../../images/windows/preset-controls-win-1.4.0.png "Preset Controls (Windows)")
+<!-- /.system-windows -->

 When you've pressed this button, you'll see the following window appear:

-![Preset Add Window](../../images/windows/add-preset-1.0.0.png "Preset Add Window")
+<!-- .system-macos -->
+![macOS Add Preset](../../images/windows/add-preset-mac-1.4.0.png "Add Preset (macOS)")
+<!-- /.system-macos -->
+<!-- .system-windows -->
+![Windows Add Prese](../../images/windows/add-preset-win-1.4.0.png "Add Preset (Windows)")
+<!-- /.system-windows -->

-When you press save, HandBrake will use the default behaviour  rules you've set and any settings from the main window just before you pressed "Add Preset".
+Pressing "add" will save a new preset with the details you've entered based on the settings that are currently on the main window. 
+
+
+## Audio and Subtitles Beavhiours 
+
+Audio and Subtitle settings are special. The preset does not store selected audio and subtitle tracks from the main window. It uses rules to automatically select them for each new source or title that you selected.
+You can modify these rules by editing the settings on the relevant "selection behaviour" screen.
+
+Please note, these rules do not cover all possible use cases. If the behaviours don't meet your requirements, audio and subtitle tracks will need to be handled manually after you've scanned a source. 
+
+For more information, please see [Audio and Subtitle Defaults](../workflow/audio-subtitle-defaults.html).
+
+## Default Preset
+
+If you regularly use the same preset, you can make it the default preset that HandBrake starts with by selecting the "Make Default" (macOS) or "Set Current as Default" (Window) option in the presets menu or by using the preset manager accessed via the toolbar.

diff -ur source/docs/en/1.3.0/advanced/resizing-video.markdown source/docs/en/1.5.0/advanced/resizing-video.markdown
--- source/docs/en/1.3.0/advanced/resizing-video.markdown   2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/advanced/resizing-video.markdown   2022-01-18 04:50:48.000000000 -0500
@@ -19,32 +19,22 @@

 The picture settings tab is located on HandBrake's main window and becomes active after you've scanned a source.

-![Picture settings tab](../../images/windows/picture-settings-1.0.0.png "Picture settings tab")
+![Picture settings tab](../../images/windows/picture-settings-win-1.4.0.png "Picture settings tab")

-### Width and Height
-
-These allow you to adjust the size of the output.  When you press the up or down arrows, the number will jump by the number selected in the "Modulus" dropdown.
-
-When anamorphic strict is selected, both the "width" and "height" boxes will be disabled. You will get the maximum source size as output.
-
-When loose is selected, you can downscale with the "width" or leave at the source width.
-
-When none is selected, you can alter both "width" and "height"
-
-### Modulus
+### Anamorphic

-The width and height must be divisible by this number. It's best left at 2, but if you have a problematic player, you can try setting it to 16.
+Typically recommended that you leave this on "automatic". If your source is not anamorphic, having this set to an anamorphic option will not affect the output. Thus, it is safe to leave on.

-### Anamorphic
+When "Automatic" is selected, HandBrake will maximise the output size of the video, up to the source resolution or set "Resolution Limit".

-Typically recommended that you leave this on "loose". If your source is not anamorphic, having this set to an anamorphic option will not affect the output. Thus, it is safe to leave on.
+When "Off" is selected along with unchecking "Optimal Size", you can alter both "width" and "height". Otherwise, the source size, or resolution limit will be used. 

-## Upscaling
+When "Custom" is selected, you have full control of the output dimensions. 

-The HandBrake GUI's do not allow upscaling. Most of the time this is a bad idea as it reduces (not increases) the quality of your source file along with increasing the final file size. This is less than ideal. Most of the time, letting the playback device or software upscale to your screen size is much better. You don't gain anything by upscaling with HandBrake.
+### Upscaling

-In the very rare cases that this is needed, it can be done with the command line interface with the --width and --height options.
-Typically you would only use this if the software or hardware you're using has a problematic or broken scaler.
+While upscaling is NOT recommended, there are some instances where it is useful (i.e. uploading to YouTube). To enable this, check the "Allow upscaling" checkbox. 
+The "Resolution Limit" will still be honoured. 

 ## Cropping

@@ -54,7 +44,7 @@

 You can preview the effect of your adjustments by clicking the "Preview" button on the toolbar.

-![HandBrake toolbar](../../images/windows/toolbar-1.0.0.png "HandBrake toolbar")
+![HandBrake toolbar](../../images/windows/toolbar-win-1.4.0.png "HandBrake toolbar")

 The preview window will then appear and will display in real-time any changes you make on the picture settings screen.
 If the size of the output exceeds the window size, the preview window will scale it to fit to screen.
diff -ur source/docs/en/1.3.0/advanced/surround-sound.markdown source/docs/en/1.5.0/advanced/surround-sound.markdown
--- source/docs/en/1.3.0/advanced/surround-sound.markdown   2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/advanced/surround-sound.markdown   2022-01-18 04:50:48.000000000 -0500
@@ -52,3 +52,4 @@
 - FLAC   (MKV files only)
 - AAC
 - MP3
+- MP2
Only in source/docs/en/1.3.0/advanced: video-sources.markdown
diff -ur source/docs/en/1.3.0/cli/cli-options.markdown source/docs/en/1.5.0/cli/cli-options.markdown
--- source/docs/en/1.3.0/cli/cli-options.markdown   2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/cli/cli-options.markdown   2022-01-18 04:50:48.000000000 -0500
@@ -39,7 +39,7 @@

 HandBrakeCLI -i /path/to/source -o ../Desktop/my_output.mp4

-If HandBrake is in a different directory than your in, you can always access it via the full path. i.en
+If HandBrake is in a different directory than you're in, you can always access it via the full path. i.e.

 ./path/to/HandBrakeCLI -i /path/to/source -o ../Desktop/my_output.mp4

diff -ur source/docs/en/1.3.0/cli/command-line-reference.markdown source/docs/en/1.5.0/cli/command-line-reference.markdown
--- source/docs/en/1.3.0/cli/command-line-reference.markdown    2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/cli/command-line-reference.markdown    2022-01-18 04:50:48.000000000 -0500
@@ -16,6 +16,9 @@
 ======================

 The following details all the available options in the command line interface. This information may be accessed at any time by running `HandBrakeCLI --help`.
+Please run this command on your own system as available options may vary depending on operating system and system hardware. 
+
+For reference, the following was generated by the Windows version of HandBrakeCLI: 

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

@@ -75,11 +78,13 @@
                                Start encoding at a given offset in seconds,
                                frames, or pts (on a 90kHz clock)
                                (e.g. seconds:10, frames:300, pts:900000).
+                               Units must match --stop-at units, if specified.
        --stop-at  <string:number>
                                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.
+                               Units must match --start-at units, if specified.

     Destination Options ----------------------------------------------------------
@@ -110,9 +115,11 @@
        -e, --encoder <string>  Select video encoder:
                                    x264
                                    x264_10bit
+                                   nvenc_h264
                                    x265
                                    x265_10bit
                                    x265_12bit
+                                   nvenc_h265
                                    mpeg4
                                    mpeg2
                                    VP8
@@ -194,8 +201,7 @@
                                Multiple output tracks can be used for one input.
        -E, --aencoder <string> Select audio encoder(s):
                                    none
-                                   ca_aac
-                                   ca_haac
+                                   av_aac
                                    copy:aac
                                    ac3
                                    copy:ac3
@@ -204,6 +210,7 @@
                                    copy:truehd
                                    copy:dts
                                    copy:dtshd
+                                   copy:mp2
                                    mp3
                                    copy:mp3
                                    vorbis
@@ -217,13 +224,13 @@
                                is supported for the audio type.
                                Separate tracks by commas.
                                Defaults:
-                                   av_mp4   ca_aac
-                                   av_mkv   ca_aac
+                                   av_mp4   av_aac
+                                   av_mkv   mp3
                                    av_webm  vorbis
            --audio-copy-mask <string>
                                Set audio codecs that are permitted when the
                                "copy" audio encoder option is specified
-                               (aac/ac3/eac3/truehd/dts/dtshd/mp3/flac)
+                               (aac/ac3/eac3/truehd/dts/dtshd/mp2/mp3/flac)
                                Separated by commas for multiple allowed options.
            --audio-fallback <string>
                                Set audio codec to use when it is not possible
@@ -251,8 +258,7 @@
                                Separate tracks by commas.
                                Defaults:
                                    none             up to dpl2
-                                   ca_aac           up to 7point1
-                                   ca_haac          up to 7point1
+                                   av_aac           up to 7point1
                                    ac3              up to 5point1
                                    eac3             up to 5point1
                                    mp3              up to dpl2
@@ -286,25 +292,7 @@
                                    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.

@@ -349,6 +337,7 @@
                                (default: set by preset, typically 2)
        -M, --color-matrix <string>
                                Set the color space signaled by the output:
+                               Overrides color signalling with no conversion.
                                    2020
                                    709
                                    601
@@ -462,6 +451,29 @@
                                    sprite
                                Applies to NLMeans presets only (does not affect
                                custom settings)
+       --chroma-smooth[=string]      Sharpen video with chroma smooth filter
+                               Presets:
+                                   ultralight
+                                   light
+                                   medium
+                                   strong
+                                   stronger
+                                   verystrong
+                               Custom Format:
+                                   cb-strength=c:cb-size=c:cr-strength=c:cr-size=c
+                               Default:
+                                   cb-strength=1.2:cb-size=7
+       --no-chroma-smooth            Disable preset chroma smooth filter
+       --chroma-smooth-tune <string> Tune chroma smooth filter
+                               Tunes:
+                                   none
+                                   tiny
+                                   small
+                                   medium
+                                   wide
+                                   verywide
+                                     Applies to chroma smooth presets only (does
+                                     not affect custom settings)
        --unsharp[=string]      Sharpen video with unsharp filter
                                Presets:
                                    ultralight
@@ -512,12 +524,27 @@
                                    sprite
                                Applies to lapsharp presets only (does not affect
                                custom settings)
-       -7, --deblock[=string]  Deblock video with pp7 filter
+       -7, --deblock[=string]  Deblock video with avfilter deblock
+                               Presets:
+                                   ultralight
+                                   light
+                                   medium
+                                   strong
+                                   stronger
+                                   verystrong
                                Custom Format:
-                                   qp=q:mode=m:disable=d
+                                   strength=s:thresh=t:blocksize=b:disable=d
                                Default:
-                                   qp=5
+                                   strength=strong:thresh=20
        --no-deblock            Disable preset deblock filter
+       --deblock-tune <string>
+                               Tune deblock filter
+                               Tunes:
+                                   small
+                                   medium
+                                   large
+                               Applies to deblock presets only (does not affect
+                               custom settings)
        --rotate[=string]       Rotate image or flip its axes.
                                angle rotates clockwise, can be one of:
                                    0, 90, 180, 270
@@ -531,7 +558,17 @@
                                Color may be an HTML color name or RGB value.
                                The position of image in pad may also be set.
                                Custom Format:
-                                   width=w:height=h:color=c:x=x:y=y
+                                   width=w:height=h:color=c:x=x:y=y:top=t:bottom=b:
+                                   left=l:right=r
+       --colorspace <string>   Convert colorspace, transfer characteristics or color primaries.
+                               Presets:
+                                   bt2020
+                                   bt709
+                                   bt601-6-525
+                                   bt601-6-625
+                               Custom Format:
+                                   primaries=p:transfer=t:matrix=m:range=r:
+                                   tonemap=t:param=p:desat=d
        -g, --grayscale         Grayscale encoding
        --no-grayscale          Disable preset 'grayscale'

diff -ur source/docs/en/1.3.0/developer/build-bsd.markdown source/docs/en/1.5.0/developer/build-bsd.markdown
--- source/docs/en/1.3.0/developer/build-bsd.markdown   2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/developer/build-bsd.markdown   2022-01-18 04:50:48.000000000 -0500
@@ -22,6 +22,7 @@
 Dependency installation instructions are available for the following distributions.

 - [FreeBSD](install-dependencies-freebsd.html)
+- [NetBSD](install-dependencies-netbsd.html)

 ## Building HandBrake

@@ -29,12 +30,12 @@

     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.
+List available tags in the HandBrake 1.5.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)
+    git tag --list | grep ^1\.5\.
+    git checkout refs/tags/$(git tag -l | grep -E '^1\.5\.[0-9]+$' | tail -n 1)

-Build HandBrake. 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=$(sysctl -n hw.ncpu) --launch

diff -ur source/docs/en/1.3.0/developer/build-linux.markdown source/docs/en/1.5.0/developer/build-linux.markdown
--- source/docs/en/1.3.0/developer/build-linux.markdown 2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/developer/build-linux.markdown 2022-01-18 04:50:48.000000000 -0500
@@ -28,6 +28,7 @@
 - [Fedora](install-dependencies-fedora.html)
 - [Gentoo](install-dependencies-gentoo.html)
 - [Ubuntu](install-dependencies-ubuntu.html)
+- [Void](install-dependencies-void.html)

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

@@ -37,10 +38,10 @@

     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.
+List available tags in the HandBrake 1.5.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)
+    git tag --list | grep ^1\.5\.
+    git checkout refs/tags/$(git tag -l | grep -E '^1\.5\.[0-9]+$' | tail -n 1)

 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`.

@@ -51,6 +52,10 @@
 Install HandBrake (optional). When installing the graphical interface, icon and desktop files for the Applications menu will be also installed.

     sudo make --directory=build install
+    
+If you wish to then uninstall
+    
+    sudo make --directory=build uninstall

 To start over, simply remove the `build` directory.

diff -ur source/docs/en/1.3.0/developer/build-mac.markdown source/docs/en/1.5.0/developer/build-mac.markdown
--- source/docs/en/1.3.0/developer/build-mac.markdown   2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/developer/build-mac.markdown   2022-01-18 04:50:48.000000000 -0500
@@ -52,10 +52,14 @@

     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.
+List available tags in the HandBrake 1.5.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)
+    git tag --list | grep ^1\.5\.
+    git checkout refs/tags/$(git tag -l | grep -E '^1\.5\.[0-9]+$' | tail -n 1)
+
+Initialize and update all submodules.
+
+    git submodule update --init --recursive

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

diff -ur source/docs/en/1.3.0/developer/build-windows.markdown source/docs/en/1.5.0/developer/build-windows.markdown
--- source/docs/en/1.3.0/developer/build-windows.markdown   2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/developer/build-windows.markdown   2022-01-18 04:50:48.000000000 -0500
@@ -17,48 +17,12 @@

 ## 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. 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.
-
-### Installing dependencies on Fedora
-
-The following instructions are for [Fedora](https://getfedora.org) 30 through 32.
-
-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
-
+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 20.04 LTS 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.

 ### Installing dependencies on Ubuntu

-The following instructions are for [Ubuntu](https://www.ubuntu.com) 18.04 LTS (Bionic Beaver) through 20.04 (Focal Fossa).
+The following instructions are for [Ubuntu](https://www.ubuntu.com) 20.04 (Focal Fossa).
+These should also work with Windows Subsystem for Linux.

 Basic requirements to run commands:

@@ -77,6 +41,7 @@
 - libtool-bin
 - m4
 - make
+- meson
 - nasm
 - ninja-build
 - patch
@@ -85,15 +50,6 @@
 - tar
 - 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
@@ -107,16 +63,7 @@
 Install dependencies.

     sudo apt-get update
-    sudo apt-get install automake autoconf autopoint build-essential cmake gcc git intltool libtool libtool-bin 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
+    sudo apt-get install automake autoconf autopoint build-essential cmake gcc git intltool libtool libtool-bin m4 make meson nasm ninja-build patch pkg-config python tar zlib1g-dev

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

@@ -129,10 +76,10 @@

     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.
+List available tags in the HandBrake 1.5.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)
+    git tag --list | grep ^1\.5\.
+    git checkout refs/tags/$(git tag -l | grep -E '^1\.5\.[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.

@@ -160,11 +107,9 @@
   - [Source Tree](https://www.sourcetreeapp.com) (recommended)
   - Client included with Visual Studio 2015 or later
 - `hb.dll` (see the LibHB build instructions preceding these, or download from [https://handbrake.fr/nightly.php](https://handbrake.fr/nightly.php))
-- [JetBrains ReSharper](https://www.jetbrains.com/?from=HandBrake) (optional)
-  - 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 of JetBrains

-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.
+
+Clone `https://github.com/HandBrake/HandBrake.git` using your git client.

 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.3.0/developer/install-dependencies-arch.markdown source/docs/en/1.5.0/developer/install-dependencies-arch.markdown
--- source/docs/en/1.3.0/developer/install-dependencies-arch.markdown   2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/developer/install-dependencies-arch.markdown   2022-01-18 04:50:48.000000000 -0500
@@ -35,6 +35,7 @@
 - lame
 - libass
 - libbluray
+- libjpeg-turbo
 - libogg
 - libsamplerate
 - libtheora
@@ -69,7 +70,7 @@

 Install dependencies.

-    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 xz
+    sudo pacman -S base-devel cmake flac fontconfig freetype2 fribidi git harfbuzz jansson lame libass libbluray libjpeg-turbo libogg libsamplerate libtheora libvorbis libvpx libxml2 meson nasm ninja numactl opus python2 speex x264 xz

 To build with Intel Quick Sync Video support, install the QSV dependencies.

diff -ur source/docs/en/1.3.0/developer/install-dependencies-centos.markdown source/docs/en/1.5.0/developer/install-dependencies-centos.markdown
--- source/docs/en/1.3.0/developer/install-dependencies-centos.markdown 2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/developer/install-dependencies-centos.markdown 2022-01-18 04:50:48.000000000 -0500
@@ -50,6 +50,7 @@
 - ninja-build [PowerTools]
 - opus-devel [PowerTools]
 - speex-devel [PowerTools]
+- turbojpeg-devel [PowerTools]
 - x264-devel [RPM Fusion]

 Intel Quick Sync Video dependencies (optional):
@@ -80,7 +81,7 @@
 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 libvpx-devel meson nasm ninja-build opus-devel speex-devel
+    sudo dnf install lame-devel libogg-devel libsamplerate-devel libtheora-devel libvorbis-devel libvpx-devel meson nasm ninja-build opus-devel speex-devel turbojpeg-devel

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

@@ -101,157 +102,3 @@
     sudo dnf install dbus-glib-devel gstreamer1-devel gstreamer1-libav gstreamer1-plugins-base-devel intltool libgudev1-devel libnotify-devel webkit2gtk3-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.
-
-Basic requirements to run commands:
-
-- curl
-- sudo (for normal user accounts)
-
-Dependencies:
-
-- Development Tools
-- bzip2-devel
-- cmake
-- fribidi-devel
-- git
-- jansson-devel
-- libogg-devel
-- libsamplerate-devel
-- libtheora-devel
-- libvorbis-devel
-- libxml2-devel
-- numactl-devel
-- python3
-- speex-devel
-- xz-devel
-
-Additional dependencies not available in the base repository:
-
-- devtoolset-7 [SCL] (optional/recommended for HandBrake [CLI](abbr:Command Line Interface))
-- lame-devel [EPEL]
-- libass-devel [EPEL]
-- libvpx
-- meson [EPEL]
-- nasm [NASM]
-- ninja-build [EPEL]
-- opus-devel [EPEL EL6]
-- x264-devel [RPM Fusion]
-
-Intel Quick Sync Video dependencies (optional):
-
-- libva-devel
-- libdrm-devel
-
-Graphical interface dependencies:
-
-- dbus-glib-devel
-- gstreamer1-devel
-- gstreamer1-plugins-base-devel
-- intltool
-- libgudev1-devel
-- libnotify-devel
-- webkitgtk4-devel
-
-Additional graphical interface dependencies not available in the base repository:
-
-- devtoolset-7 [SCL]
-- gstreamer1-libav [RPM Fusion]
-
-Install dependencies.
-
-    sudo yum update
-    sudo yum groupinstall "Development Tools"
-    sudo yum install bzip2-devel cmake fribidi-devel git jansson-devel libogg-devel libsamplerate-devel libtheora-devel libvorbis-devel libxml2-devel numactl-devel python3 speex-devel xz-devel
-
-The `lame-devel` and `x264-devel` packages are now provided by the EPEL and RPM Fusion repositories, respectively. 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
-    sudo yum repo-pkgs zmrepo remove
-    sudo yum remove zmrepo
-
-Install the [EPEL](https://fedoraproject.org/wiki/EPEL) repository and related additional dependencies.
-
-    sudo yum install epel-release
-    sudo yum install lame-devel 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].
-
-    sudo yum localinstall $(curl -L -s 'https://dl.fedoraproject.org/pub/epel/6/x86_64/Packages/o/' | grep -Eo 'opus-[^">]+\.x86_64\.rpm' | sort -u | awk '{ print "https://dl.fedoraproject.org/pub/epel/6/x86_64/Packages/o/"$0 }')
-
-The `nasm` package provided by CentOS 7 is too old. Build and install a newer version from source[^nasm-source].
-
-    # remove old package if installed
-    sudo yum remove nasm
-
-    # nasm
-    sudo curl -LO https://www.nasm.us/pub/nasm/releasebuilds/2.14.02/nasm-2.14.02.tar.bz2
-    tar -xf nasm-2.14.02.tar.bz2
-    cd nasm-2.14.02
-    ./configure
-    make -j$(nproc)
-    sudo make install
-    cd ..
-
-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
-    cd ..
-
-    # 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
-
-Install the [RPM Fusion](http://rpmfusion.org) Free repository and related additional dependencies.
-
-    sudo yum localinstall --nogpgcheck https://download1.rpmfusion.org/free/el/rpmfusion-free-release-7.noarch.rpm
-    sudo yum install x264-devel
-
-To build with Intel Quick Sync Video support, install the QSV dependencies.
-
-    sudo yum install libva-devel libdrm-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
-
-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
-
-    # 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 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-source]: Installing newer packages than those available in the base repository may lead to incompatibility with other software expecting specific package versions.
-
-[^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.
diff -ur source/docs/en/1.3.0/developer/install-dependencies-clear.markdown source/docs/en/1.5.0/developer/install-dependencies-clear.markdown
--- source/docs/en/1.3.0/developer/install-dependencies-clear.markdown  2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/developer/install-dependencies-clear.markdown  2022-01-18 04:50:48.000000000 -0500
@@ -15,7 +15,7 @@
 Installing dependencies on Clear
 ================================

-The following instructions are for [Clear](https://clearlinux.org) 31140 and later.
+The following instructions are for [Clear](https://clearlinux.org) 35470 and later.

 Basic requirements to run commands:

@@ -29,6 +29,7 @@
 - devpkg-fribidi
 - devpkg-jansson
 - devpkg-libass
+- devpkg-libjpeg-turbo
 - devpkg-libogg
 - devpkg-libsamplerate
 - devpkg-libtheora
@@ -54,7 +55,7 @@
 Install dependencies.

     sudo swupd update
-    sudo swupd bundle-add dev-utils dev-utils-dev devpkg-fribidi devpkg-jansson devpkg-libass devpkg-libogg devpkg-libsamplerate devpkg-libtheora devpkg-libvorbis devpkg-libvpx devpkg-opus devpkg-speex
+    sudo swupd bundle-add dev-utils dev-utils-dev devpkg-fribidi devpkg-jansson devpkg-libass devpkg-libjpeg-turbo devpkg-libogg devpkg-libsamplerate devpkg-libtheora devpkg-libvorbis devpkg-libvpx devpkg-opus devpkg-speex

 Build and install the dependencies not available in the base repository.

diff -ur source/docs/en/1.3.0/developer/install-dependencies-debian.markdown source/docs/en/1.5.0/developer/install-dependencies-debian.markdown
--- source/docs/en/1.3.0/developer/install-dependencies-debian.markdown 2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/developer/install-dependencies-debian.markdown 2022-01-18 04:50:48.000000000 -0500
@@ -15,7 +15,7 @@
 Installing dependencies on Debian
 =================================

-The following instructions are for [Debian](https://www.debian.org) 9.12 Stretch through 10.3 Buster.
+The following instructions are for [Debian](https://www.debian.org) 11 Bullseye.

 Basic requirements to run commands:

@@ -24,8 +24,10 @@

 Dependencies:

+- appstream
 - autoconf
 - automake
+- autopoint
 - build-essential
 - cmake
 - git
@@ -46,12 +48,15 @@
 - libtheora-dev
 - libtool
 - libtool-bin
+- libturbojpeg0-dev
 - libvorbis-dev
 - libx264-dev
 - libxml2-dev
 - libvpx-dev
 - m4
 - make
+- meson
+- nasm
 - ninja-build
 - patch
 - pkg-config
@@ -59,16 +64,6 @@
 - tar
 - zlib1g-dev

-Additional Debian 10 dependencies:
-
-- meson
-- nasm
-
-Additional Debian 9 dependencies not available in the base repository:
-
-- meson [backports]
-- nasm [buster]
-
 Intel Quick Sync Video dependencies (optional):

 - libva-dev
@@ -85,27 +80,12 @@
 - libgtk-3-dev
 - libgudev-1.0-dev
 - libnotify-dev
-- libwebkit2gtk-4.0-dev (libwebkitgtk-3.0-dev for Debian 9)
+- libwebkit2gtk-4.0-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 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
-
-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 the Buster (Debian 10) repository[^nasm-newer].
-
-    sudo curl -L 'http://ftp.debian.org/debian/pool/main/n/nasm/nasm_2.14.02-1_amd64.deb' -o /var/cache/apt/archives/nasm_2.14.02-1_amd64.deb
-    sudo dpkg -i /var/cache/apt/archives/nasm_2.14.02-1_amd64.deb
+    sudo apt-get install appstream 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 libturbojpeg0-dev libvorbis-dev libx264-dev libxml2-dev libvpx-dev m4 make meson nasm ninja-build patch pkg-config python tar zlib1g-dev

 To build with Intel Quick Sync Video support, install the QSV dependencies.

@@ -113,9 +93,6 @@

 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
-    sudo apt-get install libwebkit2gtk-4.0-dev || sudo apt-get install libwebkitgtk-3.0-dev
+    sudo apt-get install intltool 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

 Debian is now prepared to build HandBrake. See [Building HandBrake for Linux](build-linux.html) for further instructions.
-
-[^nasm-newer]: Installing newer packages than those available in the base repository may lead to incompatibility with other software expecting specific package versions.
diff -ur source/docs/en/1.3.0/developer/install-dependencies-fedora.markdown source/docs/en/1.5.0/developer/install-dependencies-fedora.markdown
--- source/docs/en/1.3.0/developer/install-dependencies-fedora.markdown 2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/developer/install-dependencies-fedora.markdown 2022-01-18 04:50:48.000000000 -0500
@@ -15,7 +15,7 @@
 Installing dependencies on Fedora
 =================================

-The following instructions are for [Fedora](https://getfedora.org) 30 through 32.
+The following instructions are for [Fedora](https://getfedora.org) 33 through 35.

 Basic requirements to run commands:

@@ -55,6 +55,7 @@
 - python
 - speex-devel
 - tar
+- turbojpeg-devel
 - xz-devel
 - zlib-devel

@@ -84,7 +85,7 @@

     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
+    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 turbojpeg-devel xz-devel zlib-devel

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

diff -ur source/docs/en/1.3.0/developer/install-dependencies-freebsd.markdown source/docs/en/1.5.0/developer/install-dependencies-freebsd.markdown
--- source/docs/en/1.3.0/developer/install-dependencies-freebsd.markdown    2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/developer/install-dependencies-freebsd.markdown    2022-01-18 04:50:48.000000000 -0500
@@ -32,17 +32,16 @@
 - fontconfig
 - freetype2
 - fribidi
-- git
 - gcc
-- m4
+- git
 - gmake
-- patch
 - gtar
 - harfbuzz
 - jansson
 - lame (source port)
 - libass
 - libiconv
+- libjpeg-turbo
 - libogg
 - libsamplerate
 - libtheora
@@ -52,14 +51,20 @@
 - libx264
 - libxml2
 - lzma
+- m4
 - meson
 - nasm
 - ninja
 - opus
+- patch
 - pkgconf
 - python
 - speex

+Intel Quick Sync Video dependencies (optional):
+
+- intel-media-sdk
+
 Graphical interface dependencies:

 - atk
@@ -81,7 +86,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 libvpx libx264 libxml2 meson nasm ninja opus pkgconf python speex
+    sudo pkg install autoconf automake bash bzip2 cmake flac fontconfig freetype2 fribidi gcc git lzma gmake gtar harfbuzz jansson libass libiconv libjpeg-turbo libogg libsamplerate libtheora libtool libvorbis libvpx libx264 libxml2 m4 meson nasm ninja opus patch pkgconf python speex

 Build and install the `lame` source port.

@@ -93,6 +98,10 @@
     sudo make install || sudo make reinstall
     cd "$LASTDIR"

+To build with Intel Quick Sync Video support, install the QSV dependencies.
+
+    sudo pkg install intel-media-sdk
+
 To build the GTK [GUI](abbr:Graphical User Interface), install the graphical interface dependencies.

     sudo pkg install atk cairo dbus dbus-glib desktop-file-utils gdk-pixbuf2 gettext glib gnome3 gstreamer1-plugins-gdkpixbuf gtk3 intltool libdvdcss libnotify libvpx pango
diff -ur source/docs/en/1.3.0/developer/install-dependencies-gentoo.markdown source/docs/en/1.5.0/developer/install-dependencies-gentoo.markdown
--- source/docs/en/1.3.0/developer/install-dependencies-gentoo.markdown 2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/developer/install-dependencies-gentoo.markdown 2022-01-18 04:50:48.000000000 -0500
@@ -29,6 +29,7 @@
 - jansson
 - lame
 - libass
+- libjpeg-turbo
 - libogg
 - libsamplerate
 - libtheora
@@ -45,7 +46,7 @@

 Install dependencies.

-    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
+    sudo emerge --ask fribidi dev-vcs/git harfbuzz jansson lame libass libjpeg-turbo 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.

Only in source/docs/en/1.5.0/developer: install-dependencies-netbsd.markdown
diff -ur source/docs/en/1.3.0/developer/install-dependencies-ubuntu.markdown source/docs/en/1.5.0/developer/install-dependencies-ubuntu.markdown
--- source/docs/en/1.3.0/developer/install-dependencies-ubuntu.markdown 2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/developer/install-dependencies-ubuntu.markdown 2022-01-18 04:50:48.000000000 -0500
@@ -15,7 +15,7 @@
 Installing dependencies on Ubuntu
 =================================

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

 Basic requirements to run commands:

@@ -26,6 +26,7 @@
 - autoconf
 - automake
 - autopoint
+- appstream
 - build-essential
 - cmake
 - git
@@ -46,12 +47,14 @@
 - libtheora-dev
 - libtool
 - libtool-bin
+- libturbojpeg0-dev
 - libvorbis-dev
 - libx264-dev
 - libxml2-dev
 - libvpx-dev
 - m4
 - make
+- meson
 - nasm
 - ninja-build
 - patch
@@ -60,15 +63,6 @@
 - tar
 - zlib1g-dev

-Additional dependencies for Ubuntu 18.10 and later:
-
-- meson
-
-Additional Ubuntu 18.04 LTS dependencies:
-
-- python3-pip
-- meson (via pip3)
-
 Intel Quick Sync Video dependencies (optional):

 - libva-dev
@@ -91,16 +85,7 @@
 Install dependencies.

     sudo apt-get update
-    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
+    sudo apt-get install autoconf automake autopoint appstream 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 libturbojpeg0-dev libvorbis-dev libx264-dev libxml2-dev libvpx-dev m4 make meson nasm ninja-build patch pkg-config python tar zlib1g-dev

 To build with Intel Quick Sync Video support, install the QSV dependencies.

Only in source/docs/en/1.5.0/developer: install-dependencies-void.markdown
diff -ur source/docs/en/1.3.0/get-handbrake/check-for-updates.markdown source/docs/en/1.5.0/get-handbrake/check-for-updates.markdown
--- source/docs/en/1.3.0/get-handbrake/check-for-updates.markdown   2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/get-handbrake/check-for-updates.markdown   2022-01-18 04:50:48.000000000 -0500
@@ -23,7 +23,7 @@

 ## Updating HandBrake on Linux

-The Linux version of HandBrake does not have a built-in update checking feature. Your Linux distribution's package manager will handle any updates to the official PPA.
+The Linux version of HandBrake does not have a built-in update checking feature. Updates are provided via FlatPak bundles. 

 <!-- /.system-linux -->
 <!-- .system-macos -->
diff -ur source/docs/en/1.3.0/get-handbrake/download-and-install.markdown source/docs/en/1.5.0/get-handbrake/download-and-install.markdown
--- source/docs/en/1.3.0/get-handbrake/download-and-install.markdown    2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/get-handbrake/download-and-install.markdown    2022-01-18 04:50:48.000000000 -0500
@@ -25,7 +25,7 @@

 To download HandBrake to your computer, click the download button on the HandBrake website's [Home page](https://handbrake.fr/). You can also choose a version for a specific operating system from the [Downloads page](https://handbrake.fr/downloads.php).

-Experienced users may wish to try HandBrake's [nightly builds](https://handbrake.fr/nightly.php)[^nightly-builds].
+Experienced users may wish to try HandBrake's [development snapshot builds](https://github.com/HandBrake/HandBrake-snapshots)[^nightly-builds] that are available via GitHub.

 ## Verifying your download

@@ -35,7 +35,7 @@

 <!-- .system-linux -->

-When installing on Linux using the official PPA, download integrity is verified automatically. Similarly, the integrity of source code managed using `git` is verified automatically.
+When installing on Linux from Flathub, download integrity is verified automatically. Similarly, the integrity of source code managed using `git` is verified automatically.

 To verify an official source distribution tarball or Flatpak bundle, consult your Linux distribution's documentation for instructions on how to verify checksums.

@@ -45,7 +45,7 @@

 On Mac, launch Terminal from your Applications > Utilities folder and use the `shasum` command. For example, if you downloaded HandBrake to your Downloads folder:

-    shasum -a 1 ~/Downloads/HandBrake-*.dmg && shasum -a 256 ~/Downloads/HandBrake-*.dmg
+    shasum -a 256 ~/Downloads/HandBrake-*.dmg

 Alternatively, the free third-party app [Hashsum](https://itunes.apple.com/us/app/hashsum/id1079442694?mt=12) available on the Mac App Store provides a convenient graphical interface for computing file checksums[^third-party-utilities-1].

@@ -53,9 +53,12 @@

 <!-- .system-windows -->

-On Windows, Microsoft provides the [Microsoft File Checksum Integrity Verifier](https://www.microsoft.com/en-us/download/details.aspx?id=11533) command line utility for verifying checksums. Please see the [associated Microsoft help article](https://support.microsoft.com/en-us/help/841290/availability-and-description-of-the-file-checksum-integrity-verifier-utility) for more information and usage instructions.
+On Windows, launch a Command Prompt Window and use the `certutil` command. For example, if you downloaded HandBrake to your Downloads folder:

-Alternatively, free third-party apps [Compute Hash](http://www.subisoft.net/ComputeHash.aspx), [ExactFile](http://www.exactfile.com), and [MultiHasher](http://www.abelhadigital.com/multihasher) for Windows provide convenient graphical interfaces for computing file checksums[^third-party-utilities-2].
+    cd Downloads
+    certUtil -hashfile <filename> SHA256
+    
+Alternatively, free third-party apps [7-Zip](https://www.7-zip.org)  [Compute Hash](http://www.subisoft.net/ComputeHash.aspx), [ExactFile](http://www.exactfile.com), and [MultiHasher](http://www.abelhadigital.com/multihasher) for Windows provide convenient graphical interfaces for computing file checksums[^third-party-utilities-2].

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

@@ -71,48 +74,42 @@

 If you have installed a HandBrake package from your distribution or other third-party package repository, please remove it before proceeding. See the section, *Warning about broken third-party builds* on [Where to get HandBrake](where-to-get-handbrake.html) for more information.

-### Ubuntu PPAs
+### Flathub Flatpak

-The following instructions are for Ubuntu. They may also work on other `deb`-compatible distributions. For other Linux, please compile from the [official source code](https://github.com/HandBrake/HandBrake).
+The most convenient way to install HandBrake and manage updates is to install the release we publish to Flathub. Please see Flathub's Quick Setup page for instructions to enable Flatpak and Flathub on your Linux distribution.

-From the command line, add the [official releases PPA](https://launchpad.net/~stebbins/+archive/ubuntu/handbrake-releases) to your system.
+Once Flathub is enabled on your system, you may install HandBrake directly from Flathub, from the Gnome Software GUI ('gnome-software'), or from the command line.

-    sudo add-apt-repository ppa:stebbins/handbrake-releases
-    sudo apt-get update
+Installing from Flathub and Gnome Software are fairly self explanatory. To install from the command line for system wide use:

-If you prefer HandBrake's nightly builds, add the [official git-snapshots PPA](https://launchpad.net/~stebbins/+archive/ubuntu/handbrake-git-snapshots).
+    flatpak install fr.handbrake.ghb

-    sudo add-apt-repository ppa:stebbins/handbrake-git-snapshots
-    sudo apt-get update
+During install it will ask for your password (assuming you have sudo privilege). Once installed, HandBrake will be available to all users of the system.

-Install HandBrake.
+To install without sudo privileges:

-    sudo apt-get install handbrake-cli handbrake-gtk
+    flatpak --user install fr.handbrake.ghb
+    
+Once installed, HandBrake will only be available to the user that installed it.

-Run `HandBrakeCLI` to use HandBrake on the command line.
+### Flatpak Bundles

-Run `ghb` to launch HandBrake's graphical user interface. You may wish to right-click on the icon and select "Lock to Launcher" for easy access in the future.
-
-### Flatpak bundles
-
-[Flatpak](https://flatpak.org/) bundles of HandBrake for Linux are available on the [HandBrake website](https://handbrake.fr/) and [Flathub](https://flathub.org/).
+Alternatively, you may manually download, verify, and install [Flatpak](https://flatpak.org/) bundles of HandBrake for Linux which are available on the [HandBrake download page](https://handbrake.fr/downloads.php), the [HandBrakeCLI download page](https://handbrake.fr/downloads2.php) or [development snapshot builds page](https://github.com/HandBrake/HandBrake-snapshots)[^nightly-builds].

 Install your distribution's `flatpak` package before running the following commands.

-Install the latest HandBrake release from Flathub.
+Install the latest HandBrake GUI release (after download and verify)

-    flatpak --user install https://flathub.org/repo/appstream/fr.handbrake.ghb.flatpakref
+    flatpak --user install HandBrake-1.4.2-x86_64.flatpak

-You can later update the HandBrake Flatpak to the latest release on Flathub by running the following.
+Install the latest HandBrake CLI release (after download and verify)

-    flatpak --user update fr.handbrake.ghb
+    flatpak --user install HandBrakeCLI-1.4.2-x86_64.flatpak

-If you prefer HandBrake's nightly builds, download and install the latest available version (requires your distribution's `curl` package).
+Install the nightly build (example, filename changes nightly)

-    curl -O https://nightly.handbrake.fr/HandBrake-latest-master-x86_64.flatpak
-    flatpak install HandBrake-latest-master-x86_64.flatpak
-
-Run `flatpak run fr.handbrake.ghb` to launch HandBrake's graphical user interface, or `flatpak run --command=HandBrakeCLI fr.handbrake.ghb` to use HandBrake on the command line.
+    Download the latest snapshot from the [development snapshot builds](https://github.com/HandBrake/HandBrake-snapshots)[^nightly-builds]
+    flatpak --user install fr.handbrake.ghb-20210720182537-a01549c9c-master-x86_64.flatpak

 <!-- /.system-linux -->
 <!-- .system-macos -->
@@ -148,27 +145,48 @@

 You will find shortcuts for launching HandBrake placed on both the Windows Desktop and Start Menu.

-### Windows SmartScreen
+<!-- /.system-windows -->

-When installing on Windows 8.1 or 10 with Windows SmartScreen enabled, you may see a message indicating that the HandBrake installer is not recognized by Windows.
+## Launching HandBrake

-![Windows SmartScreen](../../images/windows/smartscreen-1-1.0.0.png "Windows SmartScreen may present this message. Select More info to see more options.")
+You may launch HandBrake by quickly clicking twice (double-clicking) on the cocktail & pineapple icon. Depending on your system settings, a single click may suffice.

-HandBrake is not "signed" by Microsoft. This message doesn't mean anything is wrong; rather, it indicates that HandBrake is not part of Microsoft's paid program to validate Windows applications.
+![HandBrake icon](../../images/icon-1.1.0.png)![Double-clicking HandBrake icon](../../images/icon-click-1.1.0.gif)

-By selecting `More info`, you will be able to select `Run anyway` to continue the installation.
+<!-- .continue -->

-![Windows SmartScreen - Run Anyway](../../images/windows/smartscreen-2-1.0.0.png "Select Run anyway to dismiss the SmartScreen message and continue installing HandBrake.")

-<!-- /.system-windows -->
+<!-- .system-linux -->
+### Launching HandBrake Flatpak from the command line

-## Launching HandBrake
+To launch the HandBrake GUI from the command line

-You may launch HandBrake by quickly clicking twice (double-clicking) on the cocktail & pineapple icon. Depending on your system settings, a single click may suffice.
+    flatpak run fr.handbrake.ghb

-![HandBrake icon](../../images/icon-1.1.0.png)![Double-clicking HandBrake icon](../../images/icon-click-1.1.0.gif)
+The HandBrake GUI Flatpak package also includes the CLI which may be run with
+
+    flatpak run --command=HandBrakeCLI fr.handbrake.ghb
+
+Additional HandBrakeCLI options go at the end of the above command line.
+
+If you installed the stand-alone HandBrakeCLI Flatpak package, it can be run with
+
+    flatpak run fr.handbrake.HandBrakeCLI
+
+The developers of Flatpak have also provided some useful helper scripts that get installed whenever a Flatpak package is installed.  Unfortunately, the PATH environment usually does not include the location these are installed to.  If you wish to use these helper scripts, update your PATH (usually performed in a shell initialization file such as ~/.bash_profile)
+
+    export PATH=$PATH:$HOME/.local/share/flatpak/exports/bin:/var/lib/flatpak/exports/bin
+
+Once your PATH includes these directories, the GUI may be run with
+
+    fr.handbrake.ghb
+
+And the CLI may be run with
+
+    fr.handbrake.HandBrakeCLI
+
+<!-- /.system-linux -->

-<!-- .continue -->

 ## Next steps

diff -ur source/docs/en/1.3.0/get-handbrake/where-to-get-handbrake.markdown source/docs/en/1.5.0/get-handbrake/where-to-get-handbrake.markdown
--- source/docs/en/1.3.0/get-handbrake/where-to-get-handbrake.markdown  2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/get-handbrake/where-to-get-handbrake.markdown  2022-01-18 04:50:48.000000000 -0500
@@ -17,15 +17,13 @@

 ## HandBrake releases and nightly builds

-Official [HandBrake releases](https://handbrake.fr/downloads.php) and [nightly builds](https://handbrake.fr/nightly.php) are available for Linux, Mac, and Windows.
+Official [HandBrake releases](https://handbrake.fr/downloads.php) and [nightly builds](https://github.com/HandBrake/HandBrake-snapshots) are available for Linux, Mac, and Windows.

 HandBrake is open-source software licensed under the GNU General Public License Version 2 (GPLv2)[^license]. Anyone can download and use HandBrake *for free*.

 <!-- .system-linux -->

-Ubuntu Linux users should install the [official release PPA](https://launchpad.net/~stebbins/+archive/ubuntu/handbrake-releases) or the [official snapshots PPA](https://launchpad.net/~stebbins/+archive/ubuntu/handbrake-git-snapshots). The PPA may work, but is not tested, on other Debian-compatible distributions.
-
-[Nightly builds](https://handbrake.fr/nightly.php) for Linux are also available as Flatpak bundles.
+For linux users, we provide FlatPak bundles which are available for download on our site, or via <a href="https://flathub.org/apps/details/fr.handbrake.ghb">flathub.org</a>

 Users of other BSD- and *nix-like distributions may compile from source.

@@ -62,10 +60,6 @@

 Please **do not** request support for these or any other unofficial versions. The HandBrake Team has zero control over them and therefore cannot provide meaningful support.

-BSD users should compile from the [official source code](https://github.com/HandBrake/HandBrake).
-
-Linux users should install the [official release PPA](https://launchpad.net/~stebbins/+archive/ubuntu/handbrake-releases), install the [official snapshots PPA](https://launchpad.net/~stebbins/+archive/ubuntu/handbrake-releases), or compile from the [official source code](https://github.com/HandBrake/HandBrake).
-
 <!-- /.system-linux -->

 <!-- .continue -->
diff -ur source/docs/en/1.3.0/help/community-support.markdown source/docs/en/1.5.0/help/community-support.markdown
--- source/docs/en/1.3.0/help/community-support.markdown    2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/help/community-support.markdown    2022-01-18 04:50:48.000000000 -0500
@@ -35,8 +35,9 @@

 ## IRC discussion channels

-Real-time chat is available on our [Freenode](http://freenode.net/irc_servers.shtml) IRC channel, [#handbrake](irc://irc.freenode.net/#handbrake). Make sure to provide an [Activity Log](activity-log.html) when requesting support.
+Real-time chat is available via #HandBrake on the [Libera.Chat](https://libera.chat/) IRC Network. Make sure to provide an [Activity Log](activity-log.html) when requesting support.
+

 Note that HandBrake's developers are located in various timezones around the world, and have lives and jobs outside of HandBrake and its community. It's possible that nobody will be able to answer your support request on IRC right away. Be patient for awhile or ask on the forums.

-Developer discussion happens on [#handbrake-dev](irc://irc.freenode.net/#handbrake-dev), which is moderated for the team's sanity. If you're a developer and would like to speak on [#handbrake-dev](irc://irc.freenode.net/#handbrake-dev), you may ask politely on [#handbrake](irc://irc.freenode.net/#handbrake).
+Developer discussion happens on the channel #HandBrake-dev, which is moderated for the team's sanity. If you're a developer and would like to speak on #HandBrake-dev, you may ask politely in #Handbrake
diff -ur source/docs/en/1.3.0/help/troubleshooting-common-issues.markdown source/docs/en/1.5.0/help/troubleshooting-common-issues.markdown
--- source/docs/en/1.3.0/help/troubleshooting-common-issues.markdown    2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/help/troubleshooting-common-issues.markdown    2022-01-18 04:50:48.000000000 -0500
@@ -75,20 +75,20 @@

 ## HandBrake for Windows

-### Downloading Microsoft .NET Framework
+### Downloading Microsoft .NET Core

-Windows 10 already contains Microsoft .NET Framework. Updates are available for Windows 7 and 8.1 via Windows Update.
+- [Microsoft .NET Core 5.x](https://dotnet.microsoft.com/download/dotnet/5.0/runtime) 
+Please make sure to download the "Desktop Runtime".
+Download the "x64" versionf or Intel or AMD based systems.
+Download the "Arm64" for ARM based devices running Windows. 

-Additionally, you may download one of the following Microsoft .NET Framework standalone installers.
-
-- [Microsoft .NET Framework 4.7.1](https://www.microsoft.com/en-us/download/details.aspx?id=56116) for Windows 7 SP1, Windows 8.1, Windows 10, and Windows Server

 ### General troubleshooting

 Try each of the following steps until HandBrake is working again.

 1. Restart your computer
-2. Install the latest version of Microsoft .NET Framework available for your Windows version
+2. Make sure you have the latest version of .NET Desktop Runtime installed for your system. 
 3. Delete your HandBrake configuration data and presets (replace username with your own)
     - C:\Users\username\AppData\Roaming\HandBrake
     - C:\Users\username\AppData\Local\HandBrake
diff -ur source/docs/en/1.3.0/index.markdown source/docs/en/1.5.0/index.markdown
--- source/docs/en/1.3.0/index.markdown 2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/index.markdown 2022-01-18 04:50:48.000000000 -0500
@@ -15,7 +15,7 @@
 Welcome
 =======

-Welcome to the English documentation for HandBrake 1.3.0 through 1.3.3.
+Welcome to the English documentation for HandBrake 1.5.0 through 1.5.1.

 Here are some quick links to get you started:

diff -ur source/docs/en/1.3.0/table-of-contents.markdown source/docs/en/1.5.0/table-of-contents.markdown
--- source/docs/en/1.3.0/table-of-contents.markdown 2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/table-of-contents.markdown 2022-01-18 04:50:48.000000000 -0500
@@ -127,20 +127,25 @@
   *Technical summary of the official presets*
 - [Performance](technical/performance.html)
   *How various settings affect encoding speed*
+- [Process Isolation](technical/process-isolation.html)
+  *Process Isolation and Multiple Simultaneous Jobs supports*
 - Video
   - [Video codecs](technical/video-codecs.html)<span class="notice draft"><span>draft</span></span>
+  - [10/12-bit encoding](technical/video-bit-depth.html)<span class="notice draft"><span>draft</span></span>
+  - [HDR10 encoding](technical/hdr10.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>
+  - [Filters](technical/filters-summary.html)<span class="notice draft"><span>draft</span></span>
 - Hardware encoders
   - [AMD VCE](technical/video-vce.html)
   - [Apple VideoToolbox](technical/video-videotoolbox.html)
   - [Intel Quick Sync Video](technical/video-qsv.html)
   - [NVIDIA NVENC](technical/video-nvenc.html)
+  - [Media Foundation (ARM)](technical/video-mediafoundation.html)
 - Audio
   - [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>
@@ -148,23 +153,14 @@
   - [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)<span class="notice draft"><span>draft</span></span>
-
-<!--
-- [Web optimized](technical/web-optimised.html)
-- [Video source type](advanced/video-sources.html)
-- Advanced Filter Settings
-- Advanced preferences
--->

 ## Developer documentation

 - Building HandBrake
   - [Building HandBrake for BSD](developer/build-bsd.html)
-    - Installing dependencies on [FreeBSD](developer/install-dependencies-freebsd.html)
+    - Installing dependencies on [FreeBSD](developer/install-dependencies-freebsd.html) / [NetBSD](developer/install-dependencies-netbsd.html)
   - [Building HandBrake for Linux](developer/build-linux.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)
+    - 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) / [Void](developer/install-dependencies-void.html)
   - [Building HandBrake for Mac](developer/build-mac.html)
   - [Building HandBrake for Windows](developer/build-windows.html)
 - Packaging HandBrake
diff -ur source/docs/en/1.3.0/technical/audio-codecs.markdown source/docs/en/1.5.0/technical/audio-codecs.markdown
--- source/docs/en/1.3.0/technical/audio-codecs.markdown    2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/technical/audio-codecs.markdown    2022-01-18 04:50:48.000000000 -0500
@@ -45,7 +45,7 @@
     -   On Mac, HandBrake uses Apple's CoreAudio AAC encoder. It's known to be
         much better quality and is the default option for Mac users.

--   HE-AAC ( Mac Only)
+-   HE-AAC (Mac Only)

     -   High Efficiency AAC encoder. This encoder is optimized for low-bitrate
         applications which may be useful for streaming.
@@ -62,7 +62,11 @@
     -   HandBrake offers Vorbis audio encoding as well, for which it uses the
         aoTuV branch that offers quality tweaks.

--   AC3:
+-   Opus (FFmpeg)
+
+    -   Available in MKV files, Opus is the successor to Vorbis. HandBrake uses libopus for encoding.
+
+-   AC3 and E-AC3:

     -   HandBrake can encode to AC3 using FFmpeg.

@@ -70,7 +74,7 @@

 -   Flac 16 and 24bit (FFmpeg)

-    -   Loss-less audio compression.
+    -   Lossless audio compression.

     -   Available in MKV files.

@@ -83,7 +87,7 @@
 -----------------

 HandBrake supports passthru for a limited number of popular source formats.
-These are: AC3, DTS, DTS-HD, TrueHD, MP3 or AAC (Passthru)
+These are: AC3, E-AC3, DTS, DTS-HD, TrueHD, MP3, MP2, AAC or flac (Passthru)

 This copies the audio bit-for-bit from the source so offers no loss in audio
 quality. These audio tracks can be quite large so can impact the final size of
diff -ur source/docs/en/1.3.0/technical/filters-summary.markdown source/docs/en/1.5.0/technical/filters-summary.markdown
--- source/docs/en/1.3.0/technical/filters-summary.markdown 2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/technical/filters-summary.markdown 2022-01-18 04:50:48.000000000 -0500
@@ -15,7 +15,6 @@
 Summary of Filters
 =============================

-Coming Soon!

 HandBrake contains the following filters:

@@ -24,5 +23,76 @@
   - Decomb
 - Denoise
 - Deblock
+- Chroma Smooth
 - Grayscale
-- Rotation
+- Colorspace
+
+
+Detelecine
+----------
+
+Detelecine removes comb artifacts that are the result of telecine, a process for converting film frame rates to television frame rates.
+
+
+Deinterlace
+-----------
+
+Deinterlace removes comb artifacts from the picture. 
+Yadif is a popular and fast deinterlacer. 
+Decomb switches between multiple interpolation algorithms for speed and quality.
+
+The following Deinterlace tunes are available:
+- Default: Is well balanced for speed and quality.
+- Skip Spatial Check: Lets Yadif skip correcting certain avoidable artifacts for a slight speed boost.
+- EEDI2: Uses a slower, higher quality interpolation algorithm for Decomb. Useful for the most difficult sources.
+- Bob: Attempts to better preserve motion for a slight penalty to perceived resolution.
+
+
+Denoise
+-------
+
+Denoise reduces or removes the appearance of noise and grain. This can improve compression efficiency and create higher quality video at smaller file sizes. 
+Overly strong Denoise settings may damage picture quality by discarding detail.
+
+NLMeans is a high quality denoise filter with a cost to speed. Use where quality is more important than speed.
+HQDN3D is an adaptive low-pass filter, faster than NLMeans but less effective at preserving fine detail.
+
+For NLMeans the following Denoise tunes are available:
+- None: Uses the default preset settings.
+- Film: Refines settings for use with most live action content.
+- Grain: Only processes color channels. Useful for preserving the film-like look of luminance grain while reducing or removing color noise.
+- High Motion: Reduces color smearing in high motion scenes by avoiding temporal processing for color channels. Useful for sports and action videos.
+- Animation: Is useful for cel animation such as anime and cartoons.
+- Tape: Is useful for low-detail analog tape sources such as VHS, where Film does not produce a desirable result.
+- Sprite: Is useful for 1-/4-/8-/16-bit 2-dimensional games. Sprite is not designed for high definition video.
+
+
+Deblock
+-------
+
+Deblock reduces blocky artifacts caused by low quality video compression.
+
+
+Chroma Smooth
+-------------
+
+Reduces chroma noise, rainbows, and other prominent visual artifacts. Useful for resolving various color-related issues, especially with lower resolution content from analog sources, e.g. poor quality DVD and VHS sources. The blurring/smoothing algorithm is the same as used by the unsharp filter.
+
+
+Grayscale
+---------
+
+Grayscale removes the color component of the video. Often referred to as Black & White video.
+
+
+Colorspace
+----------
+
+Colorspace + tonemap filter. Can change/tonemap the colorspace of the video into one of the following:
+
+- BT.2020
+- BT.709
+- BT.601 SMPTE-C
+- BT.601 EBU
+
+If this set to "Off" then HandBrake will keep the colorspace of the video.
Only in source/docs/en/1.5.0/technical: hdr10.markdown
diff -ur source/docs/en/1.3.0/technical/official-presets.markdown source/docs/en/1.5.0/technical/official-presets.markdown
--- source/docs/en/1.3.0/technical/official-presets.markdown    2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/technical/official-presets.markdown    2022-01-18 04:50:48.000000000 -0500
@@ -103,7 +103,6 @@
 | Apple 1080p30 Surround               | MP4     | H.264     | AAC stereo; Dolby Digital (AC-3) | Medium         |
 | Apple 720p30 Surround                | MP4     | H.264     | AAC stereo; Dolby Digital (AC-3) | Medium         |
 | Apple 540p30 Surround                | MP4     | H.264     | AAC stereo; Dolby Digital (AC-3) | Medium         |
-| Apple 240p30                         | MP4     | H.264     | AAC stereo                       | Medium         |
 | Chromecast 2160p60 4K HEVC Surround  | MP4     | **H.265** | AAC stereo; Dolby Digital (AC-3) | **Very slow**  |
 | Chromecast 1080p60 Surround          | MP4     | H.264     | AAC stereo; Dolby Digital (AC-3) | Medium         |
 | Chromecast 1080p30 Surround          | MP4     | H.264     | AAC stereo; Dolby Digital (AC-3) | Medium         |
@@ -117,7 +116,6 @@
 | Roku 576p25                          | MP4     | H.264     | AAC stereo                       | Medium         |
 | Roku 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         |

 ## Matroska presets

@@ -164,14 +162,16 @@

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

-### Windows Mobile presets
+### Legacy Devices 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.   |
+| Preset                       | Compatible Preset                | Notes                                                                                           |
+|------------------------------|----------------------------------|-------------------------------------------------------------------------------------------------|
+| Apple 240p30                 | None                             | Obsolete.                                                                                       |
+| 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.      |
+| Xbox Legacy 1080p30 Surround | Devices > Apple 1080p30 Surround | Disable anamorphic, dimensions must be evenly divisible by 8, video must be H.264 Main Profile. |

 ### Legacy 0.10.x presets

@@ -180,7 +180,7 @@
 | Normal              | General > Fast 1080p30           | Decomb filter, peak limited to 30 FPS, slightly decreased video bit rate, improved motion quality, foreign audio search.                |
 | High Profile        | General > HQ 1080p30 Surround    | Peak limited to 30 FPS, reduced video bit rate spikes, foreign audio search.                                                            |
 | Universal           | None                             | General > Fast 576p25/480p30 may be suitable replacements where compatibility with ancient devices and surround sound are not required. |
-| iPod                | Devices > Apple 240p30           | Decomb filter, foreign audio search.                                                                                                    |
+| iPod                | None                             | Obsolete.                                                                                                                               |
 | iPhone & iPod touch | Devices > Apple 540p30 Surround  | Decomb filter, slightly increased video bit rate, surround sound, foreign audio search.                                                 |
 | iPad                | Devices > Apple 720p30 Surround  | Decomb filter, slightly decreased video bit rate, surround sound, foreign audio search.                                                 |
 | AppleTV             | Devices > Apple 540p30 Surround  | Decomb filter, foreign audio search.                                                                                                    |
@@ -188,7 +188,7 @@
 | AppleTV 3           | Devices > Apple 1080p30 Surround | Decomb filter, slightly decreased video bit rate, foreign audio search.                                                                 |
 | Android             | Devices > Android 576p25/480p30  | Decomb filter, peak limited to 25 FPS (Android 576p25 only), slightly increased video bit rate, foreign audio search, chapter markers.  |
 | Android Tablet      | Devices > Android 720p30         | Decomb filter, slightly increased video bit rate, foreign audio search, chapter markers.                                                |
-| Windows Phone 8     | None                             | Devices > Windows Mobile 720p30 may be suitable with anamorphic off and audio bit rate reduced to 128 kbps.                             |
+| Windows Phone 8     | None                             | Obsolete.                                                                                                                               |

 [^high-quality-settings-less-compatible]: Higher quality General `Presets` may include settings that are incompatible with older or slower devices.

Only in source/docs/en/1.5.0/technical: process-isolation.markdown
diff -ur source/docs/en/1.3.0/technical/system-requirements.markdown source/docs/en/1.5.0/technical/system-requirements.markdown
--- source/docs/en/1.3.0/technical/system-requirements.markdown 2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/technical/system-requirements.markdown 2022-01-18 04:50:48.000000000 -0500
@@ -17,22 +17,23 @@

 ## Hardware

-The following is the minimum level of hardware that HandBrake supports.
+The following is the minimum level of hardware HandBrake formally supports.

 - Processor:
-  - Intel Core i3 or better
-  - AMD FX / 2014+ APU or better
-- Free memory:
-  - 512 MB for transcoding standard definition video (480p/576p)
-  - 1.5 GB for transcoding high definition video (720p/1080p)
-  - 4 GB or more for transcoding ultra high definition video (2160p 4K)
+  - AMD Ryzen, Threadripper, or Epyc
+  - Intel Core (6th generation and newer) i3, i5, i7, i9, or equivalent Xeon
+  - Apple Silicon M1 and newer, recent Intel Macs supported per the above
+- Free memory:  
+  - 1 GB for transcoding standard definition video (480p/576p)
+  - 2 GB for transcoding high definition video (720p/1080p)
+  - 6 GB or more for transcoding ultra high definition video (2160p 4K)
 - System storage:
-  - 100 MB for the HandBrake app
-  - 2 GB or more recommended for processing and storing your new videos
+  - 150 MB for the HandBrake app
+  - 10 GB or more recommended for processing and storing your new videos
 - Display resolution:
-  - 1024x768 minimum, proportionately higher with display scaling
+  - 1280x960 minimum, proportionately higher with display scaling. (See section below)

-While it may be technically possible to run HandBrake on hardware not meeting these requirements, it is neither recommended nor supported.
+While it may be technically possible to run HandBrake on hardware not meeting these requirements, it is not recommended. 

 ### Hardware encoders

@@ -61,10 +62,11 @@

 HandBrake is supported on FreeBSD stable and maintenance versions.

-| FreeBSD Version | Status    | Last Compatible Version | Notes |
-|-----------------|-----------|-------------------------|-------|
-| FreeBSD 12      | Supported |                         |       |
-| FreeBSD 11      | Supported |                         |       |
+| FreeBSD Version | Status      | Last Compatible Version | Notes |
+|-----------------|-------------|-------------------------|-------|
+| FreeBSD 13      | Supported   |                         |       |
+| FreeBSD 12      | Supported   |                         |       |
+| FreeBSD 11      | Unsupported | 1.3.3                   |       |

 #### Fedora

@@ -72,9 +74,12 @@

 | Fedora Version | Status              | Last Compatible Version | Notes                         |
 |----------------|---------------------|-------------------------|-------------------------------|
-| Fedora 32      | Supported           |                         |                               |
-| Fedora 31      | Supported           |                         |                               |
-| Fedora 30      | Deprecated in 1.3.0 |                         | End of life.                  |
+| Fedora 35      | Supported           |                         |                               |
+| Fedora 34      | Supported           |                         |                               |
+| Fedora 33      | Deprecated in 1.4.0 |                         | End of life.                  |
+| Fedora 32      | Deprecated in 1.3.0 | HandBrake 1.4.2         | End of life.                  |
+| Fedora 31      | Deprecated in 1.3.0 | HandBrake 1.4.2         | End of life.                  |
+| Fedora 30      | Deprecated in 1.3.0 | HandBrake 1.4.2         | End of life.                  |
 | Fedora 29      | Unsupported         | HandBrake 1.3.1         | End of life.                  |
 | Fedora 28      | Unsupported         | HandBrake 1.3.1         | End of life.                  |

@@ -86,9 +91,9 @@

 | Ubuntu Version          | Status              | Last Compatible Version | Notes                              |
 |-------------------------|---------------------|-------------------------|------------------------------------|
-| 20.04 LTS Focal Fossa   | Supported           |                         | Flatpak, PPA, and source.          |
-| 18.04 LTS Bionic Beaver | Deprecated in 1.3.0 |                         | Flatpak only.                      |
-| 16.04 LTS Xenial Xerus  | Unsupported         | HandBrake 1.1.2         | Various issues affect operability. |
+| 20.04 LTS Focal Fossa   | Supported           |                         | Flatpak, and source.               |
+| 18.04 LTS Bionic Beaver | Unsupported         | HandBrake 1.3.3         | Flatpak only.                      |
+| 16.04 LTS Xenial Xerus  | Unsupported         | HandBrake 1.1.2         | End of life (standard support).    |
 | 14.04 LTS Trusty Tahr   | Unsupported         | HandBrake 1.1.2         | End of life (standard support).    |

 #### Other
@@ -102,20 +107,22 @@

 ### Mac

-HandBrake is supported on recent versions of macOS[^apple-eol].
+HandBrake is supported on recent versions of macOS, and since version 1.4.0 is a Universal Binary supporting both Intel and Apple Silicon Macs.

 | macOS Version      | Status              | Last Compatible Version | Notes                              |
 |--------------------|---------------------|-------------------------|------------------------------------|
+| 12 Monterey        | Supported           |                         | Requires HandBrake 1.4.0 or later. |
+| 11 Big Sur         | Supported           |                         | Requires HandBrake 1.4.0 or later. |
 | 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  | Deprecated in 1.3.0 |                         | End of life expected Q4 2020.      |
-| 10.12 Sierra       | Deprecated in 1.3.0 |                         | End of life.                       |
-| 10.11 El Capitan   | Deprecated in 1.2.0 |                         | End of life.                       |
-| 10.10 Yosemite     | Unsupported         | HandBrake 1.1.2         | End of life.                       |
-| 10.9 Mavericks     | Unsupported         | HandBrake 1.1.2         | End of life.                       |
-| 10.8 Mountain Lion | Unsupported         | HandBrake 1.1.2         | End of life.                       |
-| 10.7 Lion          | Unsupported         | HandBrake 1.1.2         | End of life.                       |
-| 10.6 Snow Leopard  | Unsupported         | HandBrake 0.10.5        | End of life.                       |
+| 10.14 Mojave       | Deprecated          |                         | End of life.                       |
+| 10.13 High Sierra  | Deprecated          |                         | End of life.                       |
+| 10.12 Sierra       | Unsupported         | 1.4.2                   | End of life.                       |
+| 10.11 El Capitan   | Unsupported         | 1.3.3                   | End of life.                       |
+| 10.10 Yosemite     | Unsupported         | 1.1.2                   | End of life.                       |
+| 10.9 Mavericks     | Unsupported         | 1.1.2                   | End of life.                       |
+| 10.8 Mountain Lion | Unsupported         | 1.1.2                   | End of life.                       |
+| 10.7 Lion          | Unsupported         | 1.1.2                   | End of life.                       |
+| 10.6 Snow Leopard  | Unsupported         | 0.10.5                  | End of life.                       |

 [VLC](https://www.videolan.org/vlc/) is recommended for viewing media files, notably Matroska (MKV), which is not natively supported on macOS.

@@ -124,42 +131,27 @@

 ### Windows

-HandBrake is supported on recent Windows versions and requires [Microsoft .NET Framework](https://dotnet.microsoft.com/download/dotnet-framework) 4.8 or later.
+HandBrake requires [.NET Desktop Runtime](https://dotnet.microsoft.com/download/dotnet/5.0) 5.0.x.

-| Windows Version | Status              | Last Compatible Version | Notes        |
-|-----------------|---------------------|-------------------------|--------------|
-| Windows 10      | Supported           |                         |              |
-| Windows 8.1     | Supported           |                         |              |
-| Windows 7 SP1   | Deprecated in 1.1.0 |                         | End of life. |
-| Windows Vista   | Unsupported         | HandBrake 1.0.7         | End of life. |
-| Windows XP      | Unsupported         | HandBrake 0.9.9         | End of life. |
-
-[VLC](https://www.videolan.org/vlc/) is recommended for viewing media files.
+| Windows Version | Status              | Last Compatible Version | Notes                        |
+|-----------------|---------------------|-------------------------|------------------------------|
+| Windows 11      | Supported           |                         |                              |
+| Windows 10      | Supported           |                         | 1909 or later.               |
+| Windows 8.1     | Unsupported         | 1.3.3                   | 1.4.2 runs with limitations. |
+| Windows 7 SP1   | Unsupported         | 1.3.3                   | 1.4.2 runs with limitations. |
+| Windows Vista   | Unsupported         | 1.0.7                   | End of life.                 |
+| Windows XP      | Unsupported         | 0.9.9                   | End of life.                 |

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

 ### Display scaling

-Display scaling beyond 100% requires a proportionately higher resolution to fit the higher density interface graphics in the same physical space. For example, HandBrake will fit within the bounds of a 1920x1080 (FHD) resolution display at 100% and 125% scaling, but not at 150% and higher.
-
-The following is a list of common display scales and corresponding standard resolutions that meet HandBrake’s requirements. Higher resolutions may also be used.
+Display scaling beyond 100% requires a proportionately higher resolution to fit the higher density interface graphics in the same physical space. For example, HandBrake will fit within the bounds of a 1920x1080 HD resolution display at 100% and 125% scaling, but not at 150% and higher.

-| Scaling | Minimum Height | 4:3 Aspect                          | 16:10 Wide Aspect                       | 16:9 Wide Aspect                     | 21:9 Ultrawide Aspect  |
-|---------|----------------|-------------------------------------|-----------------------------------------|--------------------------------------|------------------------|
-| 100%    | 768 pixels     | 1024x768 (XGA)                      | 1280x800 (WXGA), 1440x900 (WSXGA/WXGA+) | 1366x768 (WXGA), 1600x900 (HD+)      | 2160x900 (WHD+)        |
-| 125%    | 960 pixels     | 1280x960 (SXGA−), 1400x1050 (SXGA+) | 1680x1050 (WSXGA+)                      | 1920x1080 (FHD)                      | 2560x1080 (WFHD)       |
-| 150%    | 1152 pixels    | 1600x1200 (UXGA)                    | 1920x1200 (WUXGA)                       | 2048x1152 (QWXGA)                    | 2880x1200 (WFHD+)      |
-| 175%    | 1344 pixels    | 2048x1536 (QXGA)                    | 2560x1600 (WQXGA)                       | 2560x1440 (WQHD)                     | 3440x1440 (WQHD)       |
-| 200%    | 1536 pixels    | 2048x1536 (QXGA)                    | 2560x1600 (WQXGA)                       | 3200x1800 (QWXGA+)                   | 3840x1600 (UW4K)       |
-| 225%    | 1728 pixels    | 2800x2100 (QSXGA+)                  | 3840x2400 (WQUXGA)                      | 3200x1800 (QWXGA+)                   | 4320x1800 (WQHD+)      |
-| 250%    | 1920 pixels    | 2800x2100 (QSXGA+)                  | 3840x2400 (WQUXGA)                      | 3840x2160 (4K UHD-1)                 | 5120x2160 (WUHD)       |
-| 300%    | 2304 pixels    | 3200x2400 (QUXGA)                   | 3840x2400 (WQUXGA)                      | 5120x2880 (5K)                       | 5760x2400 (UW5K)       |
-| 350%    | 2688 pixels    | 4096x3072 (HXGA)                    | 5120x3200 (WHXGA)                       | 5120x2880 (5K)                       | 6880x2880 (UW6K)       |
+Customization to system themes, such as font sizes and padding, may also impact the ability of the window to render in the space provided. 

-HandBrake will fit within any display resolution, 4:3 aspect ratio or wider, meeting or exceeding the minimum height for the associated scaling amount. If your display resolution meets or exceeds the minimum and HandBrake does not fit within its bounds, you will need to reduce your display scaling.
+If HandBrake does not fit within the bounds of your display, you can try changing the *Scale and Layout* setting on Windows, or the *Scaling Factor* setting on Linux, to a smaller value.

 <!-- /.system-linux.system-windows -->
-
-
-[^apple-eol]: Since Apple does not publish support periods, common convention is to consider a macOS version end of life once [security updates](https://support.apple.com/en-us/HT201222) cease being offered, typically 2–3 years after initial release.
Only in source/docs/en/1.5.0/technical: video-bit-depth.markdown
diff -ur source/docs/en/1.3.0/technical/video-codecs.markdown source/docs/en/1.5.0/technical/video-codecs.markdown
--- source/docs/en/1.3.0/technical/video-codecs.markdown    2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/technical/video-codecs.markdown    2022-01-18 04:50:48.000000000 -0500
@@ -17,26 +17,25 @@

 The following video codecs are available for encoding in HandBrake.

-- H.264 (x264):
+- H.264:

     - 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
+    - Several different encoders are supported: 
+      - In software: x264  
+      - In hardware: Intel QuickSync, AMD VCE, Nvidia NVENC and ARM devices though MediaFoundation.

-- H.264 (Intel QSV):
-
-    - 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
-
-- H.265 (x265)
+- H.265 (HEVC)

     - 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
+    - Current strengths 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
+    - Several different encoders are supported: 
+      - In software: x265  
+      - In hardware: Intel QuickSync, AMD VCE, Nvidia NVENC and ARM devices though MediaFoundation.

 - MPEG-4 (ffmpeg):

Only in source/docs/en/1.5.0/technical: video-mediafoundation.markdown
diff -ur source/docs/en/1.3.0/technical/video-nvenc.markdown source/docs/en/1.5.0/technical/video-nvenc.markdown
--- source/docs/en/1.3.0/technical/video-nvenc.markdown 2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/technical/video-nvenc.markdown 2022-01-18 04:50:48.000000000 -0500
@@ -17,8 +17,8 @@

 ## 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
+- NVIDIA GeForce GTX Pascal (1050+), GTX/RTX Turing (1650+, 2060+) or Ampere (3060+) series GPU or better
+- NVIDIA Graphics Driver 456.71 or later
 - Windows 10
 - Experimental Linux support is available in HandBrake’s command line interface

@@ -28,23 +28,43 @@

 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.

+## Presets
+
+The following presets are available under the 'Hardware' category in the presets menu:
+
+- H.265 NVENC 2160P 4K
+- H.265 NVENC 1080p
+
+These are a good starting point for configuring HandBrake to use these encoders.
+
 ## Performance

-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.
+HandBrake supports the NVIDIA NVENC encoder but does not support the NVDEC decoder.

-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.
+The CPU will still be used for:

-## Advanced options
+- Video decoding 
+- All video filters
+- Audio encoding 
+- HandBrake's engine, A/V sync etc
+- Subtitles
+- Muxing

-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.
+These operations all happen in parallel as the job progresses. As such, it is normal to see high (or even 100%) CPU utilisation even when using NVENC.

-From HandBrake’s command line interface, use the `--encopts` parameter as follows:
+It is also common, particularly on lower-end or older hardware, for the CPU to be a bottleneck which will cause lower than expected performance. To minimize this effect, disable any filters that you do not require.

-    --encopts="option1=value1:option2=value2"
+## Advanced options
+
+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.

-From HandBrake’s graphical interface, set the options in the `Advanced Options` field on the `Video` tab:
+If using HandBrake’s graphical interface, you can set the options in the `Advanced Options` field on the `Video` tab in the following format:

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

 ### Option value types

diff -ur source/docs/en/1.3.0/technical/video-qsv.markdown source/docs/en/1.5.0/technical/video-qsv.markdown
--- source/docs/en/1.3.0/technical/video-qsv.markdown   2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/technical/video-qsv.markdown   2022-01-18 04:50:48.000000000 -0500
@@ -20,6 +20,7 @@
 - Intel Skylake (6th Generation Core) CPU or later with Intel HD Graphics or better
 - Windows 10
 - Linux
+- FreeBSD

 Please note, these are not hard limits. Hardware encoding via Intel QSV *might* work on older series GPUs and older operating systems, but this is not officially supported.

@@ -27,25 +28,46 @@

 ## Enabling support

-Support for the Intel QSV encoder is enabled in preferences on the video tab. If your system is not supported, the option will be disabled.
+Support for the Intel Quick Sync Video encoder is enabled in preferences on the video tab. If your system is not supported, the option will be disabled.
+
+## Presets
+
+The following presets are available under the 'Hardware' category in the presets menu:
+
+- H.265 QSV 2160P 4K
+- H.265 QSV 1080p
+
+These are a good starting point for configuring HandBrake to use these encoders.

 ## Performance

-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.
+HandBrake supports both QSV encode and decode.

-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.
+The CPU will still be used for:

-## Advanced options
+- Video decoding (if QSV decode is disabled or your source is in a format which is not supported by the QSV hardware)
+- Most video filters
+- Audio encoding 
+- HandBrake's engine, A/V sync etc
+- Subtitles
+- Muxing

-The QSV 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.
+These operations all happen in parallel as the job progresses. As such, it is normal to see high (or even 100%) CPU utilisation even when using QSV.

-From HandBrake’s command line interface, use the `--encopts` parameter as follows:
+It is also common, particularly on lower-end or older hardware, for the CPU to be a bottleneck which will cause lower than expected performance. To minimize this effect, disable any filters that you do not require.

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

-From HandBrake’s graphical interface, set the options in the `Advanced Options` field on the `Video` tab:
+## Advanced options
+
+The QSV 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.
+
+If using HandBrake’s graphical interface, you can set the options in the `Advanced Options` field on the `Video` tab in the following format:

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

 ### Option value types

diff -ur source/docs/en/1.3.0/technical/video-vce.markdown source/docs/en/1.5.0/technical/video-vce.markdown
--- source/docs/en/1.3.0/technical/video-vce.markdown   2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/technical/video-vce.markdown   2022-01-18 04:50:48.000000000 -0500
@@ -17,8 +17,9 @@

 ## Supported Hardware and Configurations

-- AMD Radeon RX 400, 500, Vega/II, Navi series GPU or better
-- Ubuntu Linux 18.04.3 or later, Windows 10
+- AMD Radeon RX5000 (RDNA) and RX6000 (RDNA2) series GPU or better
+- Ubuntu Linux 20.04 or later
+- Windows 10

 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.

@@ -28,23 +29,46 @@

 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.

+## Presets
+
+The following presets are available under the 'Hardware' category in the presets menu:
+
+- H.265 VCN 2160P 4K
+- H.265 VCN 1080p
+
+These are a good starting point for configuring HandBrake to use these encoders.
+
+
 ## Performance

-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.
+HandBrake supports the AMD VCE encoder but does not support the VCN decoder.
+
+The CPU will still be used for:

-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.
+- Video decoding 
+- All video filters
+- Audio encoding 
+- HandBrake's engine, A/V sync etc
+- Subtitles
+- Muxing
+
+These operations all happen in parallel as the job progresses. As such, it is normal to see high (or even 100%) CPU utilisation even when using VCE.
+
+It is also common, particularly on lower-end or older hardware, for the CPU to be a bottleneck which will cause lower than expected performance. To minimize this effect, disable any filters that you do not require.

 ## 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:
+If using HandBrake’s graphical interface, you can set the options in the `Advanced Options` field on the `Video` tab in the following format:
+
+    option1=value1:option2=value2
+    
+If using HandBrake’s command line interface, use the `--encopts` parameter as follows:

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

-From HandBrake’s graphical interface, set the options in the `Advanced Options` field on the `Video` tab:

-    option1=value1:option2=value2

 ### Option value types

diff -ur source/docs/en/1.3.0/technical/video-videotoolbox.markdown source/docs/en/1.5.0/technical/video-videotoolbox.markdown
--- source/docs/en/1.3.0/technical/video-videotoolbox.markdown  2022-01-18 04:50:50.000000000 -0500
+++ source/docs/en/1.5.0/technical/video-videotoolbox.markdown  2022-01-18 04:50:48.000000000 -0500
@@ -17,7 +17,7 @@

 ## Supported hardware

-- Most 2015 and later Macs
+- Most 2011 and later Macs

 Please note, these are not hard limits. Hardware encoding via VideoToolbox *might* work on older series GPUs and older operating systems, but this is not officially supported.

@@ -27,6 +27,7 @@

 - H.264 (VideoToolbox)
 - H.265 (VideoToolbox)
+- H.265 10bit (VideoToolbox)

 Choice of the underlying hardware encoder (AMD VCE or Intel Quick Sync Video) is not available. The highest quality option will typically be chosen.

@@ -38,4 +39,38 @@

 ## Advanced options

-There are no advanced options available for VideoToolbox encoders.
+The VideoToolbox 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.
+
+If using HandBrake’s graphical interface, you can set the options in the `Advanced Options` field on the `Video` tab in the following format:
+
+    option1=value1:option2=value2
+    
+If using HandBrake’s command line interface, use the `--encopts` parameter as follows:
+
+    --encopts="option1=value1:option2=value2"
+
+### Option value 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.
+
+- boolean  
+  0 means off (or disabled).  
+  1 means on (or enabled).
+ 
+- string  
+  An alphanumeric string of characters. See the option’s comments for acceptable values.
+
+### Options list
+
+| Option           | Type        | H.264 | H.265 | Detail                                                                                                    |
+|------------------|-------------|:-----:|:-----:|-----------------------------------------------------------------------------------------------------------|
+| gpu-registryid   | int         |   ✓   |   ✓   | GPU selection. If set, the VideoToolbox will only use a hardware encoder running on the GPU specified by the provided GPU registryID. |
+| bframes          | boolean     |   ✓   |   ✓   | Set to `1` to enable Reference B-Frames (default), `0` to disable.                                        |
+| cabac            | boolean     |   ✓   |       | Set to `1` to enable cabac, `0` to disable. Note the hyphen for H.264.                                    |
+| slice-max-size   | boolean     |   ✓   |       | Set the maximum slice size for H.264 encoding in bytes.                                                   |
+| vbv-bufsize      | boolean     |   ✓   |   ✓   | Sets the size of the VBV buffer in bytes per second.                                                      |
+| vbv-maxrate      | boolean     |   ✓   |   ✓   | Sets the maximum rate the VBV buffer should be assumed to refill at, in bytes per second.                 |
+| max-frame-delay  | int         |   ✓   |   ✓   | The maximum frame delay count is the maximum number of frames that a compressor is allowed to hold before it must output a compressed frame. |
bradleysepos commented 2 years ago

Ping @Nomis101 in case you would like to help, or know HandBrake UI translators who might be interested.

Nomis101 commented 2 years ago

I can have a look if I find some time. But this are a lot of new strings...

bradleysepos commented 2 years ago

I can have a look if I find some time. But this are a lot of new strings...

Indeed, it is a significant amount of work. Everyone should feel no pressure and do as much or as little as they feel comfortable. 😸

sr55 commented 2 years ago

Another crazy idea although I'm not sure how good they are. Integrate one of the live translation services? I wonder if there is a way of poking chrome to trigger a translation?

bradleysepos commented 2 years ago

Closing as 1.6.0 is imminent and we have not had a translator since 1.3.0.

Nomis101 commented 1 year ago

Closing as 1.6.0 is imminent and we have not had a translator since 1.3.0.

Yes, sorry, this is a lot of translation work to do. And I currently (and in the future) will not have time for all this. Would it be an idea to auto-translate everything with DeepL and then I (or who ever) only needs to do a review and correct everything that was wrong translated? This would help a lot with this task.

sr55 commented 1 year ago

I wonder if there is a way of triggering built-in browser translation. I'm not sure how good that would be.

Nomis101 commented 1 year ago

Hm, this highly depends on the underlaying translation service. The results would be very mixed.