How to Set Up Chroma Key in OBS Studio in 7 Steps

What is chroma key in OBS Studio?

Chroma key is a compositing technique that turns a solid background colour transparent so a different image can show through. In OBS Studio, the work happens through one specific filter called Chroma Key, attached to your camera source. The filter samples a key colour, builds a mask around it, then erases every pixel close enough to that colour. Direct setup path: Sources panel, right-click your webcam, Filters, Effect Filters, +, Chroma Key.

The streamer stays in the frame. The wall behind them disappears. Anything underneath the camera in the scene becomes the new backdrop, whether that is a gameplay capture, a static brand image, or an animated loop.

Streamers reach for it when they want to share a scene with the game without being boxed off in a corner cam:

• gaming streams where the broadcaster sits over the gameplay
• Just Chatting and IRL talk segments with a designed backdrop
• podcasts and co-streaming layouts with a shared scene

A static webcam frame just sits on top of your scene. Chroma key cuts the streamer out and pastes them onto the scene. The result is cleaner, more flexible, and far closer to what professional broadcasts use. Per the OBS Project documentation, the filter ships with OBS Studio by default — there is no plugin install step on Windows, macOS, or Linux.

What you need before adding the filter

A clean key starts with the inputs, not the slider values. If the camera, the screen, and the lighting are wrong, no parameter combo inside OBS will save the shot. Treat this as a checklist you walk through once before you ever open the Filters dialog.

1. The screen itself

The key surface is the foundation. Most home setups choose between two colours:

• green — the standard choice; works for almost every skin tone and clothes that aren't green
• blue — better when you wear red or green clothing, or if your hair carries a strong green reflection
• the surface must read as a single uniform tone across the full frame, with no creases or shadow bands
• the key colour must not appear on your skin, eyes, lenses, glasses frames, or wardrobe

Most streamers pick green because digital sensors carry more luminance information in the green channel. Logitech's chroma key guide makes the same point: the noise floor in green is lower, which gives the algorithm cleaner edges to work with.

2. A camera that puts out clean signal

OBS will use whatever device shows up under Video Capture Device:

• a webcam — Logitech C920, Brio, Razer Kiyo class is enough at 1080p
• a DSLR or mirrorless body fed through an HDMI capture card
• any UVC source the operating system already detects

Resolution matters less than noise. A noisy 4K stream from a low-light webcam keys badly. A clean 1080p stream from a well-lit webcam keys cleanly. If your camera image grains heavily under the actual stream lights, push more light at the subject before you raise the resolution.

3. OBS Studio (current build)

OBS Studio 30 and the 31 series both ship the Chroma Key filter under Effect Filters. Updates over 2025-2026 changed the GPU rendering path and added performance tweaks for AV1, but the chroma key UI and the four core sliders have stayed the same. The article values below match defaults you will see today on a fresh install. If you are running a fork (Streamlabs Desktop, OBS.live), the labels may differ but the underlying filter behaves the same.

4. Lighting on the screen and on you (separately)

This is the part most home setups get wrong:

• two soft fill lights aimed flat at the green screen for an even wash, not a hot spot
• a separate key light on you, ideally positioned 30-45 degrees off-axis from the camera
• no light bouncing off the screen back onto your skin (the cause of green halos)
• no shadows from your body hitting the screen

If a single lamp lights both you and the screen, the wall behind you will go darker where your body shadows it, and the keyer will read those shadow patches as a different colour. That is when the slider chase begins.

5. Distance from the screen

Stand at least 1-2 metres in front of the cloth or paper:

• this kills self-shadows on the screen
• it cuts down the green light reflecting off the cloth onto your skin and hair
• it gives the camera depth-of-field separation between you and the background

If the room is small, even 60-80 cm of separation helps. Touching the screen with your shoulder is the worst case.

6. Quick equipment sanity check

Before you start adding filters, confirm these basics work:

• the camera shows a live preview in OBS without dropping frames
• the microphone is selected and not duplicated as a system source
• the scene preview displays your camera output with the right framing

Sorting these now saves you from blaming the chroma key for a broken USB hub later.

How to prepare your space, lighting, and green screen

Even a strong filter cannot rescue a badly prepared room. The keyer reads pixels. Whatever you give it, that is what it works with. The closer your inputs are to a uniform colour wall plus a well-lit subject, the smaller the slider work and the cleaner the final image.

1. Mount and tension the screen properly

The screen has to read as one flat plane:

