HandBrake/HandBrake-docs
1
0
Fork 0
mirror of https://github.com/HandBrake/HandBrake-docs.git synced 2025-12-11 13:54:49 -06:00
Code Issues Packages Projects Releases 1 Wiki Activity
HandBrake-docs/source/docs/en/latest/developer/build-mac.markdown
Bradley Sepos e041e216a8
docs: Improve language for macOS build requirements. 
HandBrake builds with Xcode 10 on macOS 10.13.6 and works fine on Mojave. Building on Mojave is only required to enable Dark Mode toolbar icons support.
2018-09-24 12:52:02 -04:00

3.3 KiB
Raw Blame History

Type, Title, Project, Project_URL, Project_Version, Language, Language_Code, Authors, Copyright, License, License_Abbr, License_URL
Type Title Project Project_URL Project_Version Language Language_Code Authors Copyright License License_Abbr License_URL
article Building HandBrake for Mac HandBrake https://handbrake.fr/ Latest English en
Bradley Sepos <bradley@bradleysepos.com> (BradleyS)
Scott (s55)
2018 HandBrake Team Creative Commons Attribution-ShareAlike 4.0 International CC BY-SA 4.0 https://handbrake.fr/docs/license.html

Building HandBrake for Mac

Building HandBrake for Mac requires an Apple computer with a 64-bit Intel processor running OS X 10.13.6 High Sierra or later1, and the following dependencies.

  • Xcode 10 or later
    • free Apple Developer registration required, or install from the Mac App Store
  • Command Line Tools for Xcode
    • free Apple Developer registration required, or install using xcode-select --install

Additional dependencies (may be built via included script):

  • autoconf
  • automake
  • cmake (3.8.2 or later recommended)
  • libtool
  • nasm 2.13 or later
  • pkg-config
  • yasm 1.2.0 or later (1.3.0 or later recommended)

Install Xcode2 and open it once. Approve any prompts to install additional tools. You may quit Xcode after it has finished loading.

Install Command Line Tools for Xcode3.

xcode-select --install

Clone the HandBrake repository.

git clone https://github.com/HandBrake/HandBrake.git && cd HandBrake

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

scripts/mac-toolchain-build /usr/local

This process will take a few minutes. If necessary, the script will provide you with instructions for adding the resulting binaries location to your environment's PATH4. Do this now.

Build HandBrake. To build the command line interface only, disable the graphical interface by appending --disable-xcode.

./configure --launch-jobs=$(sysctl -n hw.ncpu) --launch

When complete, you will find HandBrakeCLI in the build/xroot directory. If the graphical interface is enabled, you will also find HandBrake.app in this directory.

Install HandBrake (optional).

sudo make --directory=build install

To start over, simply remove the build directory.

rm -rf build

  1. HandBrake must be built on macOS 10.4 Mojave or later to enable Dark Mode toolbar icons. Building on earlier macOS, even with latest Xcode, will result in Light Mode toolbar icons being displayed in Dark Mode. ↩︎

  2. Make sure Xcode is installed at /Applications/Xcode.app. When using an Xcode Beta release, you may need to rename Xcode-beta.app to Xcode.app. ↩︎

  3. When installing Command Line Tools for Xcode using the package installer (instead of xcode-select --install), make sure to install the package that corresponds to the installed Xcode version. A mismatch between the installed Xcode and Command Line Tools versions may cause problems. ↩︎

  4. /usr/local/bin is included in the system's PATH by default. It is not necessary to add it to your environment's PATH when installing the additional dependencies to /usr/local. ↩︎