line0's Aegisub Scripts

1. Nudge
2. Shake It

---

Nudge

Nudge is an automation script for Aegisub that lets you create your own hotkeyable macros for common tag modifications like nudging a line up and down, increasing the brightness of signs or cycling through a predefined set of blur states.

Requirements

• Aegisub 3.2.0+
• Aegisub-Motion 1.0.0+
• LuaJSON (shipped with Aegisub-Motion)
• Yutils
• Includes from this repo: LineExtend, ASSTags, Common

Release Packages ship everything but Aegisub-Motion.

Installation

From release package:

1. Install Aegisub-Motion
2. Unpack the Nudge archive into your Aegisub automation directory
3. In Aegisub, rescan your automation folder or restart Aegisub

From source repo:

1. Install Aegisub-Motion
2. Clone the repository and copy the autoload and include folders into your Aegisub automation directory. You only need to take the Nudge.lua from the autoload folder, but all files from the include folder are required.

Usage

When you first load the Nudge script, it will create its own submenu in your automation menu. It also ships with a bunch of default macros to get you started.

To add, modify or remove Macros, run the Configure Nudge macro. Nudge will present you a list of all the existing macros, which you can then customize by adjusting their options:

• Macro Name: Name of Macro. Because hotkeys are registered by command name, you need to update the commands of already hotkeyed macro after changing its name or the hotkey will stop working
• Target: The override tag(s) or fields of the line modified by the macro. The list contains all supported override tags as well as some "compound" tags (Colors, Shadows, ...) that will target multiple override tags at once (e.g. Primary Color modifies both \c and \1c)
• Action: The operation that will be performed on matched override tags (first parameter) and user-supplied values (second parameter). Not all actions support every available tag (refer to the list below).
• Values: Second parameter to the operation specified in the Action field. Values are separated by commas and usually match the position of the parameters to the specified override tags: \blur# takes only 1 parameter, while \fad(#,#) takes 2 parameters in tag order. **Exception: ** color tags take 3 base-10 parameters for r,g,b (e.g. 255,128,0 instead of 0080FF). Some action take special set of parameters or ignore user-supplied values altogether (refer to the list below)
• No Default: If this checkbox is checked, Nudge will only modify tags already present in the line instead of automatically adding missing tags in case none of the specified tags were found.
• Remove: Check this checkbox if you want to remove a Macro and hit Save.

Use the Add Macro button to add a new Macro and the Save button to save the configuration to the disk. Since Aegisub only allows Macros to be registered when scripts are loaded, you must reload your scripts (in the automation menu, click on Automation... while holding down Ctrl) after adding macros, removing macros and changing macro names for the Automation menu to reflect the changes you just made.

Working with Macros: Run the macro by hotkey or from the menu to make it process all selected lines according to its configuration.

At this time the script processes all matching tags in a line and inserts style-based defaults for missing tags into the first tag block (Options to customize this behavior are planned). If no tag block is found at the beginning of the line, Nudge will create one unless the No Default checkbox is checked.

Nudge will never output invalid tags (e.g. \an10, \k15.5) even if the user supplied values are of a bad type or the operation causes the result to be out of range. For your convenience, Nudge silently coerces the output values in order to output valid tags.

Operations

• Add: Adds the supplied values to the tag fields (Default: 0)
• Multiply: Multiplies the tag fields with the supplied values (Default: 1)
• Power: Exponentiates the tag fields with the supplied values (Default 1)
• Set: Sets the tag fields to the supplied values (Defaults: tag/tag field dependent)
• Cycle: Cycles through a defined set of values. Values must be in the format [Set1],[Set2],[Set3], e.g. [100,100],[500,500],[1000,1000] for \fad
• Auto Cycle: Cycles through the states of tags that only define a set amount of states (\q, \an). The value field is ignored.
• Set Default: Sets the tag fields to their default values according to the style of the line. The value field is ignored.
• Toggle: Switches on/off type tags (\i,\u...) between 1 and 0. The value field is ignored.
• Add HSV: modifies RGB values of color tags in the HSV domain. Values must be supplied as Hue,Saturation,Value. Hue takes an angle, while Saturation and Value must be supplied in range 0..1.
• Align Up/Down/Left/Right: changes the alignment (\an) of a line stepwise in the specified direction. Example: Align Up changes \an2 to \an5, \an1 to \an7, but doesn't do anything for \an8. Set the first value to true to make Nudge maintain the appearance of the line by compensating the alignment change with \pos and (if required) \org adjustments.
• Append/Prepend:: appends/prepends the specified string to string type tags (\fs, \r)
• Replace: replaces in string type tags using regular expressions (NOT lua expressions). First value is the string or pattern to match, second value the replacement string.
• Invert Clip: Changes \clip to \iclip and vice versa
• Convert To Drawing: Converts clips to drawings. Set the first value to true to keep the clips and the second value to true to keep the previous position.
• Copy: Copies the tag to the clipboard
• Paste Into: Pastes the configured tag from the clipboard into the configured tag section. Global tags will always be written to the first tag section (if the first tag section is not a tag section, one will be created), overwriting already present global tags. If there are multiple tags in the clipboard, only the ones configured will be pasted (if you want to paste all tags, use the Any Tag option).
• Paste Over: Works like the Paste Into operation, however it also overwrites any non-global tags encountered. Only creates new tags if none were found and overwritten.
• Set/Unset/Toggle Comment: Turns a Dialogue line into a comment or vice versa.

