Pre-release builds
From Aegisub Wiki
Pre-release builds are development snapshots uploaded from time to time. They might be experimental or unstable, but they always have the latest features and bug fixes. Recent builds are very stable however, and can easily be used for daily work, they are strongly recommended over older version such as 1.10.
Contents |
[edit] New installer-based builds
As of r1564 pre-release builds are distributed as installer-packages. They completely automate the old manual installation.
If you currently use Aegisub 1.10 or older you can not install on top of it or upgrade it, yet. Either uninstall your current version before installing the new, or install the new one in a different location. It is possible to have Aegisub 1.x and Aegisub 2 installed separately.
If you've been using the old manual-install builds you're strongly recommended to either install in a different location than those, or delete the files from that one first. Installing on top of such a build might or might not work, we can't guarantee anything.
If you're using a previous installer-based build you can safely run the installer, it will correctly handle upgrades between different builds.
For every installer-build there is also a non-installer RAR package that contains most of what's in the installer, but not everything. Specifically, dictionaries and thesaurus-files are left out of the RAR packages. Do not mix RAR-package and installer-package builds, it can cause upgrading and uninstallation to fail.
- Aegisub 2 r1813: Installer - This is the latest build.
- Aegisub 2 r1611: Installer / RAR - WARNING: There is a bug with this installer. To solve it, simply install the Visual Studio 2005 SP1 Runtimes. If you don't, you might get crashes or other issues when trying to display subtitles on video.
- Aegisub 2 r1564: Installer / RAR - There is a minor bug in this version: A wrong build of VSFilter is distributed with it, and it might not work on all systems, resulting in no subtitle display. Download and install this package to correct the problem. The package required to make VSFilter work will also be required for later versions of Aegisub, but will be distributed as part of the installer then.
[edit] Building from source
See build instructions.
[edit] Old manual build install procedure
This is the old procedure for installing pre-release builds. These instructions shouldn't be needed any longer.
Please note that we use RAR archives to distribute some files, you will need WinRAR to unpack these files.
[edit] Base installation
To get a minimum working pre-release version do the following:
- Create a new folder where you will install the pre-release version. We will call this the Aegisub folder. You should not install it on top of Aegisub 1.10, that will only give you weird problems.
- Go to amz's pre-release download site.
- There are a bunch of files named like aegisub_rXXXX.exe where XXXX is a number. Download the file with the largest number and put it in your Aegisub folder. (From now on we'll just call that file aegisub.exe.)
- There is also a large number of DLL files on the download site. Download all of them and place in your Aegisub folder.
- Create a new folder inside the Aegisub folder and name it CSRI.
- Move the VSFilter.dll file into the CSRI folder.
[edit] If Aegisub won't start, invalid configuration
If you get an error with a text similar to "invalid application configuration" when you try to start Aegisub, you need to download and install the Visual C++ runtimes from Microsoft.
[edit] If you get crashes
If Aegisub crashes we would really like to know about it so we can correct the problem. To help do this, you need to download one more file, that will make Aegisub produce better crash reports.
This is optional, you only need to do this if Aegisub crashes.
- Open your Aegisub folder.
- Note what build number you have. For example, if you have aegisub_r1458.exe your build number is 1458.
- Go to the pre-release download site.
- For each build on the download site there is also a file named aegisub_rXXXX_pdb.rar, this contains the program debug database. Download the one corresponding to your version.
- Unpack the RAR file in your Aegisub folder. You should now have a file named aegisub_rXXXX.pdb along with the EXE file.
The crash report from Aegisub can be found in %APPDATA%\Aegisub\crashlog.txt. To find it, click Start, select Run and type in exactly "%APPDATA%\Aegisub\", then press OK. Please have this file ready when reporting a crash problem in Aegisub.
[edit] Spell checker and thesaurus
If you want to use the spell checker and thesaurus facilities in Aegisub you will need to download the dictionary files.
This is optional.
- Go to the pre-release download site.
- Download the dictionaries.rar and thesaurii.rar files.
- Extract both files in your Aegisub folder.
If you extracted both files correctly you should have a single dictionaries sub-folder of your Aegisub folder, and this folder should contain a large number of DIC and AFF files.
[edit] Automation scripting
If you want to use the Automation scripting system you need to download the base script files.
This is optional.
- Download this Automation script package.
- Extract it into your Aegisub folder.
If you extracted it correctly you should get a single automation sub-folder of your Aegisub folder. The automation folder should then contain the autoload, demos, docs and include folders, which in turn contain several script files each.
[edit] Manual/documentation
We are making a full rewrite of the manual for Aegisub 2. It's not completed yet, but you can see current progress at the manual wiki.
[edit] If you need more help
A correct installation of Aegisub 2 pre-release with all options installed looks something like this. (The RAR files shown here don't need to be there.)
If you need help you can ask at the forum or the IRC channel.
