Go to file
arch1t3cht cfd93ce81b meson: Use latest git version for ffms2
This is to include the fix for FFMS/ffms2#394 .
2022-07-02 19:58:43 -07:00
.github/workflows Fix Mac dmg build (#138) 2021-10-12 03:37:49 -04:00
automation Fix errors when automation scripts being loaded and os.execute not working (#156) 2022-06-08 08:36:49 -07:00
docs Modify aegisub_convert_docs.pl to produce a static mirror suitable for serving on a web site 2012-09-03 17:26:49 -07:00
libaegisub Fix compile error on linux 2022-07-02 19:58:43 -07:00
packages installer: update paths to mo files 2022-07-02 19:58:43 -07:00
po Polish translation corrections (#130) 2021-05-23 17:33:04 -04:00
src Pass storage size to libass to fix rendering 2022-06-08 01:10:11 -07:00
subprojects meson: Use latest git version for ffms2 2022-07-02 19:58:43 -07:00
tests Run tests (#125) 2021-05-23 23:33:33 -04:00
tools Fix Mac dmg build (#138) 2021-10-12 03:37:49 -04:00
.gitignore meson: Use latest git version for ffms2 2022-07-02 19:58:43 -07:00
LICENCE Move everything up a level since the root dir no longer has stuff 2014-03-11 12:14:57 -07:00
meson.build meson: use OpenAL.framework on macOS 2021-11-10 20:12:21 -07:00
meson_options.txt meson: add option to specify wxWidgets version 2021-04-09 18:00:01 -04:00
README.md Fix Mac dmg build (#138) 2021-10-12 03:37:49 -04:00


For binaries and general information see the homepage.

The bug tracker can be found at https://github.com/Aegisub/Aegisub/issues.

Support is available on Discord or IRC.

Building Aegisub



  1. Visual Studio (Community edition of any recent version is fine)
  2. The June 2010 DirectX SDK (the final release before DirectSound was dropped)
  3. Python 3
  4. Meson
  5. CMake
  6. Powershell execution policy set to Unrestricted

There are a few optional dependencies that must be installed and on your PATH:

  1. msgfmt, to build the translations
  2. InnoSetup, to build the regular installer
  3. 7zip, to build the regular installer
  4. Moonscript, to build the regular installer

All other dependencies are either stored in the repository or are included as submodules.


  1. Clone Aegisub's repository: git clone https://github.com/TypesettingTools/Aegisub.git
  2. From the Visual Studio "x64 Native Tools Command Prompt", generate the build directory: meson build -Ddefault_library=static (if building for release, add --buildtype=release)
  3. Build with cd build and ninja

You should now have a binary: aegisub.exe.


You can generate the installer with ninja win-installer after a successful build. This assumes a working internet connection and installation of the optional dependencies.

You can generate the portable zip with ninja win-portable after a successful build.


A vaguely recent version of Xcode and the corresponding command-line tools are required.

For personal usage, you can use pip and homebrew to install almost all of Aegisub's dependencies:

pip3 install meson
brew install cmake ninja pkg-config  libass boost zlib ffms2 fftw hunspell
export LDFLAGS="-L/usr/local/opt/icu4c/lib"
export CPPFLAGS="-I/usr/local/opt/icu4c/include"
export PKG_CONFIG_PATH="/usr/local/opt/icu4c/lib/pkgconfig"

Once the dependencies are installed, build Aegisub with meson build && meson compile -C build.

Build dmg

meson build_static -Ddefault_library=static -Dbuildtype=debugoptimized -Dbuild_osx_bundle=true -Dlocal_boost=true
meson compile -C build_static
meson test -C build_static --verbose
meson compile osx-bundle -C build_static
meson compile osx-build-dmg -C build_static

Updating Moonscript

From within the Moonscript repository, run bin/moon bin/splat.moon -l moonscript moonscript/ > bin/moonscript.lua. Open the newly created bin/moonscript.lua, and within it make the following changes:

  1. Prepend the final line of the file, package.preload["moonscript"](), with a return, producing return package.preload["moonscript"]().
  2. Within the function at package.preload['moonscript.base'], remove references to moon_loader, insert_loader, and remove_loader. This means removing their declarations, definitions, and entries in the returned table.
  3. Within the function at package.preload['moonscript'], remove the line _with_0.insert_loader().

The file is now ready for use, to be placed in automation/include within the Aegisub repo.


All files in this repository are licensed under various GPL-compatible BSD-style licenses; see LICENCE and the individual source files for more information. The official Windows and OS X builds are GPLv2 due to including fftw3.