Cross-platform advanced subtitle editor
Go to file
Ryan 56581fbce3 actions: invoke win-installer correctly, install innosetup on ci 2021-01-10 03:14:12 -05:00
.github/workflows actions: invoke win-installer correctly, install innosetup on ci 2021-01-10 03:14:12 -05:00
automation meson: initial attempt to generate Aegisub.app on macOS 2021-01-10 03:14:12 -05: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 meson: fix source file inclusion in libaegisub on osx 2021-01-10 03:14:12 -05:00
packages win-installer: fix warnings 2021-01-10 03:14:12 -05:00
po autotools: remove remaining makefiles 2021-01-10 03:14:12 -05:00
src meson: fix resource file compilation 2021-01-10 03:14:12 -05:00
subprojects autotools: remove remaining makefiles 2021-01-10 03:14:12 -05:00
tests Remove autotools build system 2021-01-10 03:14:12 -05:00
tools meson: fix resource file compilation 2021-01-10 03:14:12 -05:00
.gitignore meson: minor subproject cleanup, update gitignore 2021-01-10 03:14:12 -05:00
LICENCE Move everything up a level since the root dir no longer has stuff 2014-03-11 12:14:57 -07:00
README.md meson: fix Windows installer generation 2021-01-10 03:14:12 -05:00
meson.build meson: add Avisynth option, compile libass_gdi_fontselect 2021-01-10 03:14:12 -05:00
meson_options.txt meson: add Avisynth option, compile libass_gdi_fontselect 2021-01-10 03:14:12 -05:00

README.md

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:

  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. WinRAR, to build the portable installer
  3. InnoSetup, to build the regular installer
  4. 7zip, to build the regular installer
  5. Moonscript, to build the regular installer

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

Building:

  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 -Dfreetype2:zlib=system -Dfreetype2:png=enabled -Dfreetype2:default_library=static
  3. Build with cd build and meson compile

You should now have a binary at src/aegisub.exe.

Installer:

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.

OS X

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

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:

CPPFLAGS="$CPPFLAGS -D__ASSERT_MACROS_DEFINE_VERSIONS_WITHOUT_UNDERSCORES=1" \
./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.

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.

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.