Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.comfy.org/llms.txt

Use this file to discover all available pages before exploring further.

The Beeble SwitchX Partner Nodes allow you to transform the environment, lighting, and style of existing images and videos while preserving the original subject. Upload a character or subject image along with a reference environment, and SwitchX composites your subject into the new scene with realistic lighting and shadows. In this guide, we’ll show you how to use the Image Edit and Video Edit workflows.
To use the Partner Nodes, you need to ensure that you are logged in properly and using a permitted network environment. Please refer to the Partner Nodes Overview section of the documentation to understand the specific requirements for using the Partner Nodes.
Make sure your ComfyUI is updated.Workflows in this guide can be found in the Workflow Templates. If you can’t find them in the template, your ComfyUI may be outdated. (Desktop version’s update will delay sometime)If nodes are missing when loading a workflow, possible reasons:
  1. You are not using the latest ComfyUI version (Nightly version)
  2. Some nodes failed to import at startup

​
Beeble SwitchX: Image Edit

Replace the background environment and relight your subject with a reference image. Beeble SwitchX Image Edit Workflow

Run in Comfy Cloud

Open in Comfy Cloud

Download Workflow

Download JSON or search “Beeble SwitchX: Image Edit” in Template Library

​
How It Works

This workflow takes two input images:
  • Subject image — your character or main subject (with background)
  • Reference environment — the new scene, lighting, or style you want to apply
The node generates an output where the subject is naturally composited into the new environment with proper lighting, shadows, and perspective.

​
Steps to Run

  1. Upload subject image — use the first LoadImage node to load your subject image (e.g., a person wearing headphones)
  2. Upload reference image — use the second LoadImage node to load the target environment or style
  3. Enter your prompt — describe the scene in the BeebleSwitchXImageEdit node
  4. Set resolution — choose output resolution
  5. Adjust seed — modify the seed for different results
  6. Click Queue — press Ctrl+Enter to generate
  7. View results — the edited image appears in SaveImage, and a masked cutout is saved separately

​
Node Parameters

ParameterDescription
promptDescription of the scene and environment
resolutionOutput resolution (e.g., 720p)
seedRandom seed for reproducible results

​
Beeble SwitchX: Video Edit

Apply environment relighting to a video while preserving the original motion and unmasked regions. Beeble SwitchX Video Edit Workflow

Run in Comfy Cloud

Open in Comfy Cloud

Download Workflow

Download JSON or search “Beeble SwitchX: Video Edit” in Template Library

​
How It Works

This workflow takes a source video and a reference image, then applies the reference lighting and environment to the masked subject regions in the video. Unmasked areas preserve the original pixels and motion. The workflow also generates an alpha matte for easy compositing.

​
Steps to Run

  1. Upload source video — use the LoadVideo node to load your input video
  2. Upload reference image — use the LoadImage node to load the target environment/style
  3. Set video range — the Video Slice node controls which frames to process (start, end, inclusive)
  4. Enter your prompt — describe the desired environment and lighting in the BeebleSwitchXVideoEdit node
  5. Set resolution — choose output resolution
  6. Adjust seed — modify the seed for different results
  7. Click Queue — press Ctrl+Enter
  8. View results — the edited video is saved, and a separate alpha matte video is generated for compositing

​
Outputs

OutputDescription
Edited video (SaveVideo)The final video with new environment/lighting applied to masked regions
Alpha matte (SaveVideo)A separate alpha video for compositing the edited regions