• stretched tight on a frame, or hung on a sturdy stand and pulled smooth
• no folds, no diagonal creases, no sagging in the middle
• fixed in place so a chair bump doesn't shift it during the stream

Folds in fabric create darker bands where light catches them at an angle. Those bands key as a slightly different colour, and the algorithm leaves them in the frame. A wrinkled screen is the second-most common cause of patchy keys behind bad lighting.

2. Kill glare and hot spots

Reflections punch holes in the key:

• never aim a lamp directly at the screen at a sharp angle
• skip glossy plastic backdrops; matte cloth or paper keys far better
• diffuse every light source through a softbox or umbrella

A bare LED panel pointed at green cloth produces a bright spot that reads almost white to the camera. The keyer then needs an aggressive Similarity value to remove that spot, and the same value will start eating your hair.

3. Light placement (the minimum scheme)

A workable home rig looks like this:

• two soft fill lights flat against the green screen on each side
• one key light on your face, soft, 30-45 degrees off camera
• an optional rim or hair light from behind to separate edges

The fill on the screen is the single biggest upgrade most amateur setups skip. With it, the screen becomes a uniform plane. Without it, the keyer is fighting brightness gradients you cannot fix in software.

4. Mind the distance from the cloth

Standing too close gives you predictable problems:

• shadows from your shoulders and head land on the screen
• the green wall throws coloured light onto your neck and ears
• the algorithm reads shadow-bands as a slightly different colour and keeps them

If you have to be close, push more light onto the screen and add a rim light behind your head to fight the spill.

5. Wardrobe rules

Whatever colour your screen is, your clothes can't match it:

• no green items if you key on green; no blue items if you key on blue
• no shiny synthetics that bounce green spill back at the camera
• avoid very dark fabric next to the key colour — the contrast confuses the edge mask
• thin or sheer materials catch ambient colour from the screen and look tinted

6. Why preparation pays off

When the room is right, the filter does the easy part:

• settings stop drifting between sessions
• you stop touching sliders mid-stream
• the result holds up at 1080p without sparkling edges

A well-prepared chroma rig takes 10-15 minutes to dial in once. A badly prepared one will eat hours over weeks while you tweak.

How to add a webcam source in OBS

Before the Chroma Key filter exists in your scene, OBS needs a video source to attach it to. That is the webcam. The flow is short, but skipping a step here is one reason streamers later complain that Chroma Key isn't in the filter list.

The full add path:

• Click into the scene where the camera should live, or create a new one with the + under Scenes
• In the Sources panel, click the + button
• Pick Video Capture Device from the menu
• Name the source clearly (Webcam, Cam-Logitech, etc.) so it is easy to find later
• Pick the actual camera from the Device dropdown
• Set Resolution / FPS Type to Custom and choose 1920×1080 at 30 fps as a sane default

After OK, the camera image appears in the preview. If it doesn't, another app is holding the camera; close Discord, Zoom, the camera app, or any browser tab using it.

Sanity-check the source before you go further:

• Windows or macOS reports the camera as connected
• the OBS preview is stable, with no black flash every few seconds
• no compression artifacts or freezes when you move quickly

Then size it on the canvas:

• drag the source into position
• scale with corner handles, hold Shift to ignore aspect for letterbox crops
• use Transform > Edit Transform if you want exact pixel placement

Confirm the raw camera output looks right with no filters. Once you add the chroma key, any noise or framing problem will be ten times harder to debug.

How to enable the Chroma Key filter (filter path)

With the camera source in place, the filter is two clicks away. This is the part every OBS chroma key tutorial races through, but the exact path matters because Chroma Key has to live under Effect Filters, not Audio Filters.

The full filter path:

• Right-click your webcam source in the Sources panel
• Click Filters
• In the Filters window, click + under Effect Filters (the bottom list, not the top one)
• Pick Chroma Key from the dropdown
• Leave the default name or rename it; click OK

What changes immediately:

• Key Color Type defaults to Green
• OBS samples the green pixels in the frame and turns them transparent
• the camera preview now shows you against a checkerboard or whatever scene element sits below the camera

What a clean baseline looks like:

• the screen is gone; the rest of the image stays put
• the streamer's silhouette has clean edges with no dancing pixels
• hair detail survives, even at the tips

Common visible issues at this stage:

• a green halo around the head and shoulders (spill from the screen)
• patches of green still showing in the frame (uneven lighting)
• missing chunks of face, ears, or hair (Similarity too high or wrong key colour)

