Cross-platform advanced subtitle editor
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
odrling 2df16d63f0 use libass latest release 2 weeks ago
.ci [ci] remove .exe at end of link [skip ci] 11 months ago
.nuget Move everything up a level since the root dir no longer has stuff 6 years ago
automation update lua scripts 3 months ago
build [build] link libcrypto and libssl in VS 1 year ago
docs Modify to produce a static mirror suitable for serving on a web site 8 years ago
libaegisub Fix charset detection and conversion issues 7 months ago
m4macros added missing files (#57) 2 years ago
packages [windows] add Amaranth in installer 11 months ago
po [help] add joysound exporter item 9 months ago
src Merge branch 'master' of 7 months ago
tests Makefiles: replace the use of subst macro with patsubst (#56) 2 years ago
tools [build] apply patch for lua 1 year ago
vendor use libass latest release 2 weeks ago
.gitignore Add installer vendor folder to gitignore 1 year ago
.gitmodules [windows] add Amaranth in installer 11 months ago
Aegisub.sln Add Windows build through AppVeyor CI 1 year ago
LICENCE Move everything up a level since the root dir no longer has stuff 6 years ago
Makefile Remove the in-repo copy of the fontconfig config files 6 years ago [build] apply patch for lua 1 year ago Bump minimum macOS version to 10.8 3 years ago Update 5 months ago
acinclude.m4 Build: update boost m4 macros 2 years ago
appveyor.yml [ci] add openssl libs after building BuildTasks 1 year ago Move everything up a level since the root dir no longer has stuff 6 years ago
config.guess Update config.sub, config.guess, install-sh (#77) 2 years ago
config.sub Update config.sub, config.guess, install-sh (#77) 2 years ago [build] set minimal boost version to 1.67.0 11 months ago [build] apply patch for lua 1 year ago
install-sh Update config.sub, config.guess, install-sh (#77) 2 years ago


Build status


The latest Windows build can be downloaded at

A package is available on the AUR for Arch Linux users: aegisub-japan7-git

An ebuild is available for Gentoo users at

The default style uses the Amaranth font, which is installed by default when installing from the sources above.

Building Aegisub-Japan7



  1. Visual Studio 2017 (the free Community edition is good enough)
  2. The June 2010 DirectX SDK (the final release before DirectSound was dropped)
  3. Yasm installed to somewhere on your path.

There are a few optional dependencies:

  1. msgfmt, to build the translations
  2. WinRAR, to build the portable installer
  3. InnoSetup, to build the regular installer

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


  1. Clone Aegisub’s repository recursively to fetch it and all submodules: git clone --recursive This will take quite a while and requires about 2.5 GB of disk space.
  2. Open Aegisub.sln
  3. Build the BuildTasks project.
  4. Build the entire solution.

You should now have a bin directory in your Aegisub directory which contains aegisub32d.exe, along with a pile of other files.

The Aegisub installer includes some files not built as part of Aegisub (such as Avisynth and VSFilter), so for a fully functional copy of Aegisub you now need to copy all of the files from an installed copy of Aegisub into your bin directory (and don’t overwrite any of the files already there). You’ll also either need to copy the automation directory into the bin directory, or edit your automation search paths to include the automation directory in the source tree.

After building the solution once, you’ll want to switch to the Debug-MinDep configuration, which skips checking if the dependencies are out of date, as that takes a while.


A vaguely recent version of Xcode and the corresponding command-line tools are required. Nothing older than Xcode 5 has been tested recently, but it is likely that some later versions of Xcode 4 are good enough.

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

brew install autoconf automake ffmpeg ffms2 fftw freetype fribidi gettext icu4c libass m4 pkg-config boost
brew install luajit --HEAD
brew link --force gettext
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"

wxWidgets is located in vendor/wxWidgets, and can be built like so:

./configure --disable-aboutdlg --disable-animatectrl --disable-aui --disable-any \
--disable-bannerwindow --disable-base64 --disable-calendar --disable-caret \
--disable-cmdline --disable-colourpicker --disable-compat28 --disable-config \
--disable-constraints --disable-datepick --disable-dctransform --disable-debugreport \
--disable-dialupman --disable-docview --disable-filehistory --disable-finddlg \
--disable-fs_archive --disable-fs_inet --disable-fs_zip --disable-fsvolume \
--disable-fswatcher --disable-gif --disable-help --disable-html --disable-ipc \
--disable-joystick --disable-jpeg --disable-largefile --disable-markup --disable-mdi \
--disable-mediactrl --disable-metafiles --disable-miniframe --disable-notifmsg \
--disable-numberdlg --disable-pcx --disable-pnm --disable-postscript \
--disable-prefseditor --disable-printarch --disable-progressdlg --disable-propgrid \
--disable-protocol --disable-protocols --disable-rearrangectrl --disable-ribbon \
--disable-richtext --disable-richtooltip --disable-snglinst --disable-sockets \
--disable-sockets --disable-sound --disable-splash --disable-splines \
--disable-std_iostreams --disable-svg --disable-tarstream --disable-tiff \
--disable-tipdlg --disable-tipwindow --disable-url --disable-webkit --disable-webview \
--disable-wizarddlg --disable-xrc \
--enable-geometry --enable-imaglist --enable-listctrl --enable-stc --with-cocoa \
--with-libpng=yes --with-macosx-version-min=10.9 \
--with-opengl \
--without-libjpeg --without-libtiff --without-regex \
&& make

Once the dependencies are installed, build Aegisub with autoreconf && ./configure --with-wxdir=/path/to/Aegisub/vendor/wxWidgets && make && make osx-bundle. autoreconf should be skipped if you are building from a source tarball rather than git.

Linux, BSD or Toasters

Install all the dependencies with the package manager of your distribution:

openssl or libressl

Optional dependencies:

luajit (can be bundled with your build)

Once all the dependencies are installed, run:

make -j$(nproc)

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.