Supported Operations by Tag

Target	Add, Mul, Pow	Set	Def	Cycl	ACycl	Toggle	HSV	Align	Rep, App, Prep	InvClp
\1a	✔	✔	✔	✔
\2a	✔	✔	✔	✔
\3a	✔	✔	✔	✔
\4a	✔	✔	✔	✔
\1c	✔	✔	✔	✔			✔
\2c	✔	✔	✔	✔			✔
\3c	✔	✔	✔	✔			✔
\4c	✔	✔	✔	✔			✔
\alpha	✔	✔	✔	✔
\an	✔	✔	✔	✔	✔			✔
\b	✔	✔	✔	✔		✔
\be	✔	✔	✔	✔
\blur	✔	✔	✔	✔
\bord	✔	✔	✔	✔
\c	✔	✔	✔	✔			✔
\clip	✔		✔							✔
\clip(Vect)	✔		✔							✔
\clip(Rect)	✔	✔	✔	✔						✔
\fad	✔	✔	✔	✔
\fade	✔	✔	✔	✔
\fax	✔	✔	✔	✔
\fay	✔	✔	✔	✔
\fe
\fn		✔	✔	✔					✔
\frx	✔	✔	✔	✔
\fry	✔	✔	✔	✔
\frz	✔	✔	✔	✔
\fs	✔	✔	✔	✔
\fscx	✔	✔	✔	✔
\fscy	✔	✔	✔	✔
\fsp	✔	✔	✔	✔
\k	✔	✔	✔	✔
\K	✔	✔	✔	✔
\kf	✔	✔	✔	✔
\ko	✔	✔	✔	✔
\i		✔	✔			✔
\iclip	✔		✔							✔
\iclip(Vect)	✔		✔							✔
\iclip(Rect)	✔	✔	✔	✔						✔
\move	✔	✔	✔	✔
\org	✔	✔	✔	✔
\pos	✔	✔	✔	✔
\q		✔	✔	✔	✔			✔
\r		✔	✔	✔					✔
\t
\u		✔	✔			✔
\xbord	✔	✔	✔	✔
\ybord	✔	✔	✔	✔
\xshad	✔	✔	✔	✔
\yshad	✔	✔	✔	✔

        |               |     |     |      |       |        |     |       |                |        |

Alphas | ✔ | ✔ | ✔ | ✔ | | | | | | | Clips | ✔ | | ✔ | | | | | | | ✔ | Clips (Vect)| ✔ | | ✔ | | | | | | | ✔ | Clips (Rect)| ✔ | ✔ | ✔ | ✔ | | | | | | ✔ | Colors | ✔ | ✔ | ✔ | ✔ | | | ✔ | | | | Fades | ✔ | ✔ | ✔ | ✔ | | | | | | | Prim. Color | ✔ | ✔ | ✔ | ✔ | | | ✔ | | | | | | | | | | | | | | | Line | | | | | | | | | | |

Target	ConvToDrawing	Copy/Paste	Comment
\1a		✔
\2a		✔
\3a		✔
\4a		✔
\1c		✔
\2c		✔
\3c		✔
\4c		✔
\alpha		✔
\an		✔
\b		✔
\be		✔
\blur		✔
\bord		✔
\c		✔
\clip	✔	✔
\clip(Vect)	✔	✔
\clip(Rect)	✔	✔
\fad		✔
\fade		✔
\fax		✔
\fay		✔
\fe		✔
\fn		✔
\frx		✔
\fry		✔
\frz		✔
\fs		✔
\fscx		✔
\fscy		✔
\fsp		✔
\k		✔
\K		✔
\kf		✔
\ko		✔
\i		✔
\iclip	✔	✔
\iclip(Vect)	✔	✔
\iclip(Rect)	✔	✔
\move		✔
\org		✔
\pos		✔
\q		✔
\r
\t		✔
\u		✔
\xbord		✔
\ybord		✔
\xshad		✔
\yshad		✔

        |               |            |         |      |       |        |     |       |                |        |

Alphas | | ✔ | | | | | | | | | Clips | ✔ | ✔ | | | | | | | | | Clips (Vect)| ✔ | ✔ | | | | | | | | | Clips (Rect)| ✔ | ✔ | | | | | | | | | Colors | | ✔ | | | | | | | | | Fades | | ✔ | | | | | | | | | Prim. Color | | ✔ | | | | | | | | | | | | | | | | | | | | Line | | ✔ | ✔ | | | | | | | |

---

Shake It

tbd