Skip to main content

ftrack.connect.application.launch

The ftrack.connect.application.launch synchronous event is triggered when an application is launched using the built-in Connect ftrack_connect.application.ApplicationLauncher.

It can be used to modify the environment and arguments used when launching applications using subprocess.Popen.

Example event passed to hook:

Event(
  topic='ftrack.connect.application.launch',
  data=launch_data
)

The passed data variable, launch_data is a dictionary containing:

  • command: The first argument passed to subprocess.Popen, containing a list of the command should run.
  • options: A dictionary with keyword arguments passed to subprocess.Popen.
  • application: A dictionary containing information about the application that is being launched.
  • context: The ftrack entity context that the application is being launched for.

Modifications to the launch_data dictionary, either by replacing the content or modifying it directly, will be picked up and used by the application launcher.

Integrating

Launching an application is usually not enough to have ftrack integrated. In order to do so, integrations are provided separately.

Integrations are packaged as Connect plugins, for detailed information about how these are created, see the Framework Connect Plugin documentation.