These are not failures of the filter. They are signals that the inputs need fixing or that the four sliders below need tuning. The next section walks through the exact values to start with.

Adding the filter is the structural step. The visual result lives in the parameters.

Best Similarity, Smoothness, and Spill Reduction values

OBS Chroma Key exposes four numeric sliders plus a Key Color Type picker. The defaults are deliberately conservative — they pull a key without eating much of the subject. Most streamers only need to nudge each slider by 10-30 units once their lighting is right.

Reference values to start from on a fresh install:

• Similarity: 400-500 (default 480)
• Smoothness: 80-150 (default 80)
• Key Color Spill Reduction: 50-100 (default 100)
• Opacity: 100
• Contrast / Brightness / Gamma: 0 unless the camera image needs help

1. Similarity

Similarity controls how close to the key colour a pixel must be before OBS marks it as background. Push it up, more pixels disappear. Push it down, more pixels stay.

• low value (200-300): only the cleanest patches go transparent; green fringes survive
• default (around 480): handles a well-lit screen without touching skin
• high value (600+): erases stubborn patches but starts cutting hair, eyes, and shirt details

Raise Similarity in steps of 25 until the screen is gone. The moment you see hair or eyebrow detail flicker, drop back. The aim is the lowest Similarity that still hides the screen — not the highest you can push.

2. Smoothness

Smoothness softens the edge of the mask:

• low value (40-60): hard cookie-cutter outline; great with sharp lighting
• default (80): balanced; works for most webcam setups
• high value (200+): blurs the silhouette; can look out of focus

If your edges look pixelated or jagged, raise Smoothness slightly. If the camera looks soft and your silhouette feels smeared into the background, lower it.

3. Key Color Spill Reduction

Spill is the green light that reflects off the screen onto your skin, hair, and clothes. Spill Reduction shifts those tinted pixels back toward neutral:

• around 50: subtle desaturation of green-tinted skin
• default 100: the standard fix; works for most setups
• above 150: starts pulling all green out of the image — bad if you wear olive, teal, or have green eyes

Spill Reduction is OBS's built-in answer to the green halo. If a halo persists, you can chain a second filter (Color Correction) after Chroma Key with a slight saturation drop in the green channel for the final cleanup. The OBS forums and StreamScheme both recommend this combo for stubborn spill.

4. Brightness, contrast, and gamma

These extra sliders let you correct for the camera and the key surface:

• Brightness: lift the subject if the room is dim
• Contrast: deepen the edges if the keyer leaves them mushy
• Gamma: shift the midtones to balance skin

These are camera-correction tools more than chroma-key tools. Most streamers leave them at zero.

The right way to tune the four sliders

• change one slider at a time, in increments of 25 or so
• watch the live preview, especially around the hair and ears
• stop the moment the screen looks gone — going further only damages the subject

How to add a new background after keying out the green

Once OBS hides the green, the area where it used to be is transparent. Anything underneath the camera in the scene shows through. That is where the new background lives.

1. Add an image, video, or another capture as the backdrop

Three formats work cleanly:

• a static image (PNG, JPG) — small file, no CPU cost
• a looping video (MP4, WebM) — extra polish, small CPU hit
• another scene element (gameplay capture, browser source, screen capture)

To add it:

• click + in the Sources panel (the same scene as the camera)
• pick Image for a still or Media Source for video
• browse to the file, click OK

2. Size it to fill the canvas

After it lands on the canvas:

• drag the corners until it fills the full 1920×1080
• right-click > Transform > Fit to Screen if you want a one-click fix
• check the edges so no black bars or empty corners are visible

3. Source order matters

OBS draws sources from top to bottom in the panel, with the top one painted last (on top of everything else). For chroma key to work, the order must be:

• webcam (with the Chroma Key filter applied) at the top
• background image, video, or capture below it

Flip that order and the background covers your face.

4. If the background covers the camera

• drag the background entry below the webcam in the Sources list
• or right-click the background > Order > Move to Bottom

Layer order is a click, not a setting buried in a menu. The bug usually fixes itself the moment you look at the source list.

5. Picking a background that helps the stream

A backdrop is part of branding, not decoration:

• consistent with the channel's colour palette and logo
• low contrast around the streamer's silhouette so the eye stays on the face
• no flashing animations during dialogue-heavy moments

If you need ideas, an overlay set ties the chroma key, alerts, and frames into one visual system. The [stream overlay guide](/blog/how-to-make-a-stream-overlay) has templates worth borrowing.

