FCP X: Create a Chroma-key

Posted on by Larry

I’ve covered chroma-keying (also called green-screen keys) in my FCP X video training, but haven’t written about it. So, time to fix that lack.

This article looks at how to chroma-key using Final Cut Pro X. (This article shows how to chroma-key using Final Cut Pro 7.)


First, the best thing you can do to improve the quality of your keys is to improve how you shoot them. Here are seven basic production rules:

  1. Actors should be at least 10 feet in front of the green screen. This avoids light from the background “spilling” around their body or shoulders.
  2. In general, don’t cast shadows on the green screen. Be very careful shooting feet.
  3. The green background should be as smooth as possible. Paint is always better than fabric; avoid wrinkles and folds.
  4. The green background should be lit smoothly, both from side to side and top to bottom. I try to have the green background display between 40-50% level on the waveform monitor.
  5. There is NO relationship between how the background is lit and how your actors are lit. This example will illustrate that.
  6. Light your background for smoothness. Light your actors for drama.
  7. Don’t worry about having the green background fill the frame. It only needs to completely surround the edges of your actors. Garbage mattes are used to get rid of the junk.


The green screen image is always placed above the background. You can place either the green screen or background image into the Primary Storyline. I find it easier to put the background in the Primary Storyline, because it makes editing the green screen image easier. But this is purely personal choice.

Select the green screen clip.

From the Effects Browser > Keying category, double-click the Keyer effect, which applies it to the selected clip. (You can also drag the effect on top of the clip, if you forgot to select the green-screen clip first.)

Don’t panic if your image looks weird – we will fix it.

Click the Sample Color icon. This allows fine-tuning the selection of the background color.

In the green-screen image, drag to select a representative section of the background. I try to get close to the face, but not so close that I accidentally select loose hair or skin.

Your key should look better immediately. Most of the time, you can probably stop here. But there are three other adjustments that can make your key look even better:

* Cleaning up the matte
* Edge adjustments
* Light wrap

Click the Matte button to display your key as a white foreground on a black background.

Your goal is the make the foreground solid white, which means opaque, and the background solid black, which means transparent. Adjust the Fill Holes and Edge Distance sliders until your key looks solid. (For REALLY bad keys, you’ll need to also adjust Color Selection, mentioned below.)

If an edge is too pronounced, or needs help, click the Edges icon.

Then, click and drag a line from the foreground to the background in the Canvas. Drag the midpoint slider (where my cursor is) until the edge looks the best it can. Different video formats make this easy (ProRes), while others (HDV, AVCHD) make this much harder. Perfection is impossible – do the best you can.

New with the 10.0.3 release are four additional tweaks at the bottom of the keyer filter:

* Color Selection
* Matte Tools
* Spill Suppression
* Light Wrap

The first three are designed to clean up poorly shot keys – read the FCP X Help files to learn how these work. (I used the Color Selection tools to clean up the key I show later in this article.)

Light wrap, though, is aesthetic. What it does is blend colors from the background into the edges of the foreground, to make the entire key look more “organic,” as if the foreground and background were actually in the same space.

This is a subtle effect, but very cool.

Twirl down Light Wrap and adjust the Amount slider and watch what happens. Drag the other sliders around and see what happens. The nice thing about this setting is that when it looks good to you, it is good. The amount of the effect is totally up to you.

Remember, Light Wrap only affects the edges of the foreground and should be used subtly.

When you are done, you have a great looking key!


Sometimes, however, you don’t have, um, perhaps, the best green-screen image to work with. Here, for example, there are lighting instruments in the foreground, with a completely inadequately lit green screen in the background. (Sigh… just awful.)

Once you pull the key – which is film-speak for creating a green-screen shot, as I described above – and get it looking as good as possible, there’s one more step: adding a garbage matte to get rid of all the garbage.

Once you get your key looking as good as you can – which in this case isn’t all that good – drag the Mask effect (Effects > Keying > Mask) on top of the green-screen clip.

