Skip to main content
Use background removal when a person needs to appear over designed text, graphics, or another scene. HyperFrames runs the included human-segmentation model locally; it does not upload the source or require an API key.
The original presenter frame beside its transparent cutout over a green background

The same real frame before and after the local model. The softer hair and hand edges are the model’s actual limit on this source.

Every frame is real CLI output. The magnified panels sit on the hair edge and on a shoulder a plant used to overlap, because those are where matting usually fails.

​
Create the transparent file

Make sure FFmpeg is installed, then run:
The first run downloads the model. Later runs reuse it. Choose the output by destination:

​
Use the cutout

Import the transparent file into the project and place it above the background, text, or graphic it should cover. Then check the complete clip, especially hair, hands, fast movement, and the first and last frames. If you animate the subject, animate a wrapper around the video. This keeps the transparent media and the composition’s timing behavior together.

​
Compositing patterns and pitfalls

Keep the media element stable and animate a wrapper when the cutout must move, resize, or reveal. This avoids mixing media playback with the transform that controls the composition. When a cutout and its original background must remain frame-aligned, give both media elements the same data-start and playback offset. Hide or reveal them through wrappers instead of mounting one source later. Then scrub the cut point and check the rendered frame, not only normal playback.

​
Put something behind the subject

For text-behind-subject or another three-layer effect, you can create both the foreground cutout and an inverse-alpha background plate in one pass:
The plate keeps the original surroundings and leaves a transparent person-shaped hole. It is not an inpainted empty background. Place an opaque graphic or scene beneath the hole, then place subject.webm above it.

​
Know when it will work well

The included model is designed for people. It works best with a clear human subject, stable framing, and reasonable contrast from the background. Use another segmentation or masking tool when:
  • the subject is a product, animal, or other object;
  • fine hair crosses a busy background;
  • frame-to-frame edge stability must meet high-end VFX standards;
  • you need the original background reconstructed after removing the person.
Background removal is preprocessing. Run it once, keep the transparent result in the project, and reuse it.

​
Balance quality and speed

--device auto chooses the best available local provider. Inspect the detected provider with:
For WebM output, --quality balanced is the default. Use best when the cutout sits directly over its original source and edge color must match; use fast for a smaller file over an unrelated background.

​
Common problems

The CLI reference lists every flag and supported input.

Related topics

CLIMedia and audioWhen to generate artwork