HandBrake/HandBrake-docs
1
0
Fork 0
mirror of https://github.com/HandBrake/HandBrake-docs.git synced 2025-12-10 00:44:52 -06:00
Code Issues Packages Projects Releases 1 Wiki Activity

docs: sync 1.9.0 with latest

Browse Source
This commit is contained in:
Damiano Galassi 2024-12-02 19:45:32 +01:00
parent be9b535404
commit 74be285416
No known key found for this signature in database
GPG Key ID: 5452E231DFDBCA11
11 changed files with 67 additions and 51 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
source/docs/en/1.9.0/advanced/surround-sound.markdown
View File

@ -51,8 +51,10 @@ The following source format's can be passed thru.
- DTS (Limited player compatibility in MP4) - DTS (Limited player compatibility in MP4)
- DTS-HD (Limited player compatibility in MP4) - DTS-HD (Limited player compatibility in MP4)
- TrueHD (Limited player compatibility in MP4) - TrueHD (Limited player compatibility in MP4)
- FLAC (MKV files only) - FLAC
- ALAC
- AAC - AAC
- MP3 - MP3 (Limited player compatibility in MP4)
- MP2 - MP2 (Limited player compatibility in MP4)
- Opus - Opus
- Vorbis

1
source/docs/en/1.9.0/developer/build-mac.markdown
View File

