From a5dcb3dcf4d5881347f50db4d277bf5acd03fe68 Mon Sep 17 00:00:00 2001 From: sr55 Date: Sat, 9 Aug 2025 13:26:29 +0100 Subject: [PATCH] Technical doc updates --- .../docs/en/latest/cli/cli-options.markdown | 1 - .../cli/command-line-reference.markdown | 68 +++++++++++++++---- .../en/latest/developer/flatpak-repo.markdown | 4 +- .../technical/system-requirements.markdown | 16 +++-- 4 files changed, 65 insertions(+), 24 deletions(-) diff --git a/source/docs/en/latest/cli/cli-options.markdown b/source/docs/en/latest/cli/cli-options.markdown index 8a9283e4..a684e61d 100644 --- a/source/docs/en/latest/cli/cli-options.markdown +++ b/source/docs/en/latest/cli/cli-options.markdown @@ -1,6 +1,5 @@ --- Type: article -State: [ draft ] Title: CLI Options Project: HandBrake Project_URL: https://handbrake.fr/ diff --git a/source/docs/en/latest/cli/command-line-reference.markdown b/source/docs/en/latest/cli/command-line-reference.markdown index 5aba2779..2fe6e08f 100644 --- a/source/docs/en/latest/cli/command-line-reference.markdown +++ b/source/docs/en/latest/cli/command-line-reference.markdown @@ -7,7 +7,7 @@ Project_Version: Latest Language: English Language_Code: en Authors: [ Bradley Sepos (BradleyS), Scott (s55) ] -Copyright: 2024 HandBrake Team +Copyright: 2025 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 @@ -22,6 +22,7 @@ Please run this command on your own system as available options may vary dependi For reference, the following was generated by the Windows version of HandBrakeCLI. Options may vary slightly depending on hardware / operating system. Run `HandBrakeCLI --help` for valid options for your system. + Usage: HandBrakeCLI [options] -i -o General Options -------------------------------------------------------------- @@ -31,7 +32,7 @@ Options may vary slightly depending on hardware / operating system. Run `HandBra --json Log title, progress, and version info in JSON format -v, --verbose[=number] Be verbose (optional argument: logging level) - -Z. --preset Select preset by name (case-sensitive) + -Z, --preset Select preset by name (case-sensitive) Enclose names containing spaces in double quotation marks (e.g. "Preset Name") -z, --preset-list List available presets @@ -66,6 +67,8 @@ Options may vary slightly depending on hardware / operating system. Run `HandBra Shorter titles will be ignored (default: 10). --scan Scan selected title only. --main-feature Detect and select the main feature title. + --keep-duplicate-titles + Keep duplicate titles when scanning (Blu-ray only) -c, --chapters Select chapters (e.g. "1-3" for chapters 1 to 3 or "3" for chapter 3 only, default: all chapters) @@ -107,6 +110,10 @@ Options may vary slightly depending on hardware / operating system. Run `HandBra --align-av Add audio silence or black video frames to start of streams so that all streams start at exactly the same time + --keep-metadata Preserve the source's common metadata + --no-metadata Disable preset 'keep-metadata' + of streams so that all streams start at exactly + the same time --inline-parameter-sets Create adaptive streaming compatible output. Inserts parameter sets (SPS and PPS) inline in the video stream before each IDR. @@ -117,12 +124,16 @@ Options may vary slightly depending on hardware / operating system. Run `HandBra -e, --encoder Select video encoder: svt_av1 svt_av1_10bit + ffv1 x264 x264_10bit + vce_h264 nvenc_h264 x265 x265_10bit x265_12bit + vce_h265 + vce_h265_10bit nvenc_h265 nvenc_h265_10bit mpeg4 @@ -183,8 +194,15 @@ Options may vary slightly depending on hardware / operating system. Run `HandBra timing if it's below that rate. If none of these flags are given, the default is --pfr when -r is given and --vfr otherwise + --hdr-dynamic-metadata + Set the kind of HDR dynamic metadata to preserve: + hdr10plus + dolbyvision + all + --no-hdr-dynamic-metadata Disable HDR dynamic metadata passthru --enable-hw-decoding Use 'nvdec' to enable NVDec + Use 'qsv' to enable QSV decoding --disable-hw-decoding Disable hardware decoding of the video track, forcing software decoding instead @@ -217,31 +235,36 @@ Options may vary slightly depending on hardware / operating system. Run `HandBra copy:ac3 eac3 copy:eac3 + truehd copy:truehd copy:dts copy:dtshd copy:mp2 mp3 copy:mp3 + opus + copy:opus vorbis + copy:vorbis flac16 flac24 copy:flac - opus - copy:opus + alac16 + alac24 + copy:alac copy - "copy:" will pass through the corresponding - audio track without modification, if pass through - is supported for the audio type. + "copy:" will enable passthru of the + corresponding audio track without modification + if passthru is supported for the audio type. Separate tracks by commas. Defaults: av_mp4 av_aac av_mkv mp3 - av_webm vorbis + av_webm opus --audio-copy-mask Set audio codecs that are permitted when the "copy" audio encoder option is specified - (aac/ac3/eac3/truehd/dts/dtshd/mp2/mp3/flac/opus) + (aac/ac3/eac3/truehd/dts/dtshd/mp2/mp3/opus/vorbis/flac/alac) Separated by commas for multiple allowed options. --audio-fallback Set audio codec to use when it is not possible @@ -272,17 +295,20 @@ Options may vary slightly depending on hardware / operating system. Run `HandBra av_aac up to 7point1 ac3 up to 5point1 eac3 up to 5point1 + truehd up to 5point1 mp3 up to dpl2 + opus up to 7point1 vorbis up to dpl2 flac16 up to 7point1 flac24 up to 7point1 - opus up to 7point1 + alac16 up to 7point1 + alac24 up to 7point1 --normalize-mix Normalize audio mix levels to prevent clipping. Separate tracks by commas. 0 = Disable Normalization (default) 1 = Enable Normalization -R, --arate Set audio samplerate(s) - (8/11.025/12/16/22.05/24/32/44.1/48 kHz) + (8/11.025/12/16/22.05/24/32/44.1/48/88.2/96/176.4/192 kHz) or "auto". Separate tracks by commas. -D, --drc Apply extra dynamic range compression to the audio, making soft sounds louder. Range is 1.0 @@ -304,6 +330,14 @@ Options may vary slightly depending on hardware / operating system. Run `HandBra Separate tracks by commas. Supported by encoder(s): flac16 + --keep-aname Passthru the source audio track(s) name(s). + --no-keep-aname Disable the source audio track(s) name(s) passthru. + --automatic-naming-behaviour + Set the audio track(s) automatic naming behaviour: + off + unnamed + all + Disable the source audio track(s) name(s) passthru. -A, --aname Set audio track name(s). Separate tracks by commas. @@ -355,6 +389,12 @@ Options may vary slightly depending on hardware / operating system. Run `HandBra --modulus Set storage width and height modulus Dimensions will be made divisible by this number. (default: set by preset, typically 2) + --color-range + Set the color range of the output. + auto + limited + full + (default: set by preset, typically limited) -M, --color-matrix Set the color space signaled by the output: Overrides color signalling with no conversion. @@ -596,7 +636,7 @@ Options may vary slightly depending on hardware / operating system. Run `HandBra bt601-6-625 Custom Format: primaries=p:transfer=t:matrix=m:range=r: - tonemap=t:param=p:desat=d + tonemap=t:param=p:desat=d:npl=n -g, --grayscale Grayscale encoding --no-grayscale Disable preset 'grayscale' @@ -630,6 +670,8 @@ Options may vary slightly depending on hardware / operating system. Run `HandBra or less is selected. This should locate subtitles for short foreign language segments. Best used in conjunction with --subtitle-forced. + --keep-subname Passthru the source subtitle track(s) name(s). + --no-keep-subname Disable the source subtitle track(s) name(s) passthru. -S, --subname Set subtitle track name(s). Separate tracks by commas. -F, --subtitle-forced[=string] @@ -714,5 +756,3 @@ Options may vary slightly depending on hardware / operating system. Run `HandBra the video track. If 'number' is omitted, the first SSA is burned. 'number' is a 1-based index into the 'ssa-file' list - - diff --git a/source/docs/en/latest/developer/flatpak-repo.markdown b/source/docs/en/latest/developer/flatpak-repo.markdown index f8a7608e..8043225c 100644 --- a/source/docs/en/latest/developer/flatpak-repo.markdown +++ b/source/docs/en/latest/developer/flatpak-repo.markdown @@ -37,8 +37,8 @@ Install flatpak freedesktop runtime platform. Install flatpak gnome. - flatpak install flathub org.gnome.Platform//47 - flatpak install flathub org.gnome.Sdk//47 + flatpak install flathub org.gnome.Platform//48 + flatpak install flathub org.gnome.Sdk//48 Install Compilers diff --git a/source/docs/en/latest/technical/system-requirements.markdown b/source/docs/en/latest/technical/system-requirements.markdown index 67a22536..fd85453c 100644 --- a/source/docs/en/latest/technical/system-requirements.markdown +++ b/source/docs/en/latest/technical/system-requirements.markdown @@ -22,10 +22,10 @@ The following is the minimum level of hardware HandBrake formally supports. - Processor: - 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 + - Intel Core (9th generation and newer) i3, i5, i7, i9, Ultra or equivalent Xeon + - Apple Silicon M1 and newer - Minimum System Memory: - - 16 GB for transcoding standard and high definition video (480p/576p/720p) + - 16 GB for transcoding standard and high definition video (480p/576p/720p/1080p) - 32 GB for transcoding 4K Ultra HD video (2160p) - System storage: - 150 MB for the HandBrake app @@ -85,9 +85,11 @@ HandBrake is supported on Fedora stable and maintenance versions until their end | Fedora Version | Status | Last Compatible Version | Notes | |----------------|---------------------|-------------------------|-------------------------------| -| Fedora 40 | Supported | | | -| Fedora 39 | Supported | | | -| Fedora 38 | Supported | | | +| Fedora 42 | Supported | | | +| Fedora 41 | Supported | | | +| Fedora 40 | Unsupported | HandBrake 1.9.2 | | +| Fedora 39 | Unsupported | HandBrake 1.9.2 | | +| Fedora 38 | Unsupported | HandBrake 1.9.2 | | | Fedora 37 | Unsupported | HandBrake 1.6.1 | End of life. | | Fedora 36 | Unsupported | HandBrake 1.6.1 | End of life. | | Fedora 35 | Unsupported | HandBrake 1.5.1 | End of life. | @@ -109,7 +111,7 @@ Interim (non-LTS) versions are typically supported until their end of life. |---------------------------|---------------------|-------------------------|------------------------------------| | 24.04 LTS Noble Numbat | Supported | | Flatpak, and source. | | 22.04 LTS Jammy Jellyfish | Supported | | Flatpak, and source. | -| 20.04 LTS Focal Fossa | Deprecated | | Flatpak, and source. | +| 20.04 LTS Focal Fossa | Unsupported | HandBrake 1.9.2 | 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). |