User Guide

Overview

expressCode is a professional code editor panel for After Effects that allows you to:

• Edit expressions with IntelliSense and syntax highlighting
• Write and run ExtendScript scripts
• Organize expressions and scripts in a library system
• Apply expressions to multiple properties simultaneously
• Use TypeScript for script development

Interface Overview

The expressCode panel is divided into two main sections:

1. Navigation Panel (left) - Shows expressions from the active comp or your library
2. Editor Panel (right) - Monaco code editor with header and footer controls

Header Controls

• / Sidebar Toggle: Show/hide the expression/library list panel
• Expression / Script: Text button to toggle between Expression and Script modes
• Save to Library: Saves the current code to your expression/script library
• Settings Button: Opens the settings dialog
• Apply Expression / Run Script: Applies the expression to selected properties or runs the script

Footer Controls

• / Word Wrap Toggle: Enable/disable word wrapping
• Format Document: Auto-format your code
• Find: Open the find/replace dialog (Cmd/Ctrl + F)
• JS / TS (Script mode only): Switch between JavaScript and TypeScript

Working with Expressions

Loading Expressions from a Composition

1. Make sure you have an active composition with expressions
2. Click the Load Expressions button in the navigation panel
3. All expressions in the comp will be listed, grouped by layer

Selecting and Editing Expressions

1. Click on any expression in the list to load it into the editor
2. Edit the expression in the Monaco editor
3. As you type, real-time validation will check for errors
4. IntelliSense will provide auto-completion suggestions

Multi-Selection

You can select multiple expressions to apply changes to all at once:

• Cmd/Ctrl + Click: Add/remove individual expressions from selection
• Shift + Click: Select a range of expressions

When multiple expressions are selected:

• The editor shows the first selected expression's code
• Applying changes will update all selected expressions
• A warning appears if selected expressions have different code

Applying Expressions

There are several ways to apply expressions:

1. To a selected expression: Select an expression from the list and click Apply
2. To multiple expressions: Multi-select expressions and click Apply to update all
3. To a property in AE: Select a property in After Effects and click Apply
4. To multiple layers: Use a library item with a default property (see Library section)

Real-time Validation

In Expression mode, expressCode validates your code in real-time:

• Errors appear in a banner at the bottom of the editor
• Validation happens 1 second after you stop typing
• Uses the actual After Effects expression engine for accuracy

Working with Scripts

Script Mode

Switch to Script mode using the toggle in the header to write and run ExtendScript scripts.

Running Scripts

1. Write your script in the editor
2. Click the Run Script button (same as Apply in Expression mode)
3. The script executes in After Effects
4. Success/error status appears in the header

JavaScript vs TypeScript

In Script mode, you can choose between JavaScript and TypeScript:

• JavaScript: Direct ExtendScript (ES3)
• TypeScript: Full TypeScript with type checking, transpiles to ES3

Toggle between languages using the footer controls.

TypeScript Features

When using TypeScript in Script mode:

• Full type checking with IntelliSense
• Hover documentation for After Effects API
• Parameter hints and auto-completion
• Automatic transpilation to ES3-compatible code
• ES5 method transforms (see ES5 Helper Reference)

Error Handling

Script errors are caught and displayed with:

• Error message
• Line number
• Stack trace (when available)

Library System

The library system lets you save and organize your favorite expressions and scripts.

Viewing the Library

• Expression mode: Click the Book icon to toggle between Comp Expressions and Library views
• Script mode: Always shows the Script Library

Adding Items to Library

1. Write or load an expression/script in the editor

2. Click the Save to Library button in the header

3. Fill in the dialog:

   • Name: A descriptive name for the item
   • Description: Optional details about what it does
   • Category: Choose or create a category
   • Default Property (Expressions only): Optional property match name for batch application

4. Click Save

Default Property for Expressions

Setting a default property allows you to apply an expression to multiple selected layers:

1. Set a default property when saving to library (e.g., ADBE Transform Group|ADBE Position)
2. Select multiple layers in After Effects
3. Select the library item and click Apply
4. The expression will be applied to the default property on all selected layers

To auto-fill the default property:

• Select a property in After Effects
• Click the arrow button next to the Default Property field

Editing Library Items

1. Hover over a library item in the list
2. Click the Edit button (pencil icon)
3. Modify the name, description, category, or default property
4. Click Save

Note: Editing metadata doesn't change the code. To update code:

1. Select the library item
2. The "Save to Library" button will show "Update or Add New" dialog
3. Choose "Update Existing" to replace the code

Deleting Library Items

1. Hover over a library item
2. Click the Delete button (trash icon)
3. Confirm the deletion

Categories

Library items are organized by categories:

• Categories are sorted alphabetically
• Categories are collapsible
• You can create new categories when saving items
• Separate categories for expressions and scripts

Advanced Features

IntelliSense

expressCode provides full IntelliSense for the After Effects API:

Expression Mode IntelliSense:

Script Mode IntelliSense:

• Auto-completion: Type to see suggestions (e.g., type app. to see all app methods)
• Parameter hints: See function parameters as you type
• Hover documentation: Hover over any API to see documentation
• Go to definition: Not available (read-only API definitions)

Settings

Click the settings icon to access:

• Storage Location: Where library files are saved (defaults to user data folder)
• Skip Layer Names: Comma or line-separated list of layer names to exclude when loading expressions
• Library Categories: Create, edit, or delete categories for library items

Responsive Design

expressCode adapts to narrow panel widths:

• Below 600px, it switches to a single-panel view
• Toggle between navigation and editor using the back arrow and code icon buttons
• Perfect for working with limited screen space

Next Steps

• Explore the ES5 Helper Reference to learn about modern JavaScript features in scripts
• Check out the TypeScript Reference for TypeScript-specific features
• See the FAQ for common questions