@ -39,6 +39,7 @@ Optional dependencies (required by libdovi)
- `rustup target add aarch64-apple-darwin` for cross-compiling for Apple Silicon on an Intel Mac - `rustup target add aarch64-apple-darwin` for cross-compiling for Apple Silicon on an Intel Mac
- `rustup target add x86_64-apple-darwin` for cross-compiling for Intel on an Apple Silicon Mac - `rustup target add x86_64-apple-darwin` for cross-compiling for Intel on an Apple Silicon Mac
- [openssl](https://www.openssl.org) - [openssl](https://www.openssl.org)
- may be built via included script
- [cargo-c](https://github.com/lu-zero/cargo-c) - [cargo-c](https://github.com/lu-zero/cargo-c)
- Can be installed by running `cargo install cargo-c` - Can be installed by running `cargo install cargo-c`

2
source/docs/en/1.9.0/help/activity-log.markdown
View File

@ -129,7 +129,7 @@ You can access the current log by opening the Activity Log window in HandBrake.
On Mac, logs are stored at the following locations, where `Username` is your user name: On Mac, logs are stored at the following locations, where `Username` is your user name:
- `/Users/Username/Library/Containers/fr.handbrake.HandBrake/Data/Library/Application Support/HandBrake/EncodeLogs` for HandBrake 1.3.0 and later, sandboxed nightly/snapshot builds, and sandboxed personal builds - `/Users/Username/Library/Containers/fr.handbrake.HandBrake/Data/Library/Application Support/HandBrake/EncodeLogs` for HandBrake 1.3.0 and later, sandboxed nightly/snapshot builds, and sandboxed personal builds (the fr.handbrake.HandBrake folder is shown as HandBrake in Finder)
- `/Users/Username/Library/Application Support/HandBrake/EncodeLogs` for HandBrake 1.2.2 and earlier, older non-sandboxed nightly/snapshot builds, and non-sandboxed personal builds - `/Users/Username/Library/Application Support/HandBrake/EncodeLogs` for HandBrake 1.2.2 and earlier, older non-sandboxed nightly/snapshot builds, and non-sandboxed personal builds
You can open the applicable location directly from HandBrake’s Activity Log window. You can open the applicable location directly from HandBrake’s Activity Log window.

16
source/docs/en/1.9.0/technical/audio-codecs.markdown
View File

@ -47,7 +47,7 @@ Audio Encoders
- On Mac, HandBrake uses Apple's CoreAudio AAC encoder. It's known to be - 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. 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 - High Efficiency AAC encoder. This encoder is optimized for low-bitrate
applications which may be useful for streaming. applications which may be useful for streaming.
@ -63,9 +63,9 @@ Audio Encoders
- HandBrake offers Vorbis audio encoding as well. - HandBrake offers Vorbis audio encoding as well.
- Opus - Opus:
- Available in MKV files, Opus is the successor to Vorbis. HandBrake uses libopus for encoding. - Opus is the successor to Vorbis. HandBrake uses libopus for encoding.
- AC3 and E-AC3: - AC3 and E-AC3:
@ -73,22 +73,24 @@ Audio Encoders
- This is not the same as Passthru. You can encode any audio track to AC3. - This is not the same as Passthru. You can encode any audio track to AC3.
- Flac 16 and 24bit (FFmpeg) - Flac 16 and 24bit (FFmpeg):
- Lossless audio compression. - Lossless audio compression.
- Available in MKV files.
- It is not currently possible to passthru the compression level to the - It is not currently possible to passthru the compression level to the
ffmpeg encoder which is currently defaulted to "5" ffmpeg encoder which is currently defaulted to "5"
- ALAC 16 and 24bit:
- Lossless audio compression.
   
Passthru options. Passthru options.
----------------- -----------------
HandBrake supports passthru for a limited number of popular source formats. HandBrake supports passthru for a limited number of popular source formats.
These are: AC3, E-AC3, DTS, DTS-HD, TrueHD, MP3, MP2, AAC or flac (Passthru) These are: AC3, E-AC3, DTS, DTS-HD, TrueHD, Opus, Vorbis, MP3, MP2, AAC, FLAC or ALAC (Passthru)
This copies the audio bit-for-bit from the source so offers no loss in audio 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 quality. These audio tracks can be quite large so can impact the final size of

14
source/docs/en/1.9.0/technical/audio-quality.markdown
View File

@ -31,20 +31,22 @@ There are several different modes HandBrake can operate in.
### Average Bitrate ### Average Bitrate
HandBrake supports average bitrate for all audio encoders except FLAC. HandBrake supports average bitrate for all audio encoders except FLAC, ALAC, and TrueHD.
### Quality based Encoding ### Quality based Encoding
Quality based encoding is supported for the following codecs: Quality based encoding is supported for the following codecs:
- AAC - AAC
- MP3 - MP3
- Vorbis - Vorbis
- Opus
The scale of the quality if much less pronounced compared to the video quality slider, so changes do not have nearly as big an impact on file size. The scale of the quality if much less pronounced compared to the video quality slider, so changes do not have nearly as big an impact on file size.
### Lossless ### Lossless
HandBrake supports FLAC (both 16 and 24bit) when the output format is MKV. HandBrake supports FLAC and ALAC (both 16 and 24bit) when the output format is MKV or MP4.
In addition, HandBrake can passthru the following source audio track formats: In addition, HandBrake can passthru the following source audio track formats:
@ -53,9 +55,9 @@ In addition, HandBrake can passthru the following source audio track formats:
- TrueHD - TrueHD
- AAC - AAC
- MP3 - MP3
- Opus
- Vorbis
- TrueHD
- FLAC - FLAC
- ALAC

8
source/docs/en/1.9.0/technical/containers.markdown
View File

@ -26,8 +26,8 @@ HandBrake creates the widely supported container formats MKV and MP4 (sometimes
Features and playback compatiblity varies between MKV, WebM, and MP4. The following is a summary of some of these differences: Features and playback compatiblity varies between MKV, WebM, and MP4. The following is a summary of some of these differences:
- MP4 container. - MP4 container.
- Supports H.264, H.265, MPEG-4, MPEG-2, AV1 video. - Supports H.264, H.265, MPEG-4, MPEG-2, VP9, AV1 video.
- It stores audio in the AAC, MP3, AC3, E-AC3, and Opus format. AAC is recommended for better compatibility on most players. It is also possible to pass through Dolby Digital 5.1 Surround Sound (AC3) audio from a DVD or Blu-ray, and E-AC3 and TrueHD. - It stores audio in the AAC, MP3, AC3, E-AC3, TrueHD, Opus, FLAC, and ALAC format. AAC is recommended for better compatibility on most players. It is also possible to pass through Dolby Digital 5.1 Surround Sound (AC3) audio from a DVD or Blu-ray, and E-AC3 and TrueHD.
- MP4 also supports chapters, for which HandBrake uses Apple's chapter format. - MP4 also supports chapters, for which HandBrake uses Apple's chapter format.
- MP4 also is capable of storing [VariableFrameRate Variable Frame Rate] video. - MP4 also is capable of storing [VariableFrameRate Variable Frame Rate] video.
- Be aware that chapters and AC3 audio can only be seen by QuickTime 7 and earlier if you change the file extension from .mp4 to .m4v. HandBrake will do this for you automatically when you enable those features, although this can be disabled in the preferences if you really want .mp4 at the end of the name. QuickTime X and later don't require the extension change. - Be aware that chapters and AC3 audio can only be seen by QuickTime 7 and earlier if you change the file extension from .mp4 to .m4v. HandBrake will do this for you automatically when you enable those features, although this can be disabled in the preferences if you really want .mp4 at the end of the name. QuickTime X and later don't require the extension change.
@ -35,8 +35,8 @@ Features and playback compatiblity varies between MKV, WebM, and MP4. The follow
- It can also include "soft" text subtitles that can be turned on or off, instead of always being hard burned into the video frames. - It can also include "soft" text subtitles that can be turned on or off, instead of always being hard burned into the video frames.
- MKV container. - MKV container.
- Supports H.264, H.265, MPEG-4, MPEG-2, VP8, VP9, AV1, Theora video. - Supports H.264, H.265, MPEG-4, MPEG-2, VP8, VP9, AV1, Theora, FFV1 video.
- It stores audio in the AAC, MP3, AC3, E-AC3, Vorbis, Opus, or FLAC formats. It can also pass through the Dolby Digital 5.1 (AC3), Digital Theater Systems (DTS), and TrueHD surround sound formats used by DVDs and Blu-rays. - It stores audio in the AAC, MP3, AC3, E-AC3, TrueHD, Vorbis, Opus, FLAC or ALAC formats. It can also pass through the Dolby Digital 5.1 (AC3), Digital Theater Systems (DTS), and TrueHD surround sound formats used by DVDs and Blu-rays.
- It supports chapters, as well as [VariableFrameRate Variable Frame Rate] video. - It supports chapters, as well as [VariableFrameRate Variable Frame Rate] video.
- It can include "soft" subtitles that can be turned on or off, instead of always being hard burned into the video frame. These can either be bitmap images of the subtitles included on a DVD (known as vobsub) or text. - It can include "soft" subtitles that can be turned on or off, instead of always being hard burned into the video frame. These can either be bitmap images of the subtitles included on a DVD (known as vobsub) or text.

35
source/docs/en/1.9.0/technical/filters-summary.markdown
View File

@ -21,13 +21,17 @@ Summary of Filters
HandBrake contains the following filters: HandBrake contains the following filters:
- Detelecine - Detelecine
- Deinterlace - Comb Detect
- Deinterlace
- Yadif
- Decomb - Decomb
- Denoise - Bwdif
- Deblock - Deblock
- Denoise
- Chroma Smooth - Chroma Smooth
- Grayscale - Sharpen
- Colorspace - Colorspace
- Grayscale
Detelecine Detelecine
@ -41,6 +45,7 @@ Deinterlace
Deinterlace removes comb artifacts from the picture. Deinterlace removes comb artifacts from the picture.
Yadif is a popular and fast deinterlacer. Yadif is a popular and fast deinterlacer.
Bwdif is a motion adaptive deinterlacing based on yadif with the use of w3fdif and cubic interpolation algorithms.
Decomb switches between multiple interpolation algorithms for speed and quality. Decomb switches between multiple interpolation algorithms for speed and quality.
The following Deinterlace tunes are available: The following Deinterlace tunes are available:
@ -51,6 +56,12 @@ The following Deinterlace tunes are available:
- Bob: Attempts to better preserve motion for a slight penalty to perceived resolution. - Bob: Attempts to better preserve motion for a slight penalty to perceived resolution.
Deblock
-------
Deblock reduces blocky artifacts caused by low quality video compression.
Denoise Denoise
------- -------
@ -71,24 +82,12 @@ For NLMeans the following Denoise tunes are available:
- Sprite: Is useful for 1-/4-/8-/16-bit 2-dimensional games. Sprite is not designed for high definition video. - 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 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. 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
---------- ----------
@ -100,3 +99,9 @@ Colorspace + tonemap filter. Can change/tonemap the colorspace of the video into
- BT.601 EBU - BT.601 EBU
If this set to "Off" then HandBrake will keep the colorspace of the video. If this set to "Off" then HandBrake will keep the colorspace of the video.
Grayscale
---------
Grayscale removes the color component of the video. Often referred to as Black & White video.

2
source/docs/en/1.9.0/technical/preferences.markdown
View File

@ -22,7 +22,7 @@ The Preferences menu can be accessed via the "Tools" Menu -> "Preferences" optio
<!-- .system-macos --> <!-- .system-macos -->
The Preferences menu can be accessed via the "HandBrake" Menu -> "Preferences" option. The Preferences menu can be accessed via the "HandBrake" Menu -> "Settings" option.
<!-- /.system-macos --> <!-- /.system-macos -->

2
source/docs/en/1.9.0/technical/video-bit-depth.markdown
View File

@ -28,6 +28,8 @@ The follow encoders support higher than 8-bit.
| Nvidia NVEnc | | Nvidia NVEnc |
| Apple Video Toolbox | | Apple Video Toolbox |
| SVT-AV1 | | SVT-AV1 |
| VP9 |
| FFV1 |
Please note, you must select a "10-bit" or "12-bit" encoder from the "Video Encoder" dropdown on the "Video" tab to enable this feature. Please note, you must select a "10-bit" or "12-bit" encoder from the "Video Encoder" dropdown on the "Video" tab to enable this feature.
For hardware encoders, the option will only be shown if the system supports it. For hardware encoders, the option will only be shown if the system supports it.

2
source/docs/en/1.9.0/technical/video-cq-vs-abr.markdown
View File

@ -117,7 +117,7 @@ encoder will vary the number of bits given to any one portion of the video, but
try to keep everything at the average you set. try to keep everything at the average you set.
- The video bitrate can be set on the "Video Tab" - The video bitrate can be set on the "Video Tab"
- It is recommended that you use 2-Pass encoding. - It is recommended that you use multi-pass encoding.
- This will provide better quality and better bit-rate distribution. A single - This will provide better quality and better bit-rate distribution. A single
pass will lead to sub-optimal results. pass will lead to sub-optimal results.
- The "Turbo" checkbox will make the first pass quicker at the expense of - The "Turbo" checkbox will make the first pass quicker at the expense of

28
source/docs/en/1.9.0/technical/video-videotoolbox.markdown
View File

@ -93,16 +93,18 @@ The following value types are supported (each option only accepts one value type
### Options list ### Options list
| Option | Type | H.264 | H.265 | Detail | | 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. | | 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. |
| keyint | int | ✓ | ✓ | Sets the maximum interval between key frames, also known as the key frame rate. | | keyint | int | ✓ | ✓ | Sets the maximum interval between key frames, also known as the key frame rate. |
| bframes | boolean | ✓ | ✓ | Set to `1` to enable Reference B-Frames (default), `0` to disable. | | 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. | | cabac | boolean | ✓ | | Set to `1` to enable cabac, `0` to disable. Note the hyphen for H.264. |
| slice-max-size | boolean | ✓ | | Sets the maximum slice size for H.264 encoding in bytes. | | slice-max-size | boolean | ✓ | | Sets 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-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. | | vbv-maxrate | boolean | ✓ | ✓ | Sets the maximum rate the VBV buffer should be assumed to refill at, in bytes per second. |
| qpmin | int | ✓ | ✓ | Sets the minimum quantizer that will be used. | | qpmin | int | ✓ | ✓ | Sets the minimum quantizer that will be used. |
| qpmax | int | ✓ | ✓ | Sets the maximum quantizer that will be used. | | qpmax | int | ✓ | ✓ | Sets the maximum quantizer that will be used. |
| ref | int | ✓ | ✓ | Sets the maximum number of reference frames. | | ref | int | ✓ | ✓ | Sets the maximum number of reference frames. |
| 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. | | 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. |
| look-ahead-frame-count | int | ✓ | ✓ | The suggested number of frames to look ahead for rate control. |
| disable-spatial-adaptive-qp | boolean | ✓ | ✓ | Disable spatial adaptation of the quantization parameter (QP) based on per-frame statistics. |