OBS Studio · Practical guide

OBS Luma Key: Remove a Black or White Background Carefully

Test brightness-based keying on a graphic, preserve intentional dark or light details, and decide when an original transparent export is the better fix.

START HERE

Luma Key makes pixels transparent by brightness. Use it only when the unwanted background is separable from details you need, and test the result over contrasting backgrounds through the full animation.

Test brightness-based keying on a graphic, preserve intentional dark or light details, and decide when an original transparent export is the better fix.

In this guide
Before you start
  • A copy of the asset and permission to use it.
  • Two contrasting background colors in an OBS test scene.

Check whether brightness can separate the background

A white mark on a black field may be a useful luma-key candidate; a dark logo with a black shadow on the same field may not be. Inspect which parts of the design share the unwanted background’s brightness. The filter cannot infer that one black pixel is background and another belongs to the logo.

OBS documents Luma Key as a brightness-based opacity effect, distinct from hue-based Chroma Key. Before applying it to an asset supplied as transparent, check whether you selected the intended export. Keying is a deliberate treatment, not a way to recover an alpha channel that was never present.

Build a test that exposes damaged details

Place the asset above a saturated color background and keep another strongly contrasting background ready. View it at the size you expect to use and at a larger inspection size. Save the unfiltered reference so you can compare thin outlines, shadows and small text.

For animation, identify the brightest and darkest moments before choosing thresholds. A setting that preserves the first frame may remove a flash, fade or moving shadow later. The full clip, including its loop boundary, needs to be part of the acceptance check.

Tune the boundary with the artwork visible

  1. Add Luma Key to the asset

    Open the asset’s Filters and add Luma Key. Keep the contrasting background visible beneath it and note the starting values.

    Look for: You can distinguish transparent areas from pixels that merely look black in Preview.

  2. Adjust the relevant threshold

    Raise the minimum to remove darker pixels or lower the maximum to remove brighter pixels, making small changes while inspecting details that must remain.

    Look for: The unwanted background recedes without immediately erasing essential artwork.

  3. Tune the edge and compare backgrounds

    Use the matching smoothing control cautiously, then inspect the complete animation over both backgrounds. Record the result at output size.

    Look for: Edges remain acceptable across light and dark surroundings and throughout the asset’s motion.

Stop when the background and artwork overlap too much

If preserving the outline always restores the unwanted field, the asset may not contain a clean brightness separation. More aggressive thresholds can hide the rectangle while visibly damaging the design. Keep that tradeoff explicit instead of treating a disappearing background as the only success criterion.

For an asset intended to have transparency, obtain the appropriate export from its creator or re-export from the editable source if you own it. That usually gives a more controlled boundary than trying to reconstruct intent from a flattened image. Preserve the original file while comparing options.

Check the result in the actual layout

Put the treated asset over the real game, camera or background and inspect the edges during motion. A key that passes over flat test colors can still draw attention when a busy scene moves behind it. Verify that text remains readable and that partial transparency does not create an unintended ghost image.

Save the filter values with the exact asset version. A replacement export can have different brightness and edge treatment even under the same filename. Repeat the two-background check after a change rather than assuming the previous threshold remains appropriate.

Still stuck?

Removing the background also removes outlines or shadows.

The desired and unwanted pixels overlap in brightness; reduce the key or use an appropriate alpha export rather than forcing a destructive threshold.

Keep troubleshooting

Check the model and connection before trying another change. The device page gathers the related symptoms.

More help with OBS Studio ↗

Sources & references

Based on the linked first-party OBS documentation checked on 4 November 2026. The exercises and acceptance checks are editorial workflows for you to run; no hands-on OBS session or hardware benchmark is claimed.

  1. OBS — Luma Key Filter ↗Checked 2026-11-04

Spotted something out of date? Let Alex know.

How we put our guides together ↗
READ NEXT

A few places to go from here.

All stories

Overlay Background Black in OBS? Make It Transparent

Put a bright colour behind your overlay to see if transparency works, then fix the real cause: the wrong export, the source settings or a browser page.

Set Up a Green Screen in OBS Without Eating the Edges

Light the backdrop, choose the camera source and adjust the key while watching hair, clothing and motion.