Skip to content

Special notice for macOS

Jump to bottom
wangqr edited this page Jun 6, 2021 · 16 revisions

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

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
brew install hunspell uchardet  # optional

Some packages are installed as keg-only. You need to either

Issue with wxOSX

The wxWidgets 3.0 has multiple bugs on macos. You will be able to build and run with wxWidgets 3.0.x provided by homebrew, 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:

  • Run brew edit wxmac or open /usr/local/Homebrew/Library/Taps/homebrew/homebrew-core/Formula/wxmac.rb with a text editor
  • Make the following changes:
diff --git a/Formula/wxmac.rb b/Formula/wxmac.rb
index 4da1be31e8..80b587150b 100644
--- a/Formula/wxmac.rb
+++ b/Formula/wxmac.rb
@@ -1,10 +1,9 @@
 class Wxmac < Formula
   desc "Cross-platform C++ GUI toolkit (wxWidgets for macOS)"
   homepage "https://www.wxwidgets.org"
-  url "https://github.com/wxWidgets/wxWidgets/releases/download/v3.0.5.1/wxWidgets-3.0.5.1.tar.bz2"
-  sha256 "440f6e73cf5afb2cbf9af10cec8da6cdd3d3998d527598a53db87099524ac807"
+  url "https://github.com/wxWidgets/wxWidgets/releases/download/v3.1.5/wxWidgets-3.1.5.tar.bz2"
+  sha256 "d7b3666de33aa5c10ea41bb9405c40326e1aeb74ee725bb88f90f1d50270a224"
   license "wxWindows"
-  revision 1
   head "https://github.com/wxWidgets/wxWidgets.git"
 
   livecheck do
@@ -43,7 +42,6 @@ class Wxmac < Formula
       "--enable-std_string",
       "--enable-svg",
       "--enable-unicode",
-      "--enable-webkit",
       "--enable-webview",
       "--with-expat",
       "--with-libjpeg",
@@ -57,8 +55,8 @@ class Wxmac < Formula
     ]
 
     on_macos do
-      # Set with-macosx-version-min to avoid configure defaulting to 10.5
-      args << "--with-macosx-version-min=#{MacOS.version}"
+      # Set with-macosx-version-min to 10.11 if you are building package for distribution
+      args << "--with-macosx-version-min=10.11"
       args << "--with-osx_cocoa"
     end
  • 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.

Clone this wiki locally