How to Use and Import Custom Luma Wipes in OBS

The Luma Wipe transition in OBS Studio is a powerful tool used to create visually appealing scene transitions based on grayscale images. This article explains the purpose of the Luma Wipe transition, how it utilizes luminance values to reveal scenes, and provides a step-by-step guide on how to import your own custom wipe patterns to personalize your live streams and video recordings.

The Purpose of the Luma Wipe Transition

The primary purpose of the Luma Wipe transition is to create a smooth, stylized gradient fade between two different scenes in OBS Studio. Unlike a simple fade or cut, a Luma Wipe uses a grayscale image (called a transition map) to dictate the order in which pixels transition from the old scene to the new scene.

The transition works based on luminance (brightness) values: * Black areas of the grayscale image transition first. * Gray areas transition next, depending on their darkness level. * White areas of the image transition last.

This allows content creators to achieve highly customized effects—such as linear wipes, radial wipes, clock hands, grids, or organic dissolves—without needing heavy CPU or GPU resources.

How to Import Custom Wipe Patterns into OBS Studio

OBS Studio comes with several built-in Luma Wipe patterns, but you can easily import your own custom grayscale images to create unique transition effects. Custom patterns should ideally be high-contrast, black-and-white (grayscale) PNG or JPEG images that match your canvas resolution (usually 1920x1080).

Follow these steps to import and use a custom Luma Wipe:

Step 1: Prepare Your Custom Grayscale Image

Before opening OBS, ensure you have a grayscale image saved on your computer. The image must contain a gradient of black, gray, and white pixels to tell OBS the exact path and timing of the transition.

Step 2: Add a New Luma Wipe Transition in OBS

  1. Open OBS Studio.
  2. Locate the Scene Transitions dock (usually at the bottom right of the default layout).
  3. Click the drop-down menu that currently shows your active transition (e.g., “Cut” or “Fade”) and select Add: Luma Wipe. If you do not see it in the drop-down, click the Plus (+) icon in the Scene Transitions dock and select Luma Wipe.
  4. Give your new transition a descriptive name (e.g., “Custom Diagonal Wipe”) and click OK.

Step 3: Load Your Custom Pattern

  1. In the Luma Wipe properties window that appears, look for the Image option.
  2. Click the Browse button next to the image dropdown menu.
  3. Navigate to the folder where your custom grayscale image is saved, select it, and click Open.

Step 4: Configure the Transition Settings

You can fine-tune how your custom wipe behaves using the following settings in the properties window: * Luma Threshold: Controls the progress of the transition. * Softness: Adjusts how blurry or sharp the edge of the transition is. A higher softness creates a smoother gradient blend, while a lower softness creates a hard, distinct edge. * Invert: Check this box if you want the transition to occur from white areas to black areas instead of black to white.

Step 5: Save and Test

  1. Click OK to save your transition.
  2. Set your Duration (in milliseconds) in the Scene Transitions dock to control how fast the transition happens (300ms to 1000ms is standard).
  3. Switch between two scenes in your OBS panel to test your custom Luma Wipe in action.