f240c01cbc | ||
---|---|---|
.github/workflows | ||
automation | ||
docs | ||
libaegisub | ||
packages | ||
po | ||
src | ||
subprojects | ||
tests | ||
tools | ||
.gitignore | ||
LICENCE | ||
README.md | ||
meson.build | ||
meson_options.txt |
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:
- Visual Studio (Community edition of any recent version is fine)
- The June 2010 DirectX SDK (the final release before DirectSound was dropped)
- Python 3
- Meson
- CMake
- Powershell execution policy set to Unrestricted
There are a few optional dependencies that must be installed and on your PATH:
- msgfmt, to build the translations
- WinRAR, to build the portable installer
- InnoSetup, to build the regular installer
- 7zip, to build the regular installer
- Moonscript, to build the regular installer
All other dependencies are either stored in the repository or are included as submodules.
Building:
- Clone Aegisub's repository:
git clone https://github.com/TypesettingTools/Aegisub.git
- 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
- Build with
cd build
andmeson 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:
- Prepend the final line of the file,
package.preload["moonscript"]()
, with areturn
, producingreturn package.preload["moonscript"]()
. - Within the function at
package.preload['moonscript.base']
, remove references tomoon_loader
,insert_loader
, andremove_loader
. This means removing their declarations, definitions, and entries in the returned table. - 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.