How to build a Twitch or Kick scene with chroma key

After the filter runs cleanly, the scene needs the rest of the streaming furniture: gameplay, alerts, chat, frames. The trick is to lay them out so the chroma key sits inside a coherent scene, not floating over a wall of UI.

A working layer order from bottom to top:

• Game capture or display capture as the main backdrop
• Decorative frame or border (PNG with transparency)
• Webcam with Chroma Key on top
• Recent follower / donation alerts (browser source)
• Chat box (browser source) if it's part of the scene

What you can layer in:

• a logo or watermark in a corner
• a chat overlay docked to one side
• alert boxes triggered by Streamlabs, StreamElements, or similar
• a recent-event panel for the latest sub or follower

On Twitch and Kick alike, the rule is restraint. Two or three clean sources read better than seven cluttered ones.

How to layer chroma key over Game Capture

The most common chroma key layout puts the keyed-out streamer directly over the gameplay. The camera has Chroma Key applied, the gameplay sits underneath, and the streamer appears to float inside the game world.

How to wire it up:

• add a Game Capture source (Sources > + > Game Capture)
• set Mode to Capture specific window or Capture any fullscreen application
• leave the Game Capture as the bottom layer of the scene
• place the webcam (with Chroma Key) on top, sized to a corner or full-bleed

If your game capture is misbehaving, the [game capture troubleshooting guide](/blog/how-to-set-up-game-capture-in-obs-studio) covers the fixes that aren't related to the chroma key filter.

Sizing the webcam over gameplay

• small enough to leave the gameplay readable
• large enough to read facial reactions in a small Twitch player
• positioned so it never sits over the minimap, health bar, or chat zone in the game UI

Watch out for game UI overlap:

• the minimap (League of Legends, Valorant, MOBAs)
• the health and ammo HUD (FPS games)
• subtitle and dialogue zones in story games

Even at full-bleed, a chroma-keyed streamer over gameplay only works if the streamer's body doesn't sit in the same place as the player's eye on critical info.

Alternatives: NVIDIA Broadcast and virtual greenscreens

Chroma key isn't the only way to remove a background, and a real green screen isn't the only way to chroma key. Virtual greenscreens have closed the gap a lot in the last two years, and they make sense for streamers who don't have wall space.

1. Static or video backdrop with no keying

If you don't need to remove the camera background, just sit in front of a designed wall:

• an actual decorated room (LED strip, posters, plants)
• a printed backdrop hung behind the desk
• a pre-recorded video loop set up off-camera

No filter, no keying, no slider chase. Acceptable for a lot of channels and easier to maintain.

2. NVIDIA Broadcast (virtual greenscreen)

If you have an RTX GPU, NVIDIA Broadcast offers a Background Removal effect that runs an AI model on the GPU and outputs a virtual webcam with no background:

• no physical green screen needed
• works in any room with adequate lighting
• added as a virtual webcam source in OBS, then placed over your scene

The trade-off: AI segmentation looks softer than a real green screen at fine edges (hair, glasses, microphones), and the GPU cost can compete with your game encoder. On an RTX 4070+, it tends to be invisible. On a 3060, it can shave 1-3 fps off heavy games. For most streamers without studio space, NVIDIA Broadcast still wins; for esports or content where edge detail matters, a real green screen does.

3. AI background features baked into webcams

Some webcams (Logitech Brio, Insta360 Link, Razer Kiyo Pro) ship driver-side background removal. These work like NVIDIA Broadcast but on the camera's own pipeline. Quality varies. Worth testing with your specific model before betting a stream on it.

When chroma key in OBS is still the better call:

• you stream in front of a wall every day and have room for a screen
• you need clean edges around hair or props
• you're on integrated graphics or an older Nvidia card without RTX

OBS chroma key not working: common fixes

Even with a clean setup, edge cases come up. Most chroma key complaints fall into a small number of patterns. Here is the symptom-to-cause map most likely to apply.

Symptoms streamers run into:

• green halo around the head and shoulders
• parts of the face or hair vanish
• the screen is half-removed and half-visible
• the silhouette flickers and shimmers in motion
• the result looks great in still preview but breaks once you move

Where the actual root cause usually lives:

• uneven lighting on the green screen
• low-bitrate or noisy webcam image
• wrong distance — too close to the cloth
• spill bouncing back from the screen onto skin and hair
• the wrong key colour (try blue if you wear green or have warm-toned hair)

OBS only processes whatever pixels the camera sends. If the source image is dim, noisy, or shadowed, the filter has nothing clean to work with.

