Installing

  1. Download the extension from https://www.ftrack.com/downloads

  2. Make sure you have the following dependencies installed

  3. Open ZXP Installer.

_images/install_extension.png

Note

ZXP Installer is required for installation with Adobe After Effects CC 2015. If you are using Adobe After Effects CC 2014 and have Adobe Extension Manager installed you can use it instead of ZXP Installer.

4. Locate the downloaded ZXP file and install it by dropping it on ZXP Installer

All done! See Using for instruction on how to use the extension.

Troubleshooting installation

Currently, due to limitations in Adobe’s installation procedure, you will need to have either Adobe Photoshop or Adobe Premiere installed in addition to Adobe After Effects. If you do not have one of the additional applications installed, the installation will fail with error code 411.

The extension will appear in the other applications as well, but will only be usable within Adobe After Effects

See also

If you get any other errors during installation see Troubleshooting installation for more information.

Building from source

Note

Unless you are doing any modifications, there should be no need to build the extension yourself.

To build the extension you will need to have a few Adobe applications installed, available via Creative Cloud. You will also need to have Node.js with NPM installed.

The extension is built using grunt-cep.

Instructions

  1. Install ftrack connect.
  2. Install Creative Cloud
  3. Install After Effects CC 2014 or CC 2015
  4. Install Extendscript Toolkit CC
  5. Open and quit After Effects one time once it is installed.
  6. Install Node.js with NPM
  7. Install the Grunt command line interface (globally):
npm install -g grunt-cli
  1. Clone the ftrack-connect-after-effects repository and switch to appropriate branch.
git clone git@bitbucket.org:ftrack/ftrack-connect-after-effects.git
  1. In a terminal window, navigate to the repository root and install dependencies:
npm install

11. To build and install the extension in debug mode, run (replace family with CC2014 if you want to run CC2014):

grunt debug --family=CC2015
  1. To build and sign a release package, run:
grunt release
  1. The extension is opened from Windows ‣ Extensions.
  2. Remote debugging is possible by opening localhost:<port> a web browser.

Note

The port number to use for remote debugging can be found in build/debug/.debug after grunt debug has been executed.

Note

When installing dependencies, you might get a compilation error when building ws. You can safely disregard from this error.

Note

Under windows, grunt-cep will assume that you are running Node and Adobe After Effects with the same bitness (e.g. both in 64-bit versions) and will fail to install the extension otherwise. You can install the dependency manually by first running grunt build and then copying the build/debug directory to C:\Users\<username>\AppData\Roaming\Adobe\CEP\extensions\. Enable debug mode in the windows registry by adding a string value with the key PlayerDebugMode and value 1 in HKEY_CURRENT_USER\Software\Adobe\CSXS.5.

Dependencies

Additional dependencies for building