Guide:Installing Aegisub scripts

Aegisub scripts are Lua or Moonscript plugins that can be used to automate tedious, repetitive or complex tasks. There are two methods of installing Aegsiub scripts: Automatic and Manual.

Folder where Aegisub scripts are stored
All scripts must be located in the automation folder of Aegisub. For different operating systems, this folder is located in different directory.

For Windows users to go to this directory, press Win in your keyboard and type  in the textbox and hit Enter.

Inside this folder, there must be a folder called automation. Inside automation folder, there must be two folders: autoload and include. If any of these folders are missing, and you are manually installing scripts, create those folders yourself. The folder autoload consists of all the scripts that you want Aegisub to load while the folder include consists of all the modules that the scripts depend on.

Automatic Method
This is the recommended method of installing Aegisub scripts as it allows you to install, uninstall and update scripts without ever leaving Aegisub. The tool that achieves this is called Dependency Control. Newer versions of Aegisub is already shipped with Dependency Control. However, if it is not, you can follow the steps below to install it.

Installation of Dependency Control

 * 1) Windows and Mac users can download the latest Dependency Control files from the latest release from it’s repo. In this page, click on Assets and click on the file for your respective operating system. Linux users must compile Dependency Control on their own. (Arch Linux users may use AUR package instead)
 * 2) Extract the Dependency Control files in the Aegisub’s automation directory.
 * 3) Restart Aegisub.

Using Dependency Control to install scripts

 * 1) In Aegisub, go to Automation -> DependencyControl -> Install Script.
 * 2) In the first drop-down menu called Automation Scripts, select the script you want to download and click OK.

Manual Method
All the Aegisub scripts have not been added to Dependency Control. In order to install those scripts, you will have to manually download the script and move it to the required folders.


 * 1) Download the script to your computer. If your script depends on some modules, download them as well.
 * 2) Copy the script to the autoload directory. Copy the modules to include directory.
 * 3) Restart Aegisub