docs: Update Fedora and Ubuntu, Linux and Windows build guides. - #267
Merged
Conversation
sr55
approved these changes
Aug 20, 2026
bradleysepos
force-pushed
the
update-build
branch
from
August 20, 2026 23:49
3523537 to
80a6a46
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Tested on Fedora 43 and 44, Ubuntu 24.04 Server and 26.04 Server, Ubuntu 26.04 Desktop (GNOME), and Windows 11 x64. Tested only compilation for Windows 11 ARM.
Updates the dependency lists for the latest distro releases and HandBrake features. Notably, recently added VAAPI support requires the same additional dependencies as Intel QSV.
Deduplicates Ubuntu dependencies installation instructions for Linux and Windows. Now the Windows guide instructs to follow the Ubuntu dependencies installation guide and return to the Windows guide to continue.
Some info on the toolchains:
The LLVM MinGW toolchain releases do not track MinGW releases. The version included in the guide is copied to our mirror and is one inconsequential commit behind MinGW 14.0.0 which we are currently using via the GCC MinGW toolchain. I'll update our CI which is slightly behind to this LLVM MinGW toolchain version shortly, which I've tested working.
We could provide instructions for building the LLVM MinGW toolchain instead of, or as an alternative to downloading it. However, as stated, its releases do not track MinGW releases, and further, we're not testing against its master branch. Documenting using the same release asset we use to build HandBrake makes sense, assuming we keep the guide updated.
We provide mingw-w64-build alongside our source code, so we can be relatively confident that the toolchain produced can build HandBrake properly. Upstream only publishes release downloads that run on x86_64 Linux and Apple Silicon macOS. The script itself should work on aarch64 Linux; so building manually should work everywhere. If prebuilt toolchain releases for aarch64 Linux become available, we could provide instructions for downloading similar to the LLVM MinGW toolchain.