Download release builds here, or the latest CI builds here.
The release page also has detailed list of all changes and new features. If you're interested in the technical details or want to compile yourself, read on.
We absolutely do, and I'm aware that adding another one doesn't sound like a good idea on paper. However,
I try to convince myself that this isn't really a "fork" in the traditional sense - one which aims to provide extended support and stability fixes. It's a collection of new feature additions which I built myself, together with some of the most important new features floating around other forks. At this point it's probably too late to still be saying this. Still, the general mission hasn't changed. This fork collects new features and critical bugfixes, but won't be putting extra time into maintenance aspects like cleanup and refactors. Partly, this is also because any big refactors would make it harder to pull these changes into upstream repositories or future forks.
While this is usually also the version of Aegisub I'm currently using, I make no promises on stability. Don't use this version if you're just looking for any version of Aegisub - this is mostly intended for typesetting and other advanced usage.
Please be aware that, even if this fork is currently effectively the "active Aegisub fork", I cannot promise full maintainership. The main purpose of this fork is collecting fixes and additions that I am sure are correct (with the goal of complicating the eventual merging of changes and additions upstream as little as possible). In particular, unsolicited pull requests with large additions are unlikely to get merged here. If you plan to send a large PR, feel free to contact me first to see if I'd be willing to merge it and/or have suggestions on how to implement it. Similarly, I cannot currently accept PRs that update or add translations to languages that I do not speak myself. I'm very sorry to have to limit contributions in this way, but I simply do not have the time and resources right now to act as a full maintainer.
As for issues and feature requests, I'll gladly take any bug reports, but if you encounter an issue, please check first if it occurs only on my fork, or also on official Aegisub or earlier TSTools builds. If it wasn't introduced by my fork, I can still take a look, but I can't promise anything. Also, in that case, please open the issues at the relevant upstream repositories rather than here. This makes it easier to find issues with my additions (which have much higher priority), and keeps the issues around when my fork eventually becomes less relevant.
Being a collection of different feature additions, this repository consists of a set of branches for different features, so that they can easily be merged into other repositories. The feature branch merges together all the features I deem as currently usable. Due to the structure of the repository, I will be force-pushing to this branch and some of the individual branches very frequently, so they're not ideal for basing further branches on.
The cibuilds branch makes some CI builds of snapshots of feature at relevant points in time.
This list is for navigating the repository. Go to the release page for a more structured changelog.
folding: Add the ability to visually group and collapse lines in the subtitle gridlua_api: Add new functions to the Lua automation API, like controlling the selection or cursor in the text edit boxvector_clip_actions: Make the different modes of the vector clip tool (lines, bezier curves, adding points, etc) bindable to hotkeyscolor_picker_fix2: Add an option (under "Interface") to restrict the color picker to the window, which fixes the color picker on Linux in a lot of cases.avisynth: Reenable Avisynth support on Windows and enable Avisynth on Linuxbestsource: Add BestSource audio and video source. This source is slower than others by multiple orders of magnitude, but in exchange it can guarantee exact seeking.vapoursynth: Add Vapoursynth audio and video sourcebugfixes: Various fixes necessary for compilation. Most branches are based on this.workarounds: Same as bugfixes, but these are hacky fixes that probably shouldn't be pulled without more work.fixes: Miscellaneous bugfixesmisc: Other miscellaneous additionswangqr_gui: Merge wangqr's changes regarding the GUI. In particular, add high-DPI compatibility.misc_dc: Miscellaneous changes taken from AegisubDCxa2-ds: Add XAudio2 backend and allow stereo playback for some other backends, by wangqr and Shinon.stereo: Add multi-channel support for the other audio backends where possible.video_panning_option: Merge moex3's video zoom and panning, with several bugfixes and more options to control zoom behaviorspectrum-frequency-mapping: Merge EleonoreMizo's spectrum display improvements, and also make Shift+Scroll vertically zoom the audio displaywangqr_time_video: Merge wangqr's feature adding a tool for timing subtitles to changes in the videoIf you're just looking to install Aegisub, you might want to check out the releases page or the CI builds first.
For compilation on Windows, see the TSTools documentation below. Also check the GitHub workflow for the project arguments.
On Arch Linux, there is an AUR package called aegisub-arch1t3cht-git. It's not maintained by me but seems to work.
On other Linux distributions or for manual compilation you can use this package or the TSTools PKGBUILD as a reference, in particular for installing the necessary dependencies if you don't want to compile them yourself. If all dependencies are installed:
meson setup build --buildtype=release for the default configuration. See below for further options.cd to the build directory and run ninjaaegisub binary in the build folder. To install it to a system-wide location, run ninja install. To install to /usr instead of /usr/local, pass --prefix=/usr when configuring or reconfiguring meson.meson setup setup and just immediately run ninja from the build directory - even when the build configuration changed.Some features are not enabled by default. To enable them, pass -D<feature>=enabled with the meson setup command:
-Davisynth=enabled: Avisynth support-Dbestsource=enabled: BestSource-Dvapoursynth=enabled: Vapoursynth supportYou can also disable options that are active by default in the same way. Check the file meson_options.txt for all options.
To change the options of an existing build directory, run meson setup --reconfigure <new arguments> from inside the build directory.
Apart from the dependencies for the TSTools version, there are some additional dependencies. These are cloned and compiled from scratch if not found, but you might want to install binaries instead:
xxhash: For BestSourceffmpeg: Becomes a direct dependency when compiling with BestSourceavisynth (or avisynthplus): Optional run-time dependency for the Avisynth audio/video providervapoursynth: Optional run-time dependency for the VapourSynth audio/video provider
The following VapourSynth plugins are used by the default scripts set in the default configuration:
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.
Prerequisites:
There are a few optional dependencies that must be installed and on your PATH:
All other dependencies are either stored in the repository or are included as submodules.
Building:
git clone https://github.com/arch1t3cht/Aegisub.gitmeson build -Ddefault_library=static (if building for release, add --buildtype=release)cd build and ninjaYou should now have a binary: 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.
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.
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_staticFrom 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:
package.preload["moonscript"](), with a return, producing return package.preload["moonscript"]().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.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.