arch1t3cht / Aegisub

Cross-platform advanced subtitle editor, with new feature branches. Read the README on the feature branch.
http://www.aegisub.org
Other
695 stars 32 forks source link

arch1t3cht's Aegisub "fork"

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.

Don't we have enough Aegisub forks already??

We absolutely do, and I'm aware that adding another one doesn't sound like a good idea on paper. However,

Organization

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.

Branch/Feature list

This list is for navigating the repository. Go to the release page for a more structured changelog.

Troubleshooting

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 earlier TSTools builds. If it wasn't introduced by my fork, I can still take a look, but I can't promise anything.

You can find me for support on various servers, including the cave and the TSTools server linked below.

Aegisub on Linux doesn't recognize my GTK theme

This is probably because you're building with wxgtk2. Building with wxgtk3 fixes this, but causes some problems of its own (notably the broken color picker, occasional crashes when opening file dialogs from automation scripts, and general layouting issues).

The exact way of switching depends on your Linux distribution, but essentially you need to ensure that wx-config or the next best variant of it points to wxgtk3. If it points to wxgtk2 by default and deinstalling wxgtk2 isn't an option, you can also temporarily move it out of the path or use a native-file in your meson project. Then, fully reconfigure meson using meson configure --clearcache and meson setup --reconfigure.

The video is desynced / Frames don't appear at the right time

This is probably due to the ffms2 seeking bug (#394). On Windows, this specific regression shouldn't happen anymore. On Linux, you need to install the latest git version of ffms2 - for example the ffms2-git AUR package on Arch linux, or just compile it yourself.

If it's not because of this particular bug, you can also try an alternative video source like LSMASHSource via Avisynth or Vapoursynth, or BestSource.

On Windows: Aegisub crashes whenever I open a video

If you're compiling yourself, try adding --force-fallback-for=zlib to the meson options.

Compilation

If 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:

Compilation flags

Some features are not enabled by default. To enable them, pass -D<feature>=enabled with the meson setup command:

You 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.

Dependencies

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:

Aegisub

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.

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. InnoSetup, to build the regular installer
  3. 7zip, to build the regular installer
  4. 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/arch1t3cht/Aegisub.git
  2. From the Visual Studio "x64 Native Tools Command Prompt", generate the build directory: meson build -Ddefault_library=static (if building for release, add --buildtype=release)
  3. Build with cd build and ninja

You 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.

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
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.

Build dmg

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_static

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.