TypesettingTools / Aegisub

Aegisub For binaries and general information see the homepage. The bug tracker can be found at https://github.com/TypesettingTools/Aegisub/issues. Support is available on Discord or IRC. Building Aegisub Windows Prerequisites: • Visual Studio (Community edition of any recent version is fine, needs the Windows SDK included) • Python 3 • Meson • CMake There are a few optional dependencies that must be installed and on your PATH: • msgfmt, to build the translations (installing from https://mlocati.github.io/articles/gettext-iconv-windows.html seems to be the easiest option) • InnoSetup, to build the regular installer (iscc.exe on your PATH) • 7zip, to build the regular installer (7z.exe on your PATH) • Moonscript, to build the regular installer (moonc.exe on your PATH) All other dependencies are either stored in the repository or are included as submodules. Building: • Clone Aegisub's repository: • From the Visual Studio "x64 Native Tools Command Prompt", generate the build directory: (if building for release, add ) • Build with and You should now have a binary: . Installer: You can generate the installer with after a successful build. This assumes a working internet connection and installation of the optional dependencies. You can generate the portable zip with after a successful build. OS X 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 # or brew install meson if you installed Python via brew brew install cmake ninja pkg-config libass boost zlib ffms2 fftw hunspell uchardet 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" When compiling on Apple Silicon, replace with . When compiling on macOS 15.0 (Sequoia) or later, you may also want to to make the color picker work. Once the dependencies are installed, build Aegisub with . Build dmg Linux or other Build dependencies for Debian-based systems I.e. to install on Ubuntu 24.04 run this command: Build Aegisub Packaging If you are packaging Aegisub for a Linux distribution, here are a few things you may need to know: • Aegisub cannot be built with LTO (See: https://github.com/TypesettingTools/Aegisub/issues/290). • Aegisub depends on LuaJIT and *requires* LuaJIT to be build with Lua 5.2 compatibility enabled. We are aware that most distributions do not compile LuaJIT with this flag, and that this complicates packaging for them, see https://github.com/TypesettingTools/Aegisub/issues/239 for a detailed discussion of the situation. Like for its other dependencies, Aegisub includes a meson subproject for LuaJIT that can be used to statically link a version of LuaJIT with 5.2 compatibility. For distributions that do not allow downloading additional sources at build time, the downloaded LuaJIT subproject is included in the source tarballs distributed with releases. • When linked against libstdc++, Aegisub needs libstdc++ 6.0.32 or later due to https://gcc.gnu.org/bugzilla/show_bug.cgi?id=95048. Aegisub's tests will detect this bug, but if you're not running tests on packaging you'll need to make sure the libstdc++ version is recent enough. • Aegisub uses OpenGL through wxWidgets. For Aegisub to work directly on Wayland (as opposed to Xwayland), wxWidgets needs to be built with EGL enabled. Aegisub will automatically fall back to X11 when it detects missing EGL support. The following commands are an example for how to build Aegisub with the goal of creating a distribution package: Updating Moonscript From within the Moonscript repository, run . Open the newly created , and within it make the following changes: • Prepend the final line of the file, , with a , producing . • Within the function at , remove references to , , and . This means removing their declarations, definitions, and entries in the returned table. • Within the function at , remove the line . The file is now ready for use, to be placed in within the Aegisub repo. License 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.