Actions provide a platform for users to extend ftrack. Native to the system, Actions allow users to tightly integrate processes such as generating reports, automate repetitive tasks, create file system structures and much more. These Actions appear directly in the ftrack web interface, making them seamless and easy to use. With any Action you can also customise parts of the UI and request additional information from the user before the Actions run (i.e. requesting an email address to send a report to).
Frequently Asked Questions
How do I download and install Actions?
You can download our sample Actions below (as Python files), or visit our Action repository on Bitbucket to see all available Actions that we share. We also hope that our ftrack community will share their Actions on our community forum.
A future release will support “one-click” install for non-technical users. In this first release you will need to configure the Actions in code (setting the server to connect to for example) and then either run them manually or configure them to run as part of Connect. Check out this quick Getting Started guide
Can anyone install and run Actions?
Yes, but only if they have a valid API key. API keys are used to control access to resources through the API. For example, it is possible to have an API key that can only perform read-only operations for general use whilst a separate API key might have full write permissions.
If you are developing an Action only for yourself, you can use your Personal API Key (Please note, this API key could have restrictions, it depends on what your ftrack administrator has allowed users to do).
Can I share my Actions with the community?
Yes, our goal is to make Actions easy to share. In this first release you can share your Actions on our community forum (you will need to register if haven’t already). In the future we are looking into having a more dedicated platform for this, both as a page on ftrack.com, and integrated into our products like ftrack and Connect.
Can I make changes to the Actions you have provided??
Absolutely. You can download any Action and customize it in any way you want.
How will Actions evolve?
We have focused on getting Actions out to the community as soon as possible, so of course there is more great stuff to come including richer UI’s, easier install, Actions management for bigger companies and a platform for downloading and sharing Actions.
These are simple instructions to install and run Actions for testing and personal use. For studio usage you might prefer to centralise your actions and manage them with something like Supervisor for example.
- Make sure you have installed the ftrack Connect desktop service.
- Download you Action from our Code repository or community forum and save it on your computer.
- Start Connect and click on the service menu and “Open plugin folder”.
- Create new sub-folders inside the plugins folder with the name of your action, e.g. <ftrack-plugins-folder>/my-fancy-action/hook/.
- Now place the action .py file inside the hook/ folder.
- Quit and start Connect again to reload your new action.
Get started developing your first Action
While we will supply you with ready made Actions you sometimes need to roll your own. Luckily it’s easy to develop your own Actions. You can base you action on one of our sample Actions or you could create your own from start to finish with our Boilerplate code