Concrete fixes in order of impact:

• add a second light to fill the screen evenly before touching any slider
• step back another 30-60 cm from the screen
• drop Similarity by 25-50 instead of raising it
• raise Spill Reduction toward 100 if a green halo still survives
• chain a Color Correction filter after Chroma Key and pull green saturation down 10-15%
• swap shiny or thin clothes for matte, opaque fabric

If chroma key still misbehaves after all of that, the room may simply not have the lighting headroom for a green screen. NVIDIA Broadcast or a designed physical backdrop is often the quieter answer.

Minimum chroma key setup for new streamers

You don't need a film studio to start. The minimum kit looks like this:

• a 1.5×2 m green screen cloth or paper, hung tight on a stand
• any 1080p webcam from the last five years
• two cheap LED panels (one on the screen, one on you), each diffused

That's it. The result with this kit and a clean OBS setup is already 80% of the way to what big streamers ship. The extra 20% comes from added rim lighting and a better camera body, but those are optimisations, not requirements. Spend on lighting before camera. Lighting controls the cleanliness of the key. The body of the camera barely moves the needle once you cross the cheap-webcam threshold.

Pre-stream chroma key checklist

Run this 60 seconds before you go live:

• the camera shows a stable preview, no frame drops
• the chroma key removes the screen evenly, no green band along the floor
• the new background loads, sized correctly, and sits below the camera
• the scene looks clean at 100% canvas zoom, not just at the editing zoom
• CPU and GPU usage in Stats stay under 70% during a quick gameplay test

A 30-second test recording before you hit Start Streaming catches half of the issues most streamers only notice when chat tells them. Done well, OBS chroma key turns a corner of a bedroom into a polished broadcast. Done lazily, it adds noise the audience watches instead of the stream itself. The difference is mostly preparation, then a careful pass through the four sliders — not new gear.

If you are still polishing the rest of your setup, the [OBS webcam guide](/blog/how-to-set-up-webcam-in-obs), the [streaming lighting guide](/blog/how-to-set-up-lighting-for-streaming), and the wider [streaming software guide](/blog/streaming-software-guide) cover the parts of the pipeline that sit upstream from the keyer. Audio echo problems? See the [echo fix walkthrough](/blog/how-to-fix-echo-in-obs-while-streaming).

Chroma key FAQ

What is chroma key in OBS?

Chroma key is a filter inside OBS Studio that removes a single colour from a video source so the area becomes transparent. Most streamers point it at a green or blue physical screen behind them and let OBS replace that area with gameplay, an image, or another scene element.

What is the best green screen colour for streaming?

Bright, evenly lit green is the default because the green channel on most camera sensors carries the cleanest signal. Switch to blue if you wear green often, have green eyes, or shoot props that include green. Both colours work with the same OBS filter; only the Key Color Type changes.

How do I remove the green spill from my hair and skin?

Raise Key Color Spill Reduction toward 100 first. If the halo still shows, chain a Color Correction filter after Chroma Key and drop the Saturation slider 10-15%, or pull green out of the Hue Shift. The deeper fix is physical: more distance from the screen and softer fill on the subject.

Do I need a real green screen for Twitch?

No. NVIDIA Broadcast on RTX hardware, AI background features in modern webcams, and tools like Streamlabs' segmentation can remove the background without one. A real screen still wins on edge quality, especially around hair and props. For most non-esports streamers without studio space, the virtual route is good enough.

Why is my OBS chroma key not working?

The three most common causes: uneven lighting on the screen, the streamer standing too close to the cloth, and Similarity pushed too high so the filter eats subject detail. Fix the lighting first, add 30-60 cm of distance, and drop Similarity by 25 increments until the screen disappears without harming the silhouette.

What's the difference between Chroma Key and Color Key in OBS?

Chroma Key targets a specific dominant colour (green or blue) for keying out a uniform backdrop, with built-in spill reduction. Color Key is a simpler alpha cut against any picked colour and has no spill control. For green-screen work, Chroma Key is the right filter. Color Key is closer to a quick mask for solid-colour graphics.

What Similarity, Smoothness, and Spill Reduction values should I use?

Start with the OBS defaults: Similarity around 480, Smoothness 80, Key Color Spill Reduction 100. Move each slider in steps of 25, watching the hair and ear edges in the preview. The right values are the lowest Similarity that hides the screen and just enough Spill Reduction to clean up the green halo, with everything else left close to default.

Registration