Special notice for macOS

This page contains some issues I've met when building Aegisub on macos.

• Installing the dependencies with homebrew
• Additional build target on macOS
  • Issue with freezing menubar

Installing the dependencies with homebrew

To install the dependencies with homebrew, run

brew analytics off  # https://github.com/Homebrew/brew/issues/142 https://github.com/Homebrew/brew/pull/6745
brew install autoconf automake boost ffmpeg ffms2 fftw freetype fribidi gettext icu4c libass lua luarocks m4 pkg-config wxmac
brew install hunspell uchardet  # optional

Some packages are installed as keg-only. You need to set environment variables during build by running the following before build:

export PATH="/usr/local/opt/gettext/bin:/usr/local/opt/icu4c/sbin:/usr/local/opt/icu4c/bin:$PATH"
export CPPFLAGS="-I/usr/local/opt/gettext/include -I/usr/local/opt/icu4c/include"
export LDFLAGS="-L/usr/local/opt/gettext/lib -L/usr/local/opt/icu4c/lib"
export ACLOCAL_PATH="/usr/local/opt/gettext/share/aclocal"
export PKG_CONFIG_PATH="/usr/local/opt/icu4c/lib/pkgconfig"

Replace /usr/local/opt with /opt/homebrew/opt if on Apple silicon.

Additional build target on macOS

There are 2 additional build target for make on macOS.

• make osx-bundle will create Aegisub.app in the same folder,
• make osx-dmg will create a dmg for distribution.

Issue with freezing menubar

If you run src/aegisub from command line after build, the menubar may freeze, and clicking has no effect. This can be temporarily solved by switching to another window, and switch back to Aegisub window. This issue should not happen if you have build Aegisub.app and started the app from Finder.