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 Photoshop CC 2015. If you are using Adobe Photoshop 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

See also

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

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

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 Photoshop CC 2014 or CC 2015
  4. Install Extendscript Toolkit CC
  5. Open and quit Photoshop 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-photoshop repository and switch to appropriate branch.
git clone git@bitbucket.org:ftrack/ftrack-connect-photoshop.git
  1. In a terminal window, navigate to the repository root and install dependencies:
npm install
  1. To build and install the extension in debug mode, run:
grunt debug
  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 Photoshop 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