AE Script Runner for VS Code 🚀

A professional-grade VS Code extension for After Effects developers, offering seamless TypeScript workflow integration and multi-version AE script execution capabilities.

▲ Direct script execution from VS Code interface

✨ Key Features

• Full Format Support Native execution of .jsx, .jsxbin, and .tsx script formats
• Intelligent Version Detection Auto-detects installed AE versions with interactive selection menu
• Cross-Platform Operation Full compatibility with both Windows and macOS environments
• TypeScript-Centric Workflow Integrated Rollup build system with modern ES features support
• Real-Time Development Instant compilation through Rollup's --watch mode

🚀 Usage Guide

1. Open AE Script File Launch any .jsx or .tsx file in VS Code
2. Execute Script
   • Click the ▶ Run Script button in editor toolbar
   • Right-click in editor and select Run AE Script
   • Use keyboard shortcut <kbd>F5</kbd>

▲ Multi-version AE detection interface

🛠 Quick Start (typescript projects)

Prerequisites

• Node.js v16+
• TypeScript 4.9+ (TypeScript projects only)
• Rollup 3.x (TypeScript projects only)

Installation (TypeScript Required Dependencies)

npm install -D \
  rollup \
  json5 \
  @rollup/plugin-typescript \
  types-for-adobe \
  @babel/core

⚙ Configuration

Recommended tsconfig.json

{
  "compilerOptions": {
    "target": "ES3",
    "outDir": "./dist",
    "strict": true,
    "types": ["./node_modules/types-for-adobe/AfterEffects/22.0"]
  },
  "include": ["src/**/*.ts", "src/**/*.tsx"]
}

Standard Project Structure

.
├── .vscode/
│   └── settings.json    # Configuration storage
├── dist/                # Compiled outputs
├── src/
│   ├── lib/             # Shared libraries
│   ├── utils/           # Utility functions
│   └── main.tsx         # Entry point
├── rollup.config.js     # Build configuration
└── tsconfig.json        # TypeScript settings

🔧 Advanced Configuration (TypeScript Projects)

Rollup Build Example

// rollup.config.js
import typescript from '@rollup/plugin-typescript';
import jsxbin2 from 'rollup-plugin-jsxbin2';

export default {
  input: 'src/main.tsx',
  output: {
    file: 'dist/script.jsx',
    format: 'cjs'
  },
  plugins: [
    typescript()
  
  ]
};

multi-version AE detection configuration

.vscode/settings.json

  "ae-tsx-runner": {
    "input": "....tsx",
    "output": "....jsx",
    "hostSpecifier": "22.0(win)/Adobe After Effects 2025(mac)" // special id for windows and app name for macOS
  },

📜 Version History

Full Changelog

🙌 Acknowledgments

• Type definitions provided by Types-for-Adobe
• Inspired by ae-script-runner

📄 License

MIT License © 2025 Yueli