NOTE: The Mask effect should always be added after the Keying effect, so that the Mask is below the Keyer in the Inspector.

Then, drag each of the four circles to create a shape such that your foreground image is contained inside it, and everything you want to exclude is outside. Here, for instance, we removed the light stand and the tearing around the top of the image. I’ve found this Mask effect works best when applied to a connected clip, though Apple cleaned up a bug that prevented it from working when applied to a clip in the Primary Storyline.

However, the big limitation of the Mask effect is that you only have four points to work with. That’s where a free effect comes in, which allows you to create far more flexible shapes with it.

It’s written by Alex Gollner and is available on his website – alex4d.wordpress.com/fcpx/ – I recommend his effects highly.

Apple totally rewrote the chroma-key filter in FCP X — it is far better than the filter supplied with FCP 7 — which allows us to create some amazing effects. Have fun playing with it.

LEARN MORE: Want to learn more about chroma-keying, and luma keying, in FCP X? Check out this chapter of my FCP X video training.

Bookmark the permalink.

16 Responses to FCP X: Create a Chroma-key

  1. […] of two articles on chroma-key. This article shows you how to chroma-key using Final Cut Pro 7. In this article, I show you how to chroma-key using Final Cut Pro […]

  2. Brent says:

    I’m trying out this tutorial with a video of me holding an iPhone and kind of going through some of the screens. However, everything that is green on the iPhone screen is filtered/masked out just like the background green screen. I put a white background on it and the green colors on the iPhone screen turn white/grayish.

    Any suggestions on how to fix this?

  3. […] For an article on how to use the chroma-key filter, click here. […]

  4. Petre Nicolescu says:

    Thank you for this very informative material.
    Still, the guys from Apple didn’t really think it through when they implemented the spill suppressor. If I am allowed to choose any color for background then the spill supressor should compensate for ANY color as well, not only for the complement of either green or blue. This is really silly. I tried to cut out a blue flower (which of course has a lot of green, blue and some white). Although the result was ok-ish, I can imagine other situations and color combination in which the magenta spill added by the supressor can render awkward results.

    Thank you for your lessons.

  5. Benito says:

    Thanks for the tutorial, it works perfectly for me.

    I’m doing a green chroma key, and I’m trying to change the background to pure white.
    I’m using a custom generator in the background, but the result is not pure white, but a little bit grayish.

    Do you have any suggestions in what to do?

    thanks in advance.

  6. chase sumner says:


  7. Michal Mrhy says:

    Hello, I would like to ask you for a favour.
    I ve tried to make keying via final cut 10. And I have problem, I ve changed background no problem by Keyer, but, I when I do dit, so unfurtunately automatic changed also the colour of body human (it very going to white color).

    Can you help me pls? What I should to do? thank U very much!

  8. Mike Beanland says:

    HI Larry,
    After reading your greenscreen piece I just spent 2 weeks (actually a bit longer, about 150 hours) on a 45 minute green screen training video. It was 45 minutes of me in front of a green screen. I put 45 minutes of ocean waves as a background, on the primary storyline, the talking head with the greenscreen above it – and edited away.
    Literally thousands of carefully timed and attached clips later and edits and titles etc etc , and I have just realised that every single attached clip is attached to the background, which is the ocean and not the talking head. They have all been timed in sequence with words and actions of the talking person in the green screen layer, but not linked to these clips. So if I want to move anything of the talking head does, or cut or adjust anything that the talking head does, not a single other thing will be correct, as it is all linked to the ocean background.
    Aaargh, what a disaster.
    That is a huge negative of putting the background on the primary storyline.
    I realise that the most important story must be the storyline.
    Is there a solution?
    Can I move all attachments to the talking head clips? Or change the primary storyline away from ocean to the greenscreen talking head?
    Any ideas Larry?

    • Larry says:


      You make some good points. Fortunately, there’s an easy solution to this: it is very easy to edit a selected connected clip into the Timeline. All you’ll need to do is replace your ocean wave background.

      First AS A TEST!! select the first talking head clip in your project. Only use one – if it doesn’t work, you can easily Undo.

      With the talking head clip selected, choose Edit > Overwrite to Primary Storyline. This will drop the connected clip precisely down to the Timeline, where it will overwrite (replace) your background waves clip. This move will include all effects and trims so that everything remains just as you had it.

      Then, add the background waves as a connected clip BELOW the green screen clip in the Primary Storyline. (Yes, below seems like heresy, but it works perfectly fine.)

      Once you see how this works for one clip, select all your talking head clips and overwrite them all at once.

      Problem solved.


  9. Hi, Larry

    I have a baffling issue. I am using FCP 10.0.5. In one project, when I apply chromakey to clips taken in portrait orientation, the keying creates a square frame around the center of the shot and entirely masks the image above and below. I’ve successfully used keying on other portrait shots in other projects. I’ve tried re-importing the files, and creating a new project. When I import other portrait-oriented clips (that had keyed correctly in old projects) into my new project, they also behave this way. I can’t seem to find any help on the internet on this issue.

    Thanks for your help!

    (Your tutorials are brilliant and incredibly helpful by the way.)

    • Larry says:


      First, you are using a very old version of FCP X, so I would not rule out a bug in the software. You might consider upgrading at your earliest convenience.

      Second, this sounds like the software thinks the clips are contained in a compound clip with different dimensions than the project. Be sure you are working directly in the project.

      Third, try creating a project using standard HD dimensions, say, 1080p and do your green screen there. If the clip keys properly – aside from have excess black around the edges due to the mis-matched frame size – this you are probably seeing a problem caused by you non-standard video dimensions.

      As a work-around, try doing the key using a compound clip sized to, say, 1080p. This will have black around the edges, but should yield a clean key. Then, when the key is complete, edit the compound clip into a project with the vertical dimensions you need, which should keep the key but lose the black edges.

      Let me know if this works.


  10. SadMac says:

    Hello from Russia to my favorite teacher Larry and to his great team : )

    Let me ask about masking out an object from the Keyer effect?
    (but sorry for my English, especially when dealing with “a” and “the” articles… I hope Debbie from your team will not see it)

    Let’s say, a person on a green screen has a green logo on his white shirt (sure, we need to do it on a blue screen, what the heck!)

    Now when we need to leave the logo in the picture while keying the frame we need to do a lot of actions here, don’t we?
    While all other FCPX effects now have a mask option the Keyer hasn’t (I believe there is a reason, but can’t imagine why).
    So we need to make the duplicated clip over the primary clip and apply the mask effect on it… and if we have a lot of clips at the end of the day we get the whole mess with duplicated connected clips all over the timeline… and we need to compounding all this… stuff…

    What a wasting of actions!
    Or maybe I just got it wrong?

    In Adobe Premiere the masking option is right there in the keying effect just in one button… but I don’t like PrPro, I want this in FCPX.
    I meet a questions about this all the time when I bring a new user to FCPX from PrPro and I have nothing to say them : )

    Thanks for attention. Please, correct me if I’m wrong

    • Larry Jordan says:


      You are correct – to preserve a green logo inside a keyed shape, you need to duplicate the clip as you describe. There IS a mask built into the keyer, the same as Premier – but they both do the same thing: get rid of garbage in the frame, rather than preserve an element inside the keyed shape.


Leave a Reply

Your email address will not be published. Required fields are marked *

Larry Recommends:

FCPX Complete

NEW & Updated!

Edit smarter with Larry’s latest training, all available in our store.

Access over 1,900 on-demand video editing courses. Become a member of our Video Training Library today!


Subscribe to Larry's FREE weekly newsletter and save 10%
on your first purchase.