Video Chroma Key

Remove green screen or any colored background from video and replace with another video

Click to upload file or drag and drop file here

Maximum file size: 100MB Supported formats: video/*

Click to upload file or drag and drop file here

Maximum file size: 100MB Supported formats: video/*

Custom color in hex format (e.g., 0x00FF00 for green)

0.01 0.15 1

Color similarity threshold (0.01-1). Lower = more exact color match, Higher = more colors removed

0 0.1 1

Blend factor for edges (0-1). Higher = softer edges, Lower = harder edges

Key Facts

Category
Images, Audio & Video
Input Types
file, select, text, range
Output Type
file
Sample Coverage
4
API Ready
Yes

Overview

The Video Chroma Key tool allows you to seamlessly remove green screens, blue screens, or any custom colored background from a foreground video and replace it with a background video of your choice. By adjusting similarity thresholds and edge blending factors, you can achieve clean, professional-grade compositing directly in your browser and export the final output in formats like MP4, WebM, MKV, AVI, or MOV.

When to Use

  • When you need to replace a green or blue screen background in a video clip with a custom background video.
  • When compositing a presenter or subject filmed against a solid-colored backdrop into a new virtual environment.
  • When fine-tuning edge blending and color similarity to eliminate color spill and harsh borders from keyed footage.

How It Works

  • Upload your foreground video containing the solid-colored background and select your replacement background video.
  • Choose the key color (green, blue, red, white, black, or a custom hex value) that matches the background you want to remove.
  • Adjust the similarity threshold to control color matching sensitivity and the blend factor to soften the keyed edges.
  • Select your preferred output format, such as MP4 or WebM, and process the video to merge the layers.

Use Cases

Creating educational or training videos by placing an instructor filmed on a green screen in front of a presentation video.
Producing gaming content by overlaying a webcam stream with a keyed-out background onto gameplay footage.
Compositing visual effects shots by replacing solid-color backdrops with dynamic motion graphics or scenic background videos.

Examples

1. Creating a Virtual Studio Presentation

Corporate Trainer
Background
A trainer recorded an instructional module in front of a physical green screen but needs to place themselves inside a modern virtual office environment.
Problem
The raw video has a bright green background that needs to be cleanly keyed out and replaced with an office loop video without losing hair detail.
How to Use
Upload the presenter video as the foreground and the office loop as the background. Set the key color to Green, adjust the similarity to 0.18 to capture all green shades, and set the blend to 0.15 for smooth edges.
Example Config
Foreground: presenter.mp4, Background: office_loop.mp4, Key Color: green, Similarity: 0.18, Blend: 0.15, Output Format: mp4
Outcome
A professional MP4 video showing the trainer seamlessly integrated into the virtual office with clean, natural-looking edges.

2. Overlaying a Streamer on Gameplay Footage

Content Creator
Background
A streamer recorded their reaction video against a blue screen backdrop and wants to overlay it onto a high-definition gameplay recording.
Problem
The blue screen needs to be completely removed so only the streamer's silhouette is visible over the gameplay.
How to Use
Upload the reaction video as the foreground and the gameplay video as the background. Select Blue as the key color, set similarity to 0.12, and choose WebM as the output format.
Example Config
Foreground: reaction.mp4, Background: gameplay.mp4, Key Color: blue, Similarity: 0.12, Blend: 0.08, Output Format: webm
Outcome
A WebM video featuring the streamer perfectly overlaid onto the gameplay footage with no blue borders.

Try with Samples

video, file

Related Hubs

FAQ

What video formats are supported for input and output?

You can upload standard video files for both foreground and background, and export the final keyed video as MP4, WebM, MKV, AVI, or MOV.

How do I remove a background color that is not standard green or blue?

Select the 'Custom Color' option and enter the specific hex code of your background color in the custom color field.

What does the Similarity setting do?

Similarity controls the color matching range; lower values match only the exact key color, while higher values remove a broader range of similar shades.

How can I fix jagged or harsh edges around my keyed subject?

Increase the Blend factor to apply edge smoothing, which softens the transition between the foreground subject and the new background.

Is there a file size limit for the uploaded videos?

Yes, the maximum file size limit for both the foreground and background videos is 100 MB.

API Documentation

Request Endpoint

POST /en/api/tools/video-chroma-key

Request Parameters

Parameter Name Type Required Description
foregroundVideo file (Upload required) Yes -
backgroundVideo file (Upload required) Yes -
color select No -
customColor text No Custom color in hex format (e.g., 0x00FF00 for green)
similarity range No Color similarity threshold (0.01-1). Lower = more exact color match, Higher = more colors removed
blend range No Blend factor for edges (0-1). Higher = softer edges, Lower = harder edges
outputFormat select No -

File type parameters need to be uploaded first via POST /upload/video-chroma-key to get filePath, then pass filePath to the corresponding file field.

Response Format

{
  "filePath": "/public/processing/randomid.ext",
  "fileName": "output.ext",
  "contentType": "application/octet-stream",
  "size": 1024,
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}
File: File

AI MCP Documentation

Add this tool to your MCP server configuration:

{
  "mcpServers": {
    "elysiatools-video-chroma-key": {
      "name": "video-chroma-key",
      "description": "Remove green screen or any colored background from video and replace with another video",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=video-chroma-key",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

You can chain multiple tools, e.g.: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, max 20 tools.

Supports URL file links or Base64 encoding for file parameters.

If you encounter any issues, please contact us at [email protected]