mirror of
https://github.com/HandBrake/HandBrake-docs.git
synced 2025-12-10 00:44:52 -06:00
docs: Minor documentation updates for latest changes.
This commit is contained in:
sr55
parent
2f5d366a85
commit
c465a8a056
@ -18,48 +18,12 @@ Building HandBrake for Windows
|
||||
|
||||
## 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) 20.04 (Focal Fossa).
|
||||
These should also work with Windows Subsystem for Linux.
|
||||
|
||||
Basic requirements to run commands:
|
||||
|
||||
@ -139,9 +103,7 @@ The following tools are required to build and run the [GUI](abbr:Graphical User
|
||||
- [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.
|
||||
|
||||
|
||||
@ -135,13 +135,14 @@ Table of contents
|
||||
- [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>
|
||||
<!-- - [Modulus](technical/modulus.html)<span class="notice draft"><span>draft</span></span>-->
|
||||
- [Frame rate](technical/frame-rates.html)<span class="notice draft"><span>draft</span></span>
|
||||
- Hardware encoders
|
||||
- [AMD VCE](technical/video-vce.html)
|
||||
- [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>
|
||||
@ -149,10 +150,11 @@ Table of contents
|
||||
- [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
|
||||
|
||||
@ -64,12 +64,16 @@ Audio Encoders
|
||||
- HandBrake offers Vorbis audio encoding as well, for which it uses the
|
||||
aoTuV branch that offers quality tweaks.
|
||||
|
||||
- AC3:
|
||||
- AC3 and E-AC3:
|
||||
|
||||
- HandBrake can encode to AC3 using FFmpeg.
|
||||
|
||||
- This is not the same as Passthru. You can encode any audio track to AC3.
|
||||
|
||||
- Opus (FFmpeg)
|
||||
|
||||
- Available in MKV files.
|
||||
|
||||
- Flac 16 and 24bit (FFmpeg)
|
||||
|
||||
- Loss-less audio compression.
|
||||
@ -85,7 +89,7 @@ Passthru options.
|
||||
-----------------
|
||||
|
||||
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
|
||||
|
||||
@ -21,14 +21,14 @@ System requirements
|
||||
The following is the minimum level of hardware that HandBrake supports.
|
||||
|
||||
- Processor:
|
||||
- Intel Core i3 or better
|
||||
- AMD FX / 2014+ APU or better
|
||||
- Intel Core (4th generation and newer) i3, i5, i7, i9 or equivalent Xeon
|
||||
- AMD Ryzen, Threadripper or Epyc
|
||||
- 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)
|
||||
- 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
|
||||
- 150 MB for the HandBrake app
|
||||
- 2 GB or more recommended for processing and storing your new videos
|
||||
- Display resolution:
|
||||
- 1024x768 minimum, proportionately higher with display scaling
|
||||
@ -88,7 +88,7 @@ Interim (non-LTS) versions are typically supported until their end of life.
|
||||
| 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. |
|
||||
| 18.04 LTS Bionic Beaver | Deprecated in 1.3.0 | HandBrake 1.3.0 | Flatpak only. |
|
||||
| 16.04 LTS Xenial Xerus | Unsupported | HandBrake 1.1.2 | Various issues affect operability. |
|
||||
| 14.04 LTS Trusty Tahr | Unsupported | HandBrake 1.1.2 | End of life (standard support). |
|
||||
|
||||
@ -107,16 +107,17 @@ HandBrake is supported on recent versions of macOS[^apple-eol].
|
||||
|
||||
| macOS Version | Status | Last Compatible Version | Notes |
|
||||
|--------------------|---------------------|-------------------------|------------------------------------|
|
||||
| 11 Big Sur | Supported | | Requires HandBrake 1.4 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.13 High Sierra | Unsupported | 1.3.3 | End of life |
|
||||
| 10.12 Sierra | Unsupported | 1.3.3 | End of life. |
|
||||
| 10.11 El Capitan | Unsupported | 1.2.0 | 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.
|
||||
|
||||
@ -125,15 +126,15 @@ HandBrake is supported on recent versions of macOS[^apple-eol].
|
||||
|
||||
### 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 the [.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. |
|
||||
| Windows 8.1 | Unsupported | 1.3.3 | End of life. |
|
||||
| Windows 7 SP1 | Unsupported | 1.3.3 | End of life. |
|
||||
| Windows Vista | Unsupported | 1.0.7 | End of life. |
|
||||
| Windows XP | Unsupported | 0.9.9 | End of life. |
|
||||
|
||||
[VLC](https://www.videolan.org/vlc/) is recommended for viewing media files.
|
||||
|
||||
|
||||
@ -18,26 +18,25 @@ Video codecs
|
||||
|
||||
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):
|
||||
|
||||
|
||||
@ -0,0 +1,39 @@
|
||||
---
|
||||
Type: article
|
||||
Title: Media Foundation Encoder
|
||||
Project: HandBrake
|
||||
Project_URL: https://handbrake.fr/
|
||||
Project_Version: Latest
|
||||
Language: English
|
||||
Language_Code: en
|
||||
Authors: [ Scott (s55) ]
|
||||
Copyright: 2021 HandBrake Team
|
||||
License: Creative Commons Attribution-ShareAlike 4.0 International
|
||||
License_Abbr: CC BY-SA 4.0
|
||||
License_URL: https://handbrake.fr/docs/license.html
|
||||
---
|
||||
|
||||
Apple VideoToolbox
|
||||
==================
|
||||
|
||||
## Supported hardware
|
||||
|
||||
- Windows 10 for ARM with Qualcomm ARM processors. This encoder will not display on x86 based systems.
|
||||
|
||||
## Enabling support
|
||||
|
||||
If your computer is supported you will see one or more of the following video encoders added to the encoder control on the `Video` tab.
|
||||
|
||||
- H.264 (MediaFoundation)
|
||||
- H.265 (MediaFoundation)
|
||||
|
||||
|
||||
## 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.
|
||||
|
||||
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.
|
||||
|
||||
## Advanced options
|
||||
|
||||
There are no advanced options available for VideoToolbox encoders.
|
||||
@ -18,7 +18,7 @@ AMD VCE
|
||||
|
||||
## Supported Hardware and Configurations
|
||||
|
||||
- AMD Radeon RX 400, 500, Vega/II, Navi series GPU or better
|
||||
- AMD Radeon RX400, RX500, Vega, RX5000 and RX6000 series GPU or better
|
||||
- Ubuntu Linux 20.04 or later
|
||||
- Windows 10
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user