Special notice for macOS

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

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

Installing the dependencies with homebrew

To install the dependencies with homebrew, run

brew install autoconf automake boost ffmpeg ffms2 fftw freetype fribidi gettext icu4c libass lua luarocks m4 pkg-config wxmac

Issue with wxOSX

The wxWidgets 3.0 has multiple bugs on macos. You will be able to build and run with wxWidgets, but there will be glitches in the user interface. The most severe one I met was the wxSpinCtrl not showing up. This can be solved by upgrading wxWidgets to 3.1. After you have installed wxmac using homebrew, follow these steps to upgrade it:

• Open /usr/local/Homebrew/Library/Taps/homebrew/homebrew-core/Formula/wxmac.rb with a text editor

• Find the line url "https://github.com/wxWidgets/wxWidgets/releases/download/v3.0.4/wxWidgets-3.0.4.tar.bz2"

  Change it to url "https://github.com/wxWidgets/wxWidgets/releases/download/v3.1.3/wxWidgets-3.1.3.tar.bz2"

• Comment out the following line sha256 "96157f988d261b7368e5340afa1a0cad943768f35929c22841f62c25b17bf7f0" by prefixing an #

• Change the following line revision 2 to revision 1

• Find and comment out patch :DATA by prefixing an #

• Save and quit text editor

• Upgrade by running brew reinstall --build-from-source wxmac

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.