X-FX Handler

Filmtools Home

Help Download Donate

Moving projects from one machine to another (or even working with more than one user on one machine) sometimes can cause trouble: some effects seem to be missing.
In several cases within the FCP X user interface they seem to be available which makes it even more weird.
The reason for this is that FCP X always looks for the effect path used in the original document. This path might not be available on the other machine or for the other user.
Same is valid for fonts, they are even more confusing - there is no "missing icon". They are silently replaced by Helvetica with a ridicolus small size.

You can relink video, audio, stills etc. but you can't relink effects and this can be a problem.
To learn more about the organization of templates you can download the help manual here.

So it is a good idea to do a kind of preflight before moving and/or startingto work.
A FCP X XML is a good starting point. It contains all used effects and the expected paths to them.
You can create a XML. All assets and effects will be listed in the "resource" part of the XML. So you can open the XML in TextWrangler (or something similar) and find the "effect" entries and their paths (uids) manually. This is both time consuming, boring and not effective.

Here comes X-FX Handler.
X-FX Handler uses the XML features of Final Cut Pro X.

It will extract the FX information (Motion Templates) and list them. Usage of them for every clip in a timeline is listed.

There are 3 ways to use the application.

First get a list and then modify an existing XML (FCPX 10.0.9 or below is not recommended – use 10.1.x and higher).
The application scans the XML for any "effect" entry and the base settings.

The result will be listed in a table view showing what have been used how many times.
This information allows to get an overview of the FX used in your timeline which you won't have inside FCPX.

The application also allows the remove, disable and enable FX within the XML. The XML can be imported into FCPX again to have a copy of your original timeline with modified settings – might be helpful for reviewing versions.

Second usage is to create a report about the used external Motion Templates.
This will scan the XML for used templates only and check the availability and the details.
You can save the report either as formatted text or as a tab text file for import into a data base.

Third usage is to extract the fonts used in the project.


Finally you can create the Motion Template Folders you need without the burdon to be responsible for correct extensions and correct locations - just one click and they will be there (or the missing ones will be there).

Download X-FX Handler for Mac

Even though the app is free you might think about a donation to support development. Make a donation



  • 1.0 First public release
  • 1.0.11 Extended report options, support for FCP X library XMLs.
  • 1.2 (0.1s) Sierra compatibility.
  • 1.2 (0.92) added features High Sierra compatibility.

Known issues:

But as always there might be unknown issues.

Fine print:

As always use the app on your own risk. I'm not responsible for any damages that might happen.
Support is based on a 'I've spare time this moment', so sometimes you may have to wait for a few days to get a response.
But I'll do my best.


System Requirements
• Apple Intel (the faster the better).
• 4096 MB RAM (more = better), enough space for virtual memory
• MacOS X 10.6 +

For further information contact
Andreas Kiel
Nelkenstr. 25, D-76135 Karlsruhe
eMail: kiel at

What some people are saying about the X-FX Handler

"This humble application is an incredible resource for tracking down and managing offline or missing effects in Final Cut Pro X.
Mark Spencer, Ripple Training "

"I found your new tool and it will be a real lifesaver. We are doing a major film on FCPx and some of our XMLs have refused to import. One pass through your software and they import successfully."

"Andreas, you're a star. That's fixed it. Super useful."