Use Key Spill Mop Up when the unwanted color is confined to pixels you can target with the preceding key’s transparency or an edge mask, or with a color-based mask you can inspect. Consider Despill when reflected green or blue contamination affects foreground colors more broadly and you want to diagnose its screen-type and spillmap controls. These are different mechanisms, not equivalent ways to obtain the same result. Judge the choice on the same representative frame by checking both the cutout edge and the subject’s colors.
Decide the scope and make a controlled comparison
First identify where the spill appears. A colored fringe around hair or a shoulder, with the subject’s interior looking natural, points toward an edge-limited correction. A green or blue cast across skin, clothing, or other foreground areas suggests broader reflected contamination. These are diagnostic clues, not proof of which effect will work better.
- Choose one frame that shows both a clear cutout edge and a representative area of the subject. Note the problem spots and at least one nearby area that should not change.
- Check the keying result’s alpha. If it contains useful partial transparency at the contaminated boundary, try Key Spill Mop Up with a Transparency mask. Its documentation says this mask works on pixels that are neither fully opaque nor fully transparent, according to their alpha from the preceding chroma key.
- If the contamination lies next to the opaque subject boundary rather than in useful semitransparent pixels, try an Edge inwards or Edge outwards mask. The manual describes these as edge-proximity masks, and notes that the documented edge algorithm is a temporary solution that may change. If the keyed edge is hard, a Transparency mask has no partially transparent pixels to act on.
- Use a color-distance mask only when the affected pixels are identifiable by color rather than by alpha or edge location. It is based on image color and, apart from ignoring fully transparent pixels, does not depend on the preceding key’s alpha. Hue gate and Saturation threshold can further restrict the mask; inspect the result rather than assuming those settings protect every clean color.
- Consider Despill when a screen-color cast appears across foreground regions that an edge or transparency mask would not cover. Check the actual Screen type label, then treat Spillmap Mix, Spillmap Expand, color scales, and Brightness as Despill-specific variables to examine one at a time. The Kdenlive Despill documentation describes these controls; it does not establish that they behave like a mask or guarantee a particular correction.
The Key Spill Mop Up manual also documents Show mask as a grayscale view for tuning the selected mask. Use it to see where the correction is scoped, then turn it off before judging the color image. A mask preview cannot establish that the final colors are acceptable.
Compare separate acceptance signals
The following is a hypothetical worksheet, not a software test or a promised effect result. Its observations are example notes a creator might record while comparing the same frame. The labels and settings describe what to inspect; the counts are not a model of Kdenlive’s mask calculation.
| Candidate and hypothetical observation | Edge contour | Subject neutral area | Nearby clean area | Decision to record |
|---|---|---|---|---|
| Key Spill Mop Up: Transparency mask; mask preview includes the soft shoulder fringe but not the opaque sleeve | Fringe still looks green in the color view | Sleeve stays neutral | Unchanged in this frame | Scope seems relevant, but this setting has not passed edge review; assess whether an edge mask is a better fit |
| Key Spill Mop Up: Edge mask; preview extends across a strip of the sleeve | Fringe looks less colored | Sleeve now looks slightly magenta | Sleeve color shifted | Do not approve on edge appearance alone; reconsider mask extent or operation strength |
| Despill: Screen type set to green; hypothetical first comparison reduces the cast on the shirt but dulls a neutral cheek area | Hair outline remains visible | Cheek looks gray | A pale prop also looks less saturated | Record both changes; inspect Despill’s own controls or compare another candidate rather than calling this equivalent to a mask repair |
For each candidate, compare the edge contour, a subject neutral such as a gray garment or cheek highlight, and an unpolluted area on the same frame. The worksheet’s observations are hypothetical, not expected outcomes. A single impression such as “the frame looks less green” is not enough: a correction can reduce a cast while also shifting colors that were already clean.
Limits and the next move if it fails
Neither mechanism can restore image detail that the footage does not contain. The supplied documentation describes color and mask controls, but does not promise recovery of clipped channels, erased texture, or a universally correct setting. Keep the question scoped to visible contamination, not missing detail.
If Key Spill Mop Up affects clean areas, return to the Show mask view and check whether the mask follows the intended pixels. If the preceding key created a hard edge, do not expect Transparency masking to find partial-alpha pixels that are absent. An edge mask may be worth comparing, with care because the manual calls its algorithm temporary. If a color-distance mask reaches unrelated colors, adjust the mask restrictions or use another scope decision rather than treating the effect name as a guarantee.
If Despill changes the subject more broadly than intended, verify the Screen type label against the actual screen color, then compare its spillmap and color-scale controls as separate variables. The manual documents green and blue screen choices and parameter purposes, but does not specify a universal tuning sequence or tell you that changing one value will preserve a given skin tone. Do not use node color alone to identify an effect; read its type label. If neither candidate passes both edge and subject-color review, leave the correction unapproved and revisit the key or the shot’s color treatment rather than hiding the failure in an overall visual impression.
Common questions
Is a Transparency mask enough for a hard key? Not when the preceding key leaves no partially transparent pixels. The Kdenlive manual says that this mask has no areas to affect in that case; compare an edge mask if the spill is actually near the contour.
Does Show mask show the finished despill color? No. It is a grayscale view of the selected Key Spill Mop Up mask, intended for mask tuning. Turn it off and assess the color image separately.
Should I choose Despill whenever the whole subject looks green? Treat that as a reason to evaluate Despill, not an automatic diagnosis. Confirm that the cast is screen-reflection contamination, use the matching Screen type label, and check both affected and clean foreground colors on the same frame.
Sources and next step
- Key Spill Mop Up — Kdenlive 26.08 Manual 26.08 documentation
- Despill — Kdenlive 26.08 Manual 26.08 documentation
This guide interprets public documentation and uses explicitly hypothetical acceptance examples, not application tests. Controls and availability can change; verify the cited manual against your installed version.
For work created in Imagild, carry the input requirements and acceptance checklist into the film workspace. The external software controls discussed above belong to their respective products.