# 3D Relight
Source: https://docs.beeble.ai/beeble-studio/beeble-editor
**3D Relight** is a 3D editor that provides real-time relighting and compositing directly from your VFX passes. Relight scenes with HDRI environments and point lights, adjust materials, and see results instantlyβall powered by a physically-based rendering system that delivers photorealistic results.
## Coming Soon
3D Relight documentation will be available soon.
# Overview
Source: https://docs.beeble.ai/beeble-studio/overview
Beeble Studio is a **desktop app** that runs entirely on your local hardware for speed, privacy, and control.
* **Local AI Model** - Run our most advanced Video-to-PBR model, SwitchLight 3, directly on your desktop. Perfect for professionals who need local workflow.
* **4K Resolution** - Process your footage in Native 4K delivering detail in every frame. Export multi-channel 16-bit EXRs containing all AOV passes in a single file.
* **Unlimited Rendering** - Run without any credit restriction and render sequences up to 1 hour in a single render. Ideal for long-form projects.
**SwitchX** is not available in Beeble Studio. SwitchX is a cloud-exclusive feature available only on [Beeble (Cloud app)](/beeble/overview). [Learn more about SwitchX β](/beeble/switchx)
***
## Key Features
Beeble Studio lets you run core Beeble features, including SwitchLight 3.0, directly on your GPU β unlocking 4K quality, up to 1 hour videos, and unlimited renders.
Generate VFX passes including PBR, alpha, and depth maps from your
footage up to 4K.
Relight scenes with HDRI and point lights using our advanced lighting
system.
Beeble Studio is a desktop app that processes everything on your machine.
Your source files and generated VFX passes is never uploaded to the cloud.
***
## Setup & Requirements
Beeble Studio requires Windows or Rocky Linux machine with NVIDIA RTX 30-series+ GPU (12GB+ VRAM).
Install and activate Beeble Studio Desktop
## Next Steps
Learn about VFX pass generation
Explore real-time relighting and compositing
Install and activate Beeble Studio Desktop
# Setup & Requirements
Source: https://docs.beeble.ai/beeble-studio/setup-requirements
Beeble Studio currently supports **Windows and Rocky Linux only**, and
requires an **NVIDIA GPU**.
## Installation Guide
### 1. Download & Install
Get the installer for Windows or Rocky Linux
### 2. Launch & Sign In
Launch the app and sign in. You'll need an active Beeble Studio plan (7-day free trial available).
### 3. Download Models
Download required engine and model files. You're now ready for local GPU processing! π
***
## Hardware Requirements
| Component | Minimum | Recommended |
| ----------------------- | ------------------------------------------------------------- | ---------------------------------------------------------------------- |
| **OS** | Windows 10/11 ΒΉ Β² Rocky Linux 8 & 9 | Windows 10/11 ΒΉ Rocky Linux 8 & 9 |
| **CPU** | Intel or AMD (AVX support, 2020 or newer) | Intel or AMD (AVX support, 2020 or newer) |
| **NVIDIA GPU** | Ampere architecture or newer (e.g., RTX 30-series, RTX A6000) | Ada Lovelace architecture or newer (e.g., RTX 50-series, RTX 6000 Ada) |
| **GPU Memory (VRAM)** | 12 GB or more Β³ | 24 GB or more |
| **System Memory (RAM)** | 16GB | 32GB |
| **Storage** | 20GB free space | 100GB free space |
| **Internet** | Required for installation, authentication, and updates | Required for installation, authentication, and updates |
**Important Notes:**
ΒΉ Mac is not currently supported.
Β² Windows 10 is supported but may reach end-of-life before 2026 β Windows 11 is recommended.
Β³ GPUs with less than 12 GB VRAM may run but at unusable speeds.
***
### Firewall & Network Configuration
If you're deploying Beeble Studio in a corporate or restricted network environment, ensure the following network requirements are met:
**Protocol & Port:**
* **HTTPS (TCP 443)** β All communication uses secure HTTPS over port 443
**Required Domains:**
| Domain | Purpose |
| --------------------------------- | ---------------------------------------- |
| `app.beeble.ai` | Main application services |
| `platform.modal.beeble.ai` | Authentication and API services |
| `release.beeble.ai` | Software updates and AI model downloads |
| `cdn.beeble.ai` | Public assets and static content |
| `beeble-release.s3.amazonaws.com` | Software release storage |
| `clerk.beeble.ai` | User authentication |
| `accounts.beeble.ai` | User authentication |
| `challenges.cloudflare.com` | Bot protection challenges during sign-in |
For enterprise deployments, add these domains to your firewall allowlist and
ensure in/outbound HTTPS traffic on TCP port 443 is permitted.
***
### Using a Proxy Server
If your organization routes outbound traffic through an HTTP/HTTPS proxy β including TLS-inspecting corporate proxies β Beeble Studio requires the configuration below. Some components do not automatically follow the operating system's proxy settings, so each step is required for full functionality.
Start Beeble Studio with the `--proxy-server` flag pointing at your proxy. This routes the application's traffic and update checks through it.
```bash theme={null}
beeblestudio --proxy-server="http://proxy.example.com:8080"
```
On **Windows**, add the flag to the end of the **Target** field in the Beeble
Studio shortcut's properties. On **Rocky Linux**, launch the app from a
terminal with the flag.
The local engine downloader and processing engine read the following environment variables. Set them in the environment before launching the app:
```bash theme={null}
HTTPS_PROXY="http://proxy.example.com:8080"
HTTP_PROXY="http://proxy.example.com:8080"
REQUESTS_CA_BUNDLE="/path/to/your-proxy-certificate.pem"
```
`REQUESTS_CA_BUNDLE` must point to your proxy's CA certificate. The certificate
must be **PEM-encoded** β a text file that begins with
`-----BEGIN CERTIFICATE-----`. If your certificate is in another format (for
example, binary DER, `.p7b`, or `.pfx`), or you are unsure where to find it,
ask your IT administrator for a PEM-formatted copy.
When you sign in, Beeble Studio opens the login page in your Chrome browser. If your proxy inspects HTTPS traffic, import your proxy's certificate so Chrome trusts it:
**Chrome β Settings β Privacy and security β Security β Manage certificates β
Custom β Installed by you β Trusted Certificates β Import**, then select your
proxy certificate.
Replace `http://proxy.example.com:8080` with your organization's proxy address,
and set `REQUESTS_CA_BUNDLE` to the path of your PEM-encoded proxy certificate.
Your IT or network administrator can provide both.
***
### Performance Benchmarks
Processing time per frame for VFX pass generation (PBR with alpha and depth) varies by GPU and resolution. See the benchmark below for reference.
| GPU Model | 2K | 4K | 4K (4K Max Mode) |
| ----------- | ---- | ---- | ---------------- |
| L40S | 1.9s | 2.9s | 6.6s |
| A6000 | 3.0s | 4.0s | 12.2s |
| RTX 5070 Ti | 2.0s | 3.0s | 8.0s |
| RTX 4090 | 2.7s | 3.7s | 11.6s |
**4K Max Mode** processes high-resolution footage at its native resolution (up
to 4K). \ Requires at least 16 GB of GPU memory.
# VFX Pass Generator
Source: https://docs.beeble.ai/beeble-studio/vfx-pass-generator
**VFX Pass Generator** uses our foundation model, [SwitchLight 3.0](https://beeble.ai/research/switchlight-3-0-is-here), to convert your footage into VFX-ready assets by generating:
* **PBR Maps:** Normal, Base color, Metallic, Roughness, Specular for relighting
* **Alpha:** foreground matte for background replacement
* **Depth Map:** For compositing and 3D integration
Your image or video becomes a **rotoscoped, relightable 2.5D asset**, ready for use in 3D Relight, Blender, Unreal or other 3D tools for further VFX work.
**Beeble Studio (Desktop)** processes your footage locally on your machine, no
upload to the cloud.
***
## Key Features
Powered by **SwitchLight 3.0**. Convert footage into full PBR passes with alpha and depth maps.
Process up to 4K resolution and one-hour videos locally on your GPU.
Upload image sequence for professional workflow. Export VFX passes as image sequence.
Full 16-bit EXR input and output support for professional VFX workflows.
Files never leave your machine. No cloud credits used. Perfect for confidential or proprietary material.
Direct integration plugins for seamless VFX pass import into Nuke, Blender, and Unreal Engine workflows.
***
## Available VFX Passes
| Pass | Description |
| -------------- | --------------------------------------------- |
| **Alpha** | Clean background removal and matte extraction |
| **Depth** | Normalized depth map for compositing |
| **Normal** | Surface normal map for realistic relighting |
| **Base Color** | Diffuse color without lighting information |
| **Roughness** | Surface roughness for material properties |
| **Specular** | Specular highlights and reflections |
| **Metallic** | Metallic surface properties |
***
## Specifications
These specifications are for **Beeble Studio (Desktop)**. For cloud
processing, see [Beeble (Cloud)](/beeble/vfx-pass-generator).
### Import Format
| | Beeble Studio (Desktop app) |
| --------------- | ------------------------------------------------------------------------------------------------------- |
| **File Format** | EXR, PNG, JPG, JPEG |
| **Resolution** | Up to 4K (4096 px) |
| **Max Frames** | Up to 100,000 frames |
| **Color** | sRGB, Linear sRGB, ACEScg (Linear) |
| **Alpha** | If Source Alpha option is enabled , the provided alpha in your frame will be used as the final VFX Pass |
| | Beeble Studio (Desktop app) |
| --------------- | ------------------------------------------------------------------------------------------------------- |
| **File Format** | EXR, PNG, JPG, JPEG |
| **Resolution** | Up to 4K (4096 px) |
| **Color** | sRGB for best quality *- Other color spaces, such as Log, may degrade quality* |
| **Alpha** | If Source Alpha option is enabled , the provided alpha in your frame will be used as the final VFX Pass |
| | Beeble Studio (Desktop app) |
| --------------- | ------------------------------------------------------------------------------------------------------- |
| **File Format** | MP4 (H.264), MOV (ProRes 422, 4444, H.265) |
| **Resolution** | Up to 4K (4096 px) |
| **Duration** | Up to 1 hour |
| **FPS** | Any FPS supported |
| **Color** | Rec. 709 for best quality *- Other color spaces, such as Log, may degrade quality* |
| **Alpha** | If Source Alpha option is enabled , the provided alpha in your frame will be used as the final VFX Pass |
### Output Format
Beeble Studio provides three output formats:
* **EXR**: 16-bit multi-layer EXR files, with each frame containing all passes.
* **PNG**: 8-bit PNG sequences for each VFX pass.
* **MP4**: 8-bit MP4 files for each VFX pass.
| Map | Color Channels (Layer.Channel) | Bit Depth | Color Space | Note |
| ------------- | ---------------------------------------------- | ------------ | ----------- | ------------------------------------------------------ |
| **Source** | Source.red, Source.green, Source.blue | 16-bit float | Linear | |
| **Alpha** | Alpha.red | 16-bit float | Linear | 0.0β1.0 matte |
| **Normal** | Normal.red, Normal.green, Normal.blue | 16-bit float | Linear | Object space / OpenGL normal map |
| **BaseColor** | Basecolor.red, Basecolor.green, Basecolor.blue | 16-bit float | Linear | Note: 'Basecolor' uses lowercase 'c' |
| **Roughness** | Roughness.red | 16-bit float | Linear | White = Rough surface |
| **Specular** | Specular.red | 16-bit float | Linear | |
| **Metallic** | Metallic.red | 16-bit float | Linear | White = Metallic surface |
| **Depth** | Depth.red | 16-bit float | Linear | Normalize depth to \[0, 1] within the foreground range |
***
## Good vs. Bad Footage
Even though our AI models generate VFX passes from your footageβlike depth, normals, or lighting layersβwe don't "invent" details. The **quality of the output depends entirely on the input**. Make sure your footage contains enough visual detail by following these examples.
### β Good Footage
**Footage should be ready for compositing** with:
* **Includes clear subjects** β such as people or objects
* **Strong separation** between subject and background
* **High-quality** β sharp focus, high bitrate, and detailed visuals
* **Soft, even lighting** β avoid harsh shadows or blown highlights
* **Correct white balance and proper exposure**
### β Bad Footage
**Avoid footage** with these problems:
* **No visible subject**, or subject is too small in frame
* **Grayscale footage** β color is required
* **Poor quality** β low bitrate, blurry, noisy, or out of focus
* **Improper exposure** β overexposed, underexposed, or extreme contrast
* **Too much camera movement** β shaky or unstable footage is hard to work with
# Background Remover
Source: https://docs.beeble.ai/beeble/background-remover
AI-powered alpha extraction for clean background-free footage
Background Remover is available exclusively on **Beeble (Cloud app)**. It is not
available in Beeble Studio.
**Background Remover** extracts clean alpha mattes from your footage using AI, producing background-free results ready for compositing and VFX work. Upload a video, image sequence, or image, and the AI generates a precise foreground mask automatically.
Background Remover is a standalone alpha extraction tool. For generating a full set of
VFX passes (alpha, depth, normal, PBR maps), see [VFX Pass
Generator](/beeble/vfx-pass-generator).
***
## How It Works
### Step 1: Choose Alpha Model
Select the AI model best suited for your footage:
| | **MatAnyone** (default) | **CorridorKey** |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Purpose** | Good for general background removal | Perfect green screen keys |
| **Learn More** | | |
| **How it works** | **Stage 1**: Pick a keyframe and provide an alpha mask with our interactive masking tool.
**Stage 2**: Propagate the alpha mask across all frames. | **Stage 1**: **MatAnyone** generates an alpha hint for every frame.
**Stage 2**: **CorridorKey** removes the green spill and refines the matte. |
CorridorKey is designed specifically for green screen footage. Using it on footage without a green screen may produce unexpected or degraded results.
### Step 2: Upload Your Footage
Upload your footage to begin. Background Remover supports three source types:
* **Video** β MP4, MOV
* **Image Sequence** β Sequence of image frames
* **Single Image** β PNG, JPG
### Step 3: Preview Frame (Optional)
A preview frame is extracted from your video with a **rough alpha estimation** generated on it, so you can review the overall quality before committing to full extraction.
### Step 4: Refinement (Optional)
If the preview alpha needs adjustment, you can refine it interactively by clicking the **Edit Alpha** button in the Preview Dialog.
Preview in this refinement section shows a rough estimation β it is not intended to be
pixel-perfect. Fine details like hair edges and semi-transparent areas will be
refined during the full extraction in the next step.
**Skip Review mode** β You can choose to **Skip Review** during upload, which bypasses the preview step (Steps 3β4) and runs full extraction immediately.
* The AI automatically uses the **first frame** as the reference and runs the entire pipeline without manual review.
* This mode works best for **simple shots** with clear subjects and consistent backgrounds, where manual refinement is unlikely to be needed.
### Step 5: Full Extraction
Once you approve the preview frame (or skip it), full extraction runs across all frames.
### Step 6: Download Results
When extraction completes, download your results. You can also **bulk download** multiple completed results at once.
***
## Specifications
These specifications are for **Beeble (Cloud)**. Specifications may be updated
as the platform evolves.
### Upload Format
| | Beeble (Cloud app) |
| --------------- | -------------------------------------------------------------------------------------------- |
| **File Format** | MP4 (H.264), MOV (ProRes 422, 4444, H.265) |
| **Max Size** | 2 GB |
| **Resolution** | Up to 2K (2048 px) *- Downscaled if larger* |
| **Frame Count** | Up to 3600 frames *- e.g. 60s @ 60fps or 120s @ 30fps (Professional plan)* |
| **FPS** | Up to 60 FPS *- Reduced if higher* |
| **Color** | Rec. 709 for best quality *- Other color spaces, such as Log, may degrade quality* |
| | Beeble (Cloud app) |
| --------------- | ----------------------------------------------------------------------------------- |
| **File Format** | PNG, JPG, JPEG |
| **Max Size** | 100 MB per file |
| **Resolution** | Up to 2K (2048 px) *- Rejected if larger* |
| **Max Frames** | Up to 2000 frames |
| **Color** | sRGB for best quality *- Other color spaces, such as Log, may degrade quality* |
| | Beeble (Cloud app) |
| --------------- | ----------------------------------------------------------------------------------- |
| **File Format** | PNG, JPG, JPEG |
| **Max Size** | 100 MB |
| **Resolution** | Up to 2K (2048 px) *- Rejected if larger* |
| **Color** | sRGB for best quality *- Other color spaces, such as Log, may degrade quality* |
**Best Quality Settings** - Use Rec. 709 / sRGB color space. Beeble (Cloud
app) supports up to 2K and 3600 frames per video (60s @ 60fps).
### Output Format
Background Remover produces two output types:
* **RGBA** β Background removed result with transparency applied.
* **Alpha** β Grayscale alpha matte (foreground mask).
| Format | Color Channels | Bit Depth | Color Space | Note |
| ---------------- | -------------- | --------- | ----------- | ------------------------------------ |
| **MOV** | RGBA (4-ch) | 10-bit | sRGB | Alpha-embedded video for compositing |
| **PNG Sequence** | RGBA (4-ch) | 8-bit | sRGB | Frame-by-frame PNG with transparency |
| **PNG** | RGBA (4-ch) | 8-bit | sRGB | Single image with transparency |
The MOV output contains an embedded alpha channel, so you can drop it directly
into After Effects, DaVinci Resolve, Final Cut Pro, or any editor that supports
alpha video. No separate alpha matte needed.
***
## Tips for Best Results
For the best alpha extraction results:
* Use footage with **clear contrast** between subject and background
* Ensure the subject is **well-lit** and in sharp focus
* Avoid footage with **excessive motion blur**
* Use **high-resolution** source material when possible
* For videos, review and refine the preview frame before running full extraction
# 3D Relight
Source: https://docs.beeble.ai/beeble/beeble-editor
**3D Relight** is a 3D editor that provides real-time relighting and compositing directly from your VFX passes. Relight scenes with HDRI environments and point lights, adjust materials, and see results instantlyβall powered by a physically-based rendering system that delivers photorealistic results.
## Device Settings
Beeble works only on the **Chrome** or **Edge** browser.
### Enable Graphics Acceleration
If graphics acceleration is disabled, enable it:
1. **Chrome:** *Settings β System*
**Edge:** *Settings β System and performance β System*
2. Enable **Use graphics acceleration when available**.
3. Click **Relaunch** to restart your browser.
### Use Dedicated GPU (Windows Only)
If you see **Graphics: CPU** on the toolbar, your browser is likely using the integrated GPU. Switch to your dedicated GPU:
1. Go to **Windows Settings** β **System** β **Display** β **Graphics**.
2. Under **Custom options for apps**, find your browser (or click **Browse** to add it):
* Chrome: `C:\Program Files\Google\Chrome\Application\chrome.exe`
* Edge: `C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe`
3. Select the browser β **Options** β **High performance** (e.g., GPU: NVIDIA GeForce RTX 4090) β **Save**.
4. **Relaunch** your browser.
5. Open **Task Manager** β **Performance tab** to check if the dedicated GPU is being used.
# Canvas
Source: https://docs.beeble.ai/beeble/canvas
Node-graph workflow editor for final render
**Canvas** is a powerful node-graph editor that brings every Beeble AI model into a single, unified workspace. Build custom processing pipelines by wiring together tools like SwitchX, Image Generator, and Video Matte. Simply import your raw footage, map out your node network, and generate production-ready results. With the flexibility to branch off creative variations at any step, Canvas gives you complete control from raw input to final render.
***
## Node Catalog
Canvas ships with four node groups.
### Input
| Node | Output | Notes |
| ------------------ | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------- |
| **Text** | text | Plain text prompt. |
| **Image** | image | PNG, JPEG, or WebP. |
| **Video** | video | MP4 or MOV. |
| **Text Iterator** | text | Split text into multiple items by delimiter β type the text on the node or connect an upstream text node. Drives multi-prompt batches. |
| **Image Iterator** | image | Upload multiple images at once and batch-process the full set through connected nodes β no need to upload one-by-one. |
| **Video Iterator** | video | Upload multiple videos at once and batch-process the full set through connected nodes β no need to upload one-by-one. |
### AI Tools
| Node | Inputs | Output | Notes |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **SwitchX** | source video reference image alpha video prompt | video | Same model as the standalone [SwitchX](/beeble/switchx) product. Source and alpha handles are video-only. If you need Fill Mode, leave the alpha input disconnected. Set a random seed for reproducibility. |
| **LLM** | prompt media | text | Generate text from a prompt using an LLM. Supports up to 4 media inputs (image or video). Use `@` to reference connected media in your prompt. |
| **Image Generator** | prompt images | image | Supports 1 to 4 reference images. |
| **Video Generator** | prompt start / end frame reference media | video | Generate a short clip via external models (e.g., Seedance 2.5). Pick a model in the footer:
**Text-to-Video** β prompt only
**Image-to-Video** β needs a Start Frame (End Frame optional)
**Reference-to-Video** β repeatable reference slots; the per-model cap follows the selected model (e.g. Seedance 2.5 accepts up to 30 images / 10 videos, Seedance 2.0 up to 9 images / 3 videos)
|
| **Video Matte** | video | alpha RGBA | Two outputs: **Alpha** (grayscale matte) and **RGBA** (source merged with alpha). Two modes: **Auto** (one-click) or **Select** (interactive SAM editor). Choose between **MatAnyone** (general footage) and **CorridorKey** (green-screen keys). Export the RGBA composite as MOV or a PNG sequence, and the alpha as a PNG sequence. |
| **VFX Pass Generator** | image / video | image / video Γ 6 | Extracts PBR material maps (BaseColor, Normal, Depth, Roughness, Specular, Metallic) from an image or video using SwitchLight 3.0. Export passes individually or all at once with **Export All**, including PNG sequences. |
| **Depth Generator** | image / video | image / video | Extracts a depth map from an image or video using Video Depth Anything. Export as a 16-bit EXR for higher-fidelity depth workflows. |
| **Video Upscaler** | video | video | Upscale a video 1Γβ4Γ (up to 4K) with Topaz Video AI. Pick a Mode in the footer (Proteus, Artemis MQ, Nyx, Gaia HQ, Starlight HQ); codec and frame interpolation live under Advanced. |
| **Image Upscaler** | image | image | Upscale an image 1Γβ4Γ (up to 8K) with Topaz Gigapixel AI. Pick a Mode in the footer (Standard V2, Low Resolution V2, CGI, High Fidelity V2, Text Refine, generative Recovery / Redefine / Wonder, and more). |
| **Image Describer** | prompt images | text | Generate a detailed text description of connected image(s) using an LLM. Connect up to 4 images. Comes with a built-in, editable prompt β hit **Reset** to restore the default. |
| **Video Describer** | prompt videos | text | Generate a detailed text description of connected video(s) using an LLM. Connect up to 4 videos, each up to 5 minutes. Comes with a built-in, editable prompt β hit **Reset** to restore the default. |
| **Camera Angle (Qwen)** | image | image | Re-render a still from a different camera angle. |
### Edit
| Node | Inputs | Output | Notes |
| --------------------- | --------------------------------------------------------------------------- | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Extract Frame** | video | image | Extract a single frame from a video |
| **Trim** | video | video | Trim a video to a specific frame range |
| **Crop** | image / video | image / video | Crop an image or video. Interactive overlay or numeric inputs. |
| **Resize** | image / video | image / video | Resize an image or video to target dimensions |
| **Curves** | image / video | image / video | Adjust the tonal range with interactive RGB and per-channel (R/G/B) curves. Drag points to shape the curve; click empty space to add a point; double-click or drag a point off the graph to remove it. |
| **Invert** | image / video | image / video | Invert RGB colors of an image or video. |
| **Rotate / Flip** | image / video | image / video | Rotate an image or video in 90Β° increments, or flip it horizontally or vertically. |
| **Erode / Dilate** | image / video mask | image / video | Dilate (grow) or erode (shrink) bright regions. Typically chained after Video Matte for matte cleanup. Strength ranges from β200 to +200. Optional mask input. |
| **Channels** | image / video | image / video | Isolate a single RGBA channel (R, G, B, or Alpha) and view it as grayscale. |
| **Blur** | image / video mask | image / video | Apply a Box or Gaussian blur (Size 1β100). Optional mask input to confine the blur to specific regions. |
| **Merge** | background foreground mask | image / video | Composite foreground over background with 16 blend modes (Normal, Multiply, Screen, etc.). Inputs accept image or video independently. Optional grayscale mask. |
| **Merge Alpha** | RGB alpha matte | image / video | Combine an RGB source and a grayscale alpha matte into a single RGBA stream. Both inputs accept image or video. |
| **Compositor** | layers | video | Composite multiple layers into a single video with per-layer blend modes, opacity, and timing. |
| **Paint** | image | result mask | Freehand drawing with pen and eraser. Connect an image to paint over it, or set dimensions for a blank canvas. Outputs the painted result (RGBA) and a grayscale mask. |
| **Text Concatenator** | text Γ 2 | text | Concatenate two prompts β use one as a system prompt and the other as a user prompt. |
### Utility
| Node | Inputs | Output | Notes |
| --------------- | --------------------------------------- | ------ | ------------------------------------------------------------------------------------------ |
| **Sticky Note** | β | β | Sticky note for annotations |
| **Router** | any | any | Reroute connections for cleaner graphs (`.` shortcut) |
| **Viewer** | image / video | β | Display connected media at larger size with playback controls |
| **Compare** | image / video | β | Side-by-side A/B comparison |
| **Export** | image / video | β | Download connected media directly. Use the Save As dialog to choose where files are saved. |
***
## Handles & Data Types
Each node's handle color represents its data type. Required inputs are marked with an asterisk on the label (e.g., `Source *`).
### Type colors
| Type | Color | Examples |
| --------- | --------------------- | --------------------------------------------------- |
| **Image** | β Green | SwitchX reference, Extract Frame output |
| **Video** | β Orange | SwitchX source / alpha / output, Video Matte output |
| **Text** | β Blue | LLM output, prompt inputs |
***
## Keyboard Shortcuts
### Canvas
| Shortcut | Action |
| ------------ | ----------------------------------------------------------------------------------- |
| `V` | Switch to Pointer tool |
| `H` | Switch to Hand (pan) tool |
| `/` or `Tab` | Open the Add Node menu at the cursor |
| `.` | Add a Router node at the cursor |
| `T` | Add a Sticky Note at the cursor |
| `Q` | Toggle the Job Queue panel |
| `\` | Toggle the Viewport panel |
| `1` | Connect selected node to Viewer and open Viewport |
| `Space` | Hold to pan; on selected video nodes, toggles playback (multi-select plays in sync) |
### View
| Shortcut | Action |
| ------------------------------- | --------------------- |
| `F` | Fit view to all nodes |
| `Cmd/Ctrl + 0` | Zoom to 100% |
| `Cmd/Ctrl + 1` | Fit all nodes |
| `Cmd/Ctrl + 2` | Fit selected nodes |
| `Cmd/Ctrl + =` / `Cmd/Ctrl + -` | Zoom in / out |
### Selection
| Shortcut | Action |
| ------------------------------- | -------------------------------------------------- |
| `Esc` | Deselect all nodes and edges |
| `Cmd/Ctrl + A` | Select all nodes |
| `Cmd/Ctrl + C` / `Cmd/Ctrl + V` | Copy / Paste (preserves output history) |
| `Cmd/Ctrl + Shift + V` | Paste without output history |
| `Cmd/Ctrl + D` | Duplicate selected nodes with their output content |
| `Cmd/Ctrl + G` | Group / Ungroup selected nodes |
| `Delete` / `Backspace` | Delete selected nodes and edges |
### Alignment
| Shortcut | Action |
| ------------------------ | ------------------------------------------------------- |
| `Alt/Opt + A` | Align selected nodes to the left |
| `Alt/Opt + D` | Align selected nodes to the right |
| `Alt/Opt + W` | Align selected nodes to the top |
| `Alt/Opt + S` | Align selected nodes to the bottom |
| `Alt/Opt + H` | Align selected nodes to horizontal center |
| `Alt/Opt + V` | Align selected nodes to vertical center |
| `Cmd/Ctrl + Alt/Opt + H` | Distribute selected nodes with equal horizontal spacing |
| `Cmd/Ctrl + Alt/Opt + V` | Distribute selected nodes with equal vertical spacing |
### General
| Shortcut | Action |
| --------------------------------------- | ---------------------------------- |
| `Cmd/Ctrl + S` | Save |
| `Cmd/Ctrl + Z` / `Cmd/Ctrl + Shift + Z` | Undo / Redo |
| `Cmd/Ctrl + ,` | Open Settings dialog |
| `Shift + ?` | Open the Keyboard Shortcuts dialog |
# Overview
Source: https://docs.beeble.ai/beeble/overview
Beeble is a **cloud app** that lets you create instantly in your browser. Everything runs on our secure cloud, ready wherever you are. Beeble is available through [app.beeble.ai](https://app.beeble.ai)
## Key Features
Professional video-to-video AI generation. Switch anything, keep what
matters.
Node-graph editor for composing AI VFX pipelines across Beeble's models.
Generate PBR maps, alpha, and depth channels from your footage with AI.
Extract clean alpha mattes from your footage with AI-powered background
removal.
Relight scenes with HDRI and point lights using our advanced lighting
system.
## Next Steps
Learn about video-to-video AI generation
Compose AI pipelines with a node graph
Learn about VFX pass generation
Learn about AI-powered alpha extraction
Explore real-time relighting and compositing
# SDR to HDR
Source: https://docs.beeble.ai/beeble/sdr-to-hdr
Reconstruct 8-bit SDR footage into 16-bit HDR EXRs with SwitchHDR
SDR to HDR is available exclusively on **Beeble (Cloud app)**. It is not
available in Beeble Studio.
**SDR to HDR** is a professional reconstruction tool for filmmakers, colorists, and VFX artists, powered by our [**SwitchHDR**](https://beeble.ai/research/switchhdr) model. It turns standard 8-bit SDR footage into true 16-bit HDR masters built for production pipelines.
Unlike tone mapping, SwitchHDR rebuilds the detail SDR threw away. It recovers information behind blown windows and crushed blacks, while keeping well-exposed areas faithful to the source.
**Key features:**
* **True 16-bit EXR output** with a full ACES workflow (ACES2065-1, **AP0**)
* **Expanded depth and range** for smoother grading with less banding
* **Precise control** via highlight and shadow masks, with optional text prompts
* **Powered by SwitchHDR**, our foundational model trained specifically for accurate SDR-to-HDR reconstruction
***
## Quick start
Upload an image or a video (**1-240 frames**). For longer clips, trim before uploading.
Use **Highlight** and **Shadow** thresholds to define which regions the model reconstructs. The overlay and histogram show exactly which pixels are affected.
**Video:** Use **Change Frame** to verify the mask on a different frame.
Optionally describe the recovered highlights and shadows (or click
**Suggest**), pick **1080p** or **720p**, and generate. Set a fixed **Seed**
under **Advanced** for reproducible results.
Check the result with the **EV slider**, then download the outputs: the **EXR** sequence and the **HLG** `.mov`.
***
## Specs
| Item | Details |
| ---------------- | --------------------------------------------------------------- |
| **Resolution** | 1080p or 720p (short edge is scaled to the selected resolution) |
| **Aspect Ratio** | Always preserved |
| **Frame Rate** | Always preserved |
***
## Export
| File | What it is |
| ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| `{name}_ACES2065-1.exr` / `.zip` | Finishing master EXR in **ACES2065-1 (AP0)**, **16-bit half-float**. Video jobs download as a numbered EXR sequence in a ZIP. |
| `{name}_HLG.mov` | For video jobs, a Rec.2020 / **HLG** QuickTime for playback and review. |
| `{name}_mask_highlight` / `_mask_shadow` | Reconstruction mattes (PNG for images, MP4 for video) for comp and selective grading. |
***
## Load in DaVinci Resolve & Nuke
Unzip `{name}_ACES2065-1.zip` and import the EXRs, then follow the setup below so they are read as ACES, not as Rec.709 / sRGB.
### 1. Frame rate (video jobs)
* Before importing, set **Project Settings β Master Settings β Timeline frame rate** to your source clip's rate.
* Already imported? Right-click the sequence β **Clip Attributes β Video Frame rate**.
### 2. Color space
Pick **one**. Combining both can cause a double transform.
**Option A: Project-wide ACES**
1. **Project Settings β Color Management**: Color science **ACEScct**, ACES version **1.3**
2. Set the **Output / Display Transform** for your monitor (e.g. Rec.709)
**Option B: Per-shot Color Space Transform node**
We recommend using the **default project setting** (DaVinci YRGB, Rec.709 Gamma 2.4).
1. **Color page β add a node β Effects β Color Space Transform**
2. Input: **ACES (AP0)** / **Linear** β Output: your timeline space (e.g. **Rec.709 / Gamma 2.4**)
### 1. Enable ACES OCIO
Set your Nuke OCIO config to ACES (commonly `aces_1.2` or `aces_1.3` depending on your pipeline).
### 2. Read node
For `{name}_ACES2065-1.exr`, set **colorspace** to **ACES - ACES2065-1** (or the equivalent label in your config).
### 3. Viewer
Set the viewer / monitor transform to your target display (e.g. **Rec.709**).
# SwitchX
Source: https://docs.beeble.ai/beeble/switchx
Professional video-to-video AI generation tool for filmmakers and VFX artists
SwitchX is available exclusively on **Beeble (Cloud app)**. It is not
available in Beeble Studio.
**SwitchX** is a professional video-to-video AI generation tool designed for filmmakers, VFX artists, and creators. Unlike standard video-to-video models that hallucinate or alter the entire frame, SwitchX uses your original footage's pixels as direct control signals.
The core principle of SwitchX is simple: **Switch anything, keep what matters.**
* **Masked Areas:** Completely generated based on your prompts and reference images.
* **Unmasked Areas:** Retained from the original footage, but intelligently relit and restyled to blend seamlessly into the newly generated environment.
To get the best results from SwitchX, master two concepts: the **Alpha Mask** controls *what* gets changed, and the **Reference Image** controls *how* it looks.
***
## Alpha Masks
The alpha mask tells SwitchX exactly what to generate and what to preserve. SwitchX offers four masking modes:
| Mode | Description | Best For |
| ---------- | ------------------------------------------------------------------- | ------------------------------------------------------ |
| **Auto** | Auto-detects and isolates the main subject. No manual input needed. | Background replacement, relighting, virtual production |
| **Select** | Manually select specific elements to keep or generate. | Targeted changes (e.g., new outfit, inpainting) |
| **Fill** | Selects the entire frame. Keeps geometry, alters aesthetics. | Full-frame relighting or restyling |
| **Upload** | Upload a custom alpha matte from external software. | Pixel-perfect control from Nuke, After Effects, etc. |
### Auto Mode
**Best for:** Standard background replacements, relighting a subject, and
virtual production.
The engine automatically detects and isolates the main subject in your first frame, then propagates and tracks that mask throughout the rest of the video. No manual selection is required.
### Select Mode
**Best for:** Precision control, changing specific elements (e.g., changing
clothes while keeping the face and hands intact), and advanced inpainting.
You manually choose exactly which parts of the frame to mask. Only the selected areas will be generated β everything else stays untouched from your original footage.
Powered by an interactive AI masking tool (SAM3), click to select specific objects on the first frame. The Alpha Editor lets you fine-tune your selections:
* **Multiple Selections:** Select multiple objects. For the cleanest results,
add distinct parts (like a face and a hand) as separate objects rather than
grouping them. - **Deselect:** Right-click to remove an unintended selection.
* **Invert:** Invert the mask of a specific object. For example, to turn a
hand into a robot arm, select the hand, click **Invert**, and the engine will
only generate within that area.
### Fill Mode
**Best for:** Complete scene relighting and restyling.
This mode selects the entire frame. Use Fill when you want to keep the original scene's geometry and composition intact but alter the overall lighting, mood, or artistic style.
### Upload Mode
**Best for:** VFX professionals using external compositing software.
Upload a precise alpha matte created in software like Nuke or After Effects. SwitchX reads the black-and-white alpha video pixel-by-pixel for absolute precision.
***
## Camera Tracking
SwitchX only sees the **unmasked** (foreground) region of your video. The masked area is completely hidden from the model, meaning SwitchX must infer all camera movement solely from the visible foreground pixels.
This has a direct impact on camera tracking quality:
* **Where it excels:** Shots where the foreground contains rich visual data to infer motion β such as a subject with complex movement, organic camera shake, or visible depth changes.
* **Where it struggles:** Simple, linear camera movements (like lateral trucking/panning shots) where the isolated foreground lacks sufficient parallax cues to estimate motion accurately.
Even if your original footage contains tracking markers in the background (e.g., on a green screen), SwitchX **cannot use them** if those markers fall within the masked region. Once an area is masked, it becomes 100% invisible to the AI model β regardless of the tracking data present in your source footage.
***
## Reference Images
The reference image is your visual blueprint. It should contain all the details you want in your final video β background, lighting, mood, and costumes. SwitchX reads this image and uses it as a guide:
* **Masked areas:** SwitchX generates the background and content from the reference image into the masked region.
* **Unmasked areas:** SwitchX extracts the style and lighting from the reference image and applies it to your original footage, preserving the original pixels.
**Source**
**Reference Image**
**SwitchX Result**
### Imperfect References Are Fine
Your reference image doesn't need to perfectly match your source footage. For example, if you generate a reference with Nano Banana and the face changes β that's fine. SwitchX understands what your original pixels are and will only bring the lighting and style from the reference, applying it on top of your actual footage.
### Creating a Reference Image
You can upload any image, or use the built-in **Create with AI** tool. This sends your video's first frame to our Nano Banana or Flux models to generate a matching reference.
### Prompting Guidelines
**Avoid vague prompts.** Prompts like "Take me to heaven" will yield poor
results. AI requires precise art direction.
**Be highly specific.** Specify the environment, lighting, and mood β for
example: *"A dramatic cliff in Ireland, soft overcast lighting, highly
detailed props."*
If you are struggling with art direction, use a text AI like ChatGPT to generate five detailed prompt variations based on your core concept.
### The Professional Workflow (Iteration)
For pixel-perfect results, do not rely solely on the initial AI-generated image:
1. **Generate** a reference image using the **Create with AI** tool.
2. **Download** the generated image to your local machine.
3. **Refine** in Photoshop or similar β adjust color grading, add props, fix details.
4. **Re-upload** the edited image into SwitchX. The final video will strictly follow this tailored reference.
***
## Settings & Export
### Video Prompt
**Autopilot recommended.** Leave the Video Prompt setting on Autopilot β the
engine handles prompt engineering behind the scenes. Turn this off only if you
need to manually override an unexpected result.
### Resolution and Project Specs
| Setting | Details |
| ---------------- | ---------------- |
| **Resolution** | 720p or 1080p |
| **Aspect Ratio** | Always preserved |
| **Frame Rate** | Always preserved |
SwitchX will never distort your original aspect ratio or frame rate. The engine only resizes the shortest side of your video to match the chosen resolution, so you can iterate quickly without breaking your project specifications.
# VFX Pass Generator
Source: https://docs.beeble.ai/beeble/vfx-pass-generator
**VFX Pass Generator** uses our foundation model, [SwitchLight 3.0](https://beeble.ai/research/switchlight-3-0-is-here), to convert your footage into VFX-ready assets by generating:
* **PBR Maps:** Normal, Base color, Metallic, Roughness, Specular for relighting
* **Alpha:** foreground matte for background replacement
* **Depth Map:** For compositing and 3D integration
Your image or video becomes a **rotoscoped, relightable 2.5D asset**, ready for use in 3D Relight, Blender, Unreal or other 3D tools for further VFX work.
***
## Key Features
Powered by **SwitchLight 3.0**. Convert footage into full PBR passes with alpha and depth maps.
Process up to 2K resolution and one-minute videos or 2,000-frame sequences on cloud.
Upload image sequence for professional workflow. Export VFX passes as image sequence.
Direct integration plugins for seamless VFX pass import into Nuke, Blender, and Unreal Engine workflows.
***
## Available VFX Passes
| Pass | Description |
| -------------- | --------------------------------------------- |
| **Alpha** | Clean background removal and matte extraction |
| **Depth** | Normalized depth map for compositing |
| **Normal** | Surface normal map for realistic relighting |
| **Base Color** | Diffuse color without lighting information |
| **Roughness** | Surface roughness for material properties |
| **Specular** | Specular highlights and reflections |
| **Metallic** | Metallic surface properties |
***
## Specifications
These specifications are for **Beeble (Cloud)**. For higher resolution and
longer duration, see [Beeble Studio (Desktop)](/beeble-studio/vfx-pass-generator).
### Upload Format
| | Beeble (Cloud app) |
| --------------- | ------------------------------------------------------------------------------------------- |
| **File Format** | PNG, JPG, JPEG |
| **Max Size** | 100 MB per file |
| **Resolution** | Up to 2K (2048 px) *- Rejected if larger* |
| **Max Frames** | Up to 2000 frames |
| **Color** | sRGB for best quality *- Other color spaces, such as Log, may degrade quality* |
| **Alpha** | If alpha is provided (e.g. RGBA PNG), the uploaded alpha will be used as the final VFX Pass |
| | Beeble (Cloud app) |
| --------------- | ------------------------------------------------------------------------------------------- |
| **File Format** | PNG, JPG, JPEG |
| **Max Size** | 100 MB |
| **Resolution** | Up to 2K (2048 px) *- Downscaled if larger* |
| **Color** | sRGB for best quality *- Other color spaces, such as Log, may degrade quality* |
| **Alpha** | If alpha is provided (e.g. RGBA PNG), the uploaded alpha will be used as the final VFX Pass |
| | Beeble (Cloud app) |
| --------------- | ---------------------------------------------------------------------------------------------- |
| **File Format** | MP4 (H.264), MOV (ProRes 422, 4444, H.265) |
| **Max Size** | 2 GB |
| **Resolution** | Up to 2K (2048 px) *- Downscaled if larger* |
| **Duration** | Up to 60 seconds |
| **FPS** | Up to 30 FPS *- Reduced if higher* |
| **Color** | Rec. 709 for best quality *- Other color spaces, such as Log, may degrade quality* |
| **Alpha** | If alpha is provided (e.g. ProRes 4444), the uploaded alpha will be used as the final VFX Pass |
**Best Quality Settings** - Use Rec. 709 / sRGB color space. Beeble (Cloud
app) supports up to 2K and 60 seconds.
### Output Format
Beeble Cloud provides two output formats:
* **PNG**: 8-bit PNG sequences for each VFX pass.
* **MP4**: 8-bit MP4 files for each VFX pass.
**EXR export** is only available in [Beeble Studio
(Desktop)](/beeble-studio/vfx-pass-generator).
***
## Good vs. Bad Footage
Even though our AI models generate VFX passes from your footageβlike depth, normals, or lighting layersβwe don't "invent" details. The **quality of the output depends entirely on the input**. Make sure your footage contains enough visual detail by following these examples.
### β Good Footage
**Footage should be ready for compositing** with:
* **Includes clear subjects** β such as people or objects
* **Strong separation** between subject and background
* **High-quality** β sharp focus, high bitrate, and detailed visuals
* **Soft, even lighting** β avoid harsh shadows or blown highlights
* **Correct white balance and proper exposure**
### β Bad Footage
**Avoid footage** with these problems:
* **No visible subject**, or subject is too small in frame
* **Grayscale footage** β color is required
* **Non-sRGB/Rec.709 color space** β make sure your footage uses standard sRGB or Rec.709
* **Poor quality** β low bitrate, blurry, noisy, or out of focus
* **Improper exposure** β overexposed, underexposed, or extreme contrast
* **Too much camera movement** β shaky or unstable footage is hard to work with
# Beeble vs Beeble Studio
Source: https://docs.beeble.ai/help/beeble-vs-beeble-studio
Compare Beeble and Beeble Studio to choose the right platform for your workflow
## Overview
We offer two platforms to fit different workflows and requirements. Choose the one that best matches your needs.
Web-based cloud app for instant access and cloud processing
Desktop application for local GPU processing and unlimited rendering
***
## Key Differences
| Feature | Beeble (Cloud) | Beeble Studio (Desktop) |
| ------------------------------------- | --------------------------- | --------------------------------------- |
| **SwitchX** | O | X (Cloud-exclusive) |
| **Background Remover** | O (Creator/Professional) | X (Cloud-exclusive) |
| **Platform** | Web browser | Windows & Rocky Linux desktop app |
| **Processing** | Cloud-based | Local GPU (NVIDIA RTX 30-series+) |
| **Access** | Anywhere with internet | Local machine |
| **Max Resolution** | Up to 2K | Up to 4K |
| **Max Duration (VFX Pass Generator)** | Up to 1 minute | Up to 1 hour |
| **Max Duration (SwitchX)** | 240 frames per generation | N/A (Cloud-exclusive) |
| **EXR Support** | X | O |
| **Rendering Limits** | Credit-based | Unlimited |
| **Privacy** | Uploaded to cloud | Fully local, never uploaded |
| **System Requirements** | Any device with browser | Windows/Linux + NVIDIA GPU (12GB+ VRAM) |
| **Setup** | Instant, no installation | Desktop installation required |
| **Best For** | Quick projects, remote work | High-res projects, confidential work |
***
## Which Should I Choose?
### Beeble:
* Need instant access from any device
* Want to use **SwitchX** for AI video generation (cloud-exclusive)
* Want to use **Background Remover** for AI alpha extraction (cloud-exclusive)
* Work on projects under 2K resolution
* Don't have a NVIDIA GPU with 12GB+ VRAM
* Want zero setup and installation
* Prefer cloud-based workflows
### Beeble Studio:
* Need local processing and privacy
* Need 4K resolution
* Need video over 1 minute
* Require unlimited rendering without credit limits
* Need EXR support
* Handle confidential or proprietary material
* Have a Windows or Rocky Linux PC with NVIDIA RTX 30-series+ GPU
***
## Can I Use Both?
Yes! You can use both platforms with a single Beeble account. Your account credentials work on both Beeble (Cloud) and Beeble Studio (Desktop), allowing you to choose the best platform for each project.
***
## Next Steps
Start creating instantly in your browser
Install the desktop app for local processing
View cloud plans and credits
View desktop plans and features
# Credit Policy
Source: https://docs.beeble.ai/help/credit-policy
Detailed credit costs for all Beeble AI features
This credit policy applies to **Beeble** only, not Beeble Studio.
Video generation models support one or more input modes, noted per model below:
* **Text to Video** β generate a video from a text prompt alone.
* **Image to Video** β animate a still image; the image becomes the video's starting frame.
* **Reference to Video** β generate a new video that keeps the subject or style of your reference images or video.
* **Video Edit** β modify an existing video; billing may include the source video length (see each model's notes).
# Frequently Asked Questions
Source: https://docs.beeble.ai/help/faq
Common questions about Beeble
## General
**SwitchX** is our new generative video-to-video model. It lets you modify lighting, backgrounds, props, and more, while keeping your original subject completely intact.
Because SwitchX is guided directly by your source footage at the pixel level, it ensures consistent identity, preserved details, and highly controllable results. Whether you need to relight a scene, selectively modify specific elements with a mask, or completely reimagine the artistic style of your entire shot β SwitchX allows you to switch anything, and keep what matters.
SwitchX is currently available only on Beeble (Cloud app). It is not available in Beeble Studio.
[Learn more about SwitchX β](/beeble/switchx)
**VFX Pass Generator** uses our foundation model, **SwitchLight 3.0**, and SOTA AI models to convert your footage into VFX-ready assets by generating:
* **PBR Maps:** Normal, Base color, Metallic, Roughness, Specular for relighting
* **Alpha:** foreground matte for background replacement
* **Depth Map:** For compositing and 3D integration
Your image or video becomes a **rotoscoped, relightable 2.5D asset**, ready for use in 3D Relight, Nuke, Blender, Unreal or other 3D tools for further VFX work.
**Background Remover** is a standalone AI-powered alpha extraction tool. It removes backgrounds from your images, videos, and image sequences, producing clean foreground mattes ready for compositing and VFX work.
* Upload an image, video, or image sequence
* Preview and refine alpha on sample frames before full extraction
* Download results as RGBA MOV, PNG sequences, or alpha MP4
Background Remover is available only on Beeble (Cloud app) for Creator and Professional plans. It is not available in Beeble Studio.
[Learn more about Background Remover β](/beeble/background-remover)
**3D Relight** is a real-time 3D relighting editor designed for fast, AI-powered VFX compositing. With it, you can:
* **One click import** your VFX passes directly into 3D editor
* **Relight footage** with physically accurate lights and image-based lighting
All without needing traditional 3D software.
**Yes.** Beeble's proprietary modelsβsuch as **SwitchLight**βare trained only on ethically sourced, agreement-based datasets. We never use scraped or unauthorized data.
When open-source models are included, we choose them carefullyβonly those with published research papers that disclose their training data and carry valid commercial-use licenses.
**Beeble (Cloud app)** runs in your browser with cloud-based processing, while **Beeble Studio (Desktop app)** runs locally on your workstation with NVIDIA GPU.
| Feature | Beeble (Cloud app) | Beeble Studio (Desktop app) |
| --------------------------------- | ------------------------- | --------------------------- |
| **SwitchX** | O | X (Cloud-exclusive) |
| **Background Remover** | O (Creator/Professional) | X (Cloud-exclusive) |
| **Processing** | Cloud servers | Your local GPU |
| **Privacy** | Uploads footage | Keeps everything local |
| **Resolution** | Up to 2K | Up to 4K |
| **Duration (VFX Pass Generator)** | Up to 1 minute | Up to 1 hour |
| **Duration (SwitchX)** | 240 frames per generation | N/A (Cloud-exclusive) |
| **Credits** | Uses credits | Unlimited local rendering |
[See full comparison β](/help/beeble-vs-beeble-studio)
***
## Beeble (Cloud app)
Credits are the cost unit used to access AI-powered features on Beeble. Each feature consumes credits as follows:
* **SwitchX**
* **SwitchX (720p):** 3 credits per 30 frames
* **SwitchX (1080p):** 10 credits per 30 frames
* **Reference Image:** 2 credits (Flux-2-Pro) or 4 credits (Nano-Banana-Pro) per image
* **VFX Pass Generator**
* **VFX Pass Generator:** 3 credits per 1-second video or 1 image
* **Background Remover**
* **MatAnyone** (default): 1 credit per 30 frames of video, or 1 credit per image
* **CorridorKey** (green screen): 2 credits per 30 frames of video, or 2 credits per image
For VFX Pass Generator, credits are deducted based on duration (per second), regardless of the frame rate. For Background Remover and SwitchX, credits are calculated in steps of 30 frames β so a 60fps clip costs twice as much as a 30fps clip of the same wall-clock duration.
Beeble Studio, our desktop app does not consume credits for VFX Pass Generator.
Yes. For **VFX Pass Generator**, you can preview the VFX passes on sample frames before any credits are used. For **Background Remover**, you can preview alpha mattes on sample frames and refine them before committing to full extraction. If you like what you see, you can proceedβcredits will only be deducted at that point. This preview-first workflow sets Beeble apart from most generative AI tools, which charge credits upfront.
Yes, you can upgrade anytime via your account page. Upgrades takes effect immediately, and a **prorated charge** may apply for the remaining days in your billing cycle.
Switching between monthly and yearly billing is not currently supported.
Yes. If you are on the **Professional** plan, you can downgrade to **Creator** directly β no need to cancel and resubscribe. Select Creator on the [plans page](https://app.beeble.ai/plans), or use **Change Plan** on your account page.
* The downgrade takes effect at the **end of your current billing period** β you keep Professional until then, and no refund is issued for the remaining period.
* Your billing cycle stays the same: monthly plans switch to monthly Creator, yearly plans to yearly Creator.
* Changed your mind? Until the downgrade takes effect, click **Keep Professional** on your account page to cancel it and stay on Professional.
To move to the free Starter plan, cancel your subscription instead β you keep access until the end of your current billing cycle.
Yes. You can cancel your subscription at any time. After cancellation:
* You won't be charged again
* You will retain access to all features and remaining credits until the end of your current billing cycle
To cancel, visit your account page.
No. Unused credits and monthly benefits **do not roll over** to the next
billing cycle.
If you run out of your subscription credits before renewal, you can buy
**one-time credits** [here](https://app.beeble.ai/account?buy-credits).
**Paid Users:** All uploaded and created content remains private and fully owned by you. Beeble only accesses it as necessary to provide services.
**Free-Tier Users:** You retain full ownership of your uploaded and generated content. While Beeble may use this content to improve services, we do not claim ownership.
***
## Beeble Studio (Desktop app)
**Beeble Studio** is our desktop application that runs entirely on your local hardware. It provides:
* Local VFX Pass Generation: Process up to 4K and 1 hour using your NVIDIA GPU
* Complete Privacy: Your files never leave your machine
[Learn more about Beeble Studio β](/beeble-studio/overview)
**Beeble Studio operates completely separately** from the cloud app.
* All processing happens locally on your GPU
* Projects are not synced between platforms
* VFX passes remain separate and stored only on your local machine
* No cloud integration for project files or assets
Think of them as two independent applications that share the same login credentials but maintain separate workspaces.
No. All footage and processing remain on the local device.
No. Beeble Studio does not upload user footage or use any customer content for
model training.
Yes! Beeble Studio plans come with a **7-day free trial**.
No. While all footage processing is local, an internet connection is needed
for operational purposes such as authentication.
Each Beeble Studio plan includes **one active seat**, which allows you to use
the software on a single computer at a time.
***
## Team Plan (Beeble Cloud Only)
The Team Plan is designed for teams that need centralized billing, a shared pool of credits, and simplified seat management.
* **Central Billing:** Manage all team subscriptions and purchases through a single, unified payment method and invoice.
* **Seat Management:** Invite or remove team members, adjust your total seat count, and assign Admin roles to control access.
* **Shared Pool of Credits:** When your team workspace is active, all feature deductions come from a shared pool of credits. Admins can check usage stats for the whole team.
* **Supported Features:** Team plans currently support Canvas, SwitchX, Background Remover, and VFX Passes.
* **Collaboration:** For now, projects and assets remain private to the individual member who created them. More advanced collaboration features are coming soon.
3D Relight is currently restricted to personal use and is not available in a team workspace.
Credits are the unit used to access AI features on Beeble. Team plans draw from a **shared team pool** of credits.
**Costs at a glance:**
* **SwitchX:** 3 credits (720p) or 10 credits (1080p) per 30 frames. Reference images cost 2 or 4 credits.
* **VFX Passes:** 3 credits per 1-second video or 1 image.
* **Background Remover:** 1 credit (MatAnyone) or 2 credits (CorridorKey) per 30 frames or 1 image.
* **Other models:** Costs vary by model β see the [Credit Policy](/help/credit-policy).
**Usage & expiry:**
* **Subscription credits** are consumed first and reset at the start of every billing cycle.
* **One-time credits** can be purchased anytime as a backup. They expire **90 days** after purchase.
If your shared credit pool reaches zero, ongoing and new jobs will fail. To resume work, Admins have three options:
1. **Buy one-time credits** β instantly add backup credits (expire in 90 days).
2. **Add more seats** β adding seats instantly increases your monthly credit limit (charges are prorated).
3. **Wait for the reset** β subscription credits reset at your next billing cycle.
To avoid interruptions from running out of credits, Admins can set up an automatic credit refill.
Designate a **minimum credit balance** that triggers the refill, and specify the **exact amount of one-time credits** to purchase automatically when that threshold is reached β so you don't have to buy credits manually mid-project.
Only users with the **Admin** role can manage billing, seat limits, and view per-member usage statistics. Every member can see their own current-cycle usage on the **Account** page.
* **Invite / remove members:** Open **Settings** (top-right) and go to the **Members** tab.
* **Add / reduce seats:** Click **Manage Seats**. Adding seats takes effect immediately (with a prorated charge); reducing seats takes effect at the start of your next billing cycle.
* **Monitor usage:** Check the **Member Usage** section.
Yes. You can belong to multiple team workspaces. Use the organization picker in the sidebar to switch between your active team contexts.
Yes, Admins can cancel the subscription via the billing portal at any time. Members keep access to the workspace and remaining shared credits until the current billing cycle ends. After that, unused credits expire β they cannot be transferred to personal accounts.
To switch between monthly and yearly billing, cancel your current plan and resubscribe with the desired billing frequency.
A past-due banner appears at the top of the page, and the team pool can no longer run new jobs until billing is updated. Existing personal credits and personal-context jobs are unaffected.
The Admin should click **Update billing** to open the Stripe billing portal and resolve the failed payment. The portal is also where you download invoices, update payment methods, and view past charges.
***
## Subscriptions
You can cancel your subscription at any time from your [Account Settings](https://app.beeble.ai/account).
1. Go to account setting page and click "Update Billing Details"
2. Find your plan and click "Cancel subscription"
3. Confirm cancellation by clicking "Cancel subscription"
You will retain access to your plan features until the end of the current billing period.
You can update your invoice information from your [Account Settings](https://app.beeble.ai/account).
1. Go to account setting page and click "Update Billing Details"
2. Click "Update information"
3. Update your billing information and click "Save"
The changes will be applied from the next invoice.
***
## Still Have Questions?
Get help from our support team
Connect with the community
# Welcome
Source: https://docs.beeble.ai/index
Beeble is an AI VFX platform that brings studio-grade visual effects to every creator.
Beeble
Node-graph editor for composing AI VFX pipelines across Beeble's
models.
Beeble
Video-to-video AI generation. Switch anything in your footage while
keeping what matters.
Beeble
Extract clean alpha mattes from images and videos with AI-powered
background removal.
BeebleBeeble Studio
Generate VFX passes including PBR maps, alpha, and depth maps from your
footage with AI.
BeebleBeeble Studio
Real-time 3D relighting editor with physically-based rendering for
photorealistic results.
## Products
Beeble is available as a **cloud app** and a local **desktop app** depending on your requirements.
Cloud app with instant access, no setup required. Features all models
including SwitchX. 2K support. Flexible for all creators.
Desktop app with unlimited local processing and offline VFX Pass Generator. 4K
support. Built for studios.
[See full comparison β](/help/beeble-vs-beeble-studio)
## Integration
Extend your workflow with Beeble's integrations for industry-standard tools.
Relight inside Nuke with full PBR passes
Relight inside Blender with full PBR passes
Relight inside Unreal with full PBR passes
iPhone App that brings camera tracking to Beeble
## Frequently Asked Questions
Common questions and troubleshooting
# Beeble Camera App
Source: https://docs.beeble.ai/integration/beeble-camera
iPhone App that brings camera tracking to Beeble
**Beeble Camera App** currently works exclusively with the Beeble Cloud App.
## What is Beeble Camera?
Beeble Camera is an **iPhone App that brings camera tracking to Beeble.** It uses **Apple's LiDAR and ARKit** to track your device's movement while filming. Your footage is anchored to real-world space and sent directly to the **Beeble platform** for AI-powered VFX processing.
With Beeble Camera, your iPhone becomes a mini Hollywood studio:
* Shoot with your iPhone and get real-time camera tracking
* Process instantly in Beeble Web with AI-powered roto & VFX Passes
* Create virtual productions in minutes using 3D Relight and Blender
## Step-by-Step Guide
### 1. Installation
Download **Beeble Camera** on the App Store.
### 2. How to Use
#### 2.1 Setting up your space
1. **Scan the Area**: Move your device to scan your space. ARKit will automatically detect surfaces and spatial features. When it identifies the **floor**, a square shaped focus indicator will appear.
2. **Set Origin**: Tap the floor grid to set your origin. This anchors the tracked scene to your space and ensures consistent camera tracking.
3. **(Optional) Place 3D Model**: Place a `.usdz` file into your scene as a visual reference. Scale, move, and rotate the object freely.
#### 2.2 Start Recording
Once setup is complete, switch to **Shoot mode** and tap **Record**. While recording, your **iPhone's position and orientation, and depth data** are tracked in real time using LiDAR and ARKit.
> π‘ Tips for better results
>
> * **Wipe your lens** before shooting to ensure clear capture
> * Use a **gimbal** to keep the camera as stable as possible
> * Shoot in areas with **even lighting and clean background**
#### 2.3 Upload and Process
After recording, simply tap **Upload** to send your footage to the Beeble Web.
Once the upload is complete, head over to [app.beeble.ai](https://app.beeble.ai).
There, you can process your video into a **camera-tracked, rotoscoped, relightable VFX pass** with our AI.
Your processed footage can be opened directly in the **Beeble Studio** or exported to **DCC tools like Blender** for further post-production.
## Compositing in 3D Relight
Let's create a new project for a quick composite.
To load the same 3D model you used during filming:
1. Convert it to `.glb` using **Blender or other software**
2. Upload the `.glb` file to 3D Relight
Since we have the metadata of how the 3D scene was placed, this will place the 3D model just like it was shot.
## Compositing in Blender
For advanced compositing, bring your footage into Blender using the **Beeble Blender add-on**. The camera tracking data will be included as well.
You can check out the add-on and instructions here: [https://app.beeble.ai/plugins](https://app.beeble.ai/plugins)
## Start Creating Now!
With Beeble Camera and Beeble Web, virtual production has never been this simple. Download Beeble Camera today, and start creating. Visit [beeble.ai](https://beeble.ai) to get started.
# Blender Plugin
Source: https://docs.beeble.ai/integration/blender-plugin
Relight directly inside Blender with full PBR passes
## Prerequisites
* Blender 4.2+ (tested on Windows and macOS)
* Beeble Blender Plugin - [**Download HERE**](https://release.beeble.ai/plugins/blender/latest.zip)
## Install Plugin
1. In Blender, go to **Edit > Preferences > Add-ons**
2. Select **Install from disk** at the top-right
3. Select the plugin file - `beeble-addon_{version}.zip`
4. Enable Beeble by checking its box
## Import VFX Passes
1. Download VFX passes (.zip) from Beeble web
2. In Blender, navigate to the **Beeble tab** (Press `N` to open the sidebar)
3. Click **Import** and select your .zip file
## Camera Tracking
For advanced workflows involving camera tracking, check out our tutorial:
# Nuke Plugin
Source: https://docs.beeble.ai/integration/nuke-plugin
Relight directly inside Nuke with full PBR passes
## Prerequisites
* Nuke 14.1v2+ (tested on Windows and macOS)
* Beeble Nuke Plugin - [**Download HERE**](https://release.beeble.ai/plugins/nuke/latest.zip)
## Install Plugin
1. Download and unzip the Beeble plugin folder
2. Move the Beeble folder to your `.nuke` directory:
* Linux, macOS: `~/.nuke/Beeble/`
* Windows: `C:\Users\\.nuke\Beeble\`
3. Open or create `init.py` in your `.nuke` folder and add:
```python theme={null}
nuke.pluginAddPath('./Beeble')
```
4. Restart Nuke, and you can find Beeble on your toolbar
## Quick Start
### 1. Load PBR Passes
1. Prepare your VFX passes. It should be unzipped folder
2. In Nuke, go to the left toolbar and click **Beeble > Load PBR Passes**
3. Select the folder that contains your VFX passes. The plugin supports EXR, PNG, and MP4:
* **EXR**: the folder should contain an EXR sequence where multiple passes are packed into each EXR file (e.g.`Frame_000001.exr`).
* **PNG**: the folder should contain subfolders for each pass, and each subfolder holds a PNG image sequence (e.g.`Normal/Normal_000001.png`).
* **MP4**: the folder should include one video per pass, named like `.mp4` (e.g.`Normal.mp4`).
### 2. Add Light
Go to **Beeble > Lights** and select the type of light that you want. Connect the **PBRController** output to the light input.
For the **Environment Light**, load an HDRI file and connect it to the light input.
### 3. Relight
1. Adjust the light properties in the control panel to get your desired look.
2. To add multiple lights, use a Merge node, set to **plus**.
## Node Reference
| Node | Input | Output | Description |
| -------------------------- | ------------------------------------------------------------------- | ----------------- | -------------------------------------------------------- |
| **PBRPacker** | Source, Normal, Basecolor, Roughness, Specular, Metallic (6 inputs) | PBR (multi-layer) | Packs individual passes into a single stream with layers |
| **PBRController** | PBR (multi-layer) | PBR (multi-layer) | Adjusts PBR pass intensities and blending |
| **BeebleDirectionalLight** | PBR (multi-layer) | RGBA | Applies directional lighting to PBR passes |
| **BeeblePointLight** | PBR (multi-layer) | RGBA | Applies point lighting to PBR passes |
| **BeebleEnvironmentLight** | PBR (multi-layer), HDRI (2 inputs) | RGBA | Applies image-based lighting using an HDRI |
**PBR (multi-layer)** refers to a single image stream containing multiple
Nuke layers: Source, Normal, Basecolor, Roughness, Specular, and Metallic.
This format is produced by PBRPacker (for MP4/PNG) or directly available in
EXR sequences generated by Beeble.
## Nodes
### PBR Packer
The PBR Packer combines individual PBR pass inputs into a single multi-layer stream.
Automatically created when using **Load PBR Passes** with MP4/PNG. Not
needed for EXR sequences as passes are already packed into layers.
1. To add manually, go to **Beeble > Helpers > PBR Packer**
2. Connect the 6 inputs: Source, Normal, Basecolor, Roughness, Specular, Metallic
### PBR Controller
The PBR Controller allows you to fine-tune the PBR passes.
PBRController is automatically created when you use **Load PBR Passes**.
1. To add manually, go to **Beeble > Helpers > PBR Controller**
2. Adjust the parameters:
| Parameter | Range | Description |
| ------------------ | ------- | ------------------------------------------ |
| Source Blend | 0-1 | Blend between BaseColor (0) and Source (1) |
| Roughness Exposure | -2 to 2 | Adjust roughness intensity in stops |
| Specular Exposure | -2 to 2 | Adjust specular intensity in stops |
| Metallic Exposure | -2 to 2 | Adjust metallic intensity in stops |
### Directional Light
1. Go to **Beeble > Lights > Beeble Directional Light**
2. Connect the **PBRController** output to the light input
3. Adjust the parameters:
| Parameter | Range | Description |
| --------------- | --------- | ----------------------------------- |
| lightHorizontal | 0 to 360 | Horizontal rotation angle (degrees) |
| lightVertical | -90 to 90 | Vertical rotation angle (degrees) |
| lightColor | - | Color of the light |
| intensity | 0+ | Brightness multiplier (default 1.0) |
### Point Light
1. Go to **Beeble > Lights > Beeble Point Light**
2. Connect the **PBRController** output to the light input
3. Adjust the parameters:
| Parameter | Range | Description |
| ----------------- | ------- | ----------------------------------------------------- |
| Light Position XY | pixels | Position in image |
| Light Depth (Z) | -5 to 5 | Depth along Z-axis |
| lightColor | - | Color of the light |
| intensity | 0+ | Brightness multiplier (default 1.0) |
| decay | 0+ | Distance falloff power (default 2.0 = inverse square) |
| maxDistance | 0+ | Maximum light reach (0 = infinite) |
Double-click the PointLight gizmo and select **TransformHandle** to
interactively position the light in the viewer. Drag to move XY position,
rotate (like a screwdriver) to adjust depth.
### Environment Light
Environment Light applies image-based lighting (IBL) using an HDRI image for realistic ambient illumination.
1. Go to **Beeble > Lights > Beeble Environment Light**
2. Connect the **PBRController** output to the **PBR** input
3. Connect an HDRI image (Read node with .exr or .hdr) to the **HDRI** input
4. Adjust the parameters:
| Parameter | Range | Description |
| ------------------- | --------- | ---------------------------------------------- |
| Intensity | 0+ | Overall brightness multiplier (default 1.0) |
| Diffuse Intensity | 0+ | Diffuse lighting contribution (default 1.0) |
| Specular Intensity | 0+ | Specular/reflection contribution (default 1.0) |
| Horizontal Rotation | 0 to 360 | Rotate HDRI horizontally (degrees) |
| Vertical Rotation | -90 to 90 | Rotate HDRI vertically (degrees) |
Combine Environment Light with Directional or Point lights using a Merge
node for more complex lighting setups.
# Unreal Engine Plugin
Source: https://docs.beeble.ai/integration/unreal-engine-plugin
Relight directly inside Unreal Engine with full PBR passes
## Prerequisites
* Unreal Engine 5.3+ (tested on Windows)
* Beeble Unreal Engine Plugin - [**Download HERE**](https://release.beeble.ai/plugins/unreal/latest.zip)
## Step-by-Step Guide
### 1. Preparation
#### 1.1 Plugin Download
1. Download **the UE plugin** from [**HERE**](https://release.beeble.ai/plugins/unreal/latest.zip)
2. Unzip the plugin file.
#### 1.2 Start Unreal
1. Launch Unreal Engine.
2. Open a new project; we recommend choosing a blank template in the FILM / VIDEO & LIVE EVENTS category.
#### 1.3 Enable Required Editor Plugin
> π‘ To ensure full functionality of the plugin, make sure the following Unreal Engine plugins are enabled: **Python Editor Script Plugin & Geometry Script Plugin**
1. Navigate through `Edit` > `Plugins`.
2. Find the `Python Editor Script Plugin` and check the box next to it if it's not already activated.
3. Find the `Geometry Script Plugin` and check the box next to it if it's not already activated.
#### 1.4 Place the Beeble plugin folder inside Unreal Project Plugins folder
> **β οΈ Beeble Plugin is project-based. Do not install it globally. Place it in `YourProject/Plugins` (usually under `Documents/Unreal Projects`).**
1. Open the File Explorer of your Unreal Project.
2. Navigate into `Plugins` folder. (*If the Plugins folder doesn't exist, create one*)
3. Copy the unzipped plugin folder, `BeeblePBRLoader`, into the `Plugins` directory.
#### 1.5 Activate Beeble plugin
1. Restart your project.
2. Upon restart, the plugin will initialize automatically, and you should see `Beeble PBR Loader` appear in the top menu.
### 2. Recommended Setup
#### 2.1 High Quality Translucency Reflections
1. Navigate to `Edit` > `Project Settings`. Find `High Quality Translucency Reflections` and make sure to enable this feature to minimize artifacts in the viewport.
#### 2.2 Use Lumen for Reflections & Global Illumination
1. Navigate to `Edit` > `Project Settings`. Find `Reflections` & `Global Illuminations`. Ensure that `Lumen` is selected for both of these features.
#### 2.3 Support Hardware Raytracing
1. Navigate to `Edit` > `Project Settings`. Find `Support Hardware Raytracing`. and make sure to enable this feature.
#### 2.4 Increase Cache for smooth playback
1. Navigate to `Edit` > `Project Settings` > `Plugins` > `Img Media`
### 3. Usage
#### 3.1 Load PBR maps using the script
1. Navigate to `Beeble PBR Loader` > `Import PBR Maps` to select the VFX Pass directory.
2. Select the unzipped VFX Pass directory. IMPORTANT: DO NOT select one of the VFX Pass directory inside.
3. After successfully loading the VFX Pass directory, two actors will be visible in the outliner: `Beeble Camera` and `Beeble Footage`. Also, upon opening `Content Drawer` (located at bottom), a `Beeble_0000` folder along with its associated assets will be automatically created.
4. To view and edit the preview of rendered image sequences, select `PBRSequencer`.
5. In Sequencer panel, you can find VFX Passes are added together with Camera Cut and Beeble Camera. To view the scene from the perspective of the Beeble Camera, simply click the `Perspective` button.
6. If you want to learn about the Beeble material node graphs, simply click on `PBRMaterial` in `Content Drawer`.
7. This node graph connects PBR textures to the BSDF material, performing color space conversion (when required) and processing of normal maps, to ensure the precise rendering output.
#### 3.2 Render using Movie Render Queue
1. Make sure that the movie render queue plugin is enabled.
2. Open the sequencer again by clicking `PBRSequencer` in the `Content Browser` and then click on the button shown in the image below.
3. Open the settings configuration. Add **Anti-aliasing** to the settings list. Enable **Override Anti Aliasing** and select either **None**, **FXAA**, or **MSAA**. These options are recommended because temporal methods like TSR and TAA blend data from previous frames, which can cause ghosting artifacts.
4. Click on the `Render (Local)` button. In case the `Movie Render Queue` window doesn't appear, verify that the `Movie Render Queue Plugin` is enabled.
5. Rendered results will be saved under your Unreal Project folder.
#### 3.3 Media Plane Controllability
> π‘ This section explains how to use the plugin's smart scaling features, which help maintain accurate projection and visual consistency as camera properties change.
1. **Automatic Focal Length Scaling**: When you change the focal length of the `Beeble Camera`, the media plane, `Beeble Footage`, scale is automatically adjusted to keep the projected media correctly proportioned within the frame.
2. **Distance-Based Scaling**: When you change the distance between the `Beeble Footage` and the `Beeble Camera` using the `Plane Distance` setting, the plane automatically resizes to maintain proper proportions and accurate projection.
## FAQ
### Why do my rendered results in the viewport look too glossy?
Please make sure to enable high quality translucency reflections.
### Can I use path-tracing with Beeble?
No. Path tracing is designed to replicate how light interacts in the real-world. Beeble uses 2D planes to mimic 3D geometry, which disrupts the path-tracing process. For instance, a 2D plane in Beeble will block photons from reaching its front surface if the light source is behind it, making effects like rim lighting unachievable with path-tracing. Additionally, using path-tracing with Beeble can result in various artifacts.
### Which renderer should I use with Beeble PBR maps?
For rendering PBR (Physically Based Rendering) maps in Beeble, we suggest using ThreeJS, Unreal Engine 5's Lumen, and Blender's EEVEE. These renderers have been tested and confirmed to produce accurate results. To ensure proper setup of PBR maps, users are advised to use the official plugins provided for Blender and Unreal Engine, as the setup process can be complex.
# Background Remover
Source: https://docs.beeble.ai/tutorial/background-remover-tutorial
Professional-grade AI rotoscoping with Beeble Background Remover
Meet **Background Remover**, Beeble's AI tool built for professional-grade rotoscoping. Advanced AI models automatically generate clean, detailed foreground masks, handling everything from complex motion to fine details.
The video walks you through the complete workflow:
1. **Preview a frame** to check the mask before running the full clip
2. **Edit the alpha** to refine the result
3. **Export** with the format options that fit your pipeline
***
## Related Resources
Full Background Remover feature guide
Key green screens without green spill
# Beeble Camera Tutorial
Source: https://docs.beeble.ai/tutorial/beeble-camera-tutorial
Bring camera tracking to Beeble with our iPhone app, Beeble Camera
With Beeble Camera, your iPhone becomes a mini Hollywood studio:
1. **Shoot** with your iPhone and get real-time camera tracking.
2. **Process** instantly in Beeble Web with AI-powered roto & VFX Passes.
3. **Create** virtual productions in minutes using Beeble Web Studio and Blender.
***
## Related Resources
Learn more about VFX Pass Generator
Explore 3D Relight capabilities
# Blender Tutorial
Source: https://docs.beeble.ai/tutorial/blender-tutorial
Relight any video directly inside Blender with PBR passes and Blender plugin
Learn how to integrate Beebleβs AI-generated VFX passes into your Blender workflow.
***
## Related Resources
Explore all 3D Relight features
# Camera Tracking in Blender
Source: https://docs.beeble.ai/tutorial/camera-tracking-blender
Learn how to integrate real camera tracking data for dynamic, cinematic 3D scenes
Let's learn how to integrate real camera tracking data for dynamic, cinematic 3D scenes. This tutorial walks you through the full workflow:
1. Get VFX passes with **Beeble**
2. Get camera tracking data with **After Effects**
3. Create rotoscoped, relightable & camera-tracked scene in **Blender**
See how realistic camera movement brings your VFX to life, blending 3D elements seamlessly with your footage.
***
## Related Resources
Import VFX passes into Blender
iPhone app for camera tracking in Beeble
# Camera Track with Canvas
Source: https://docs.beeble.ai/tutorial/canvas-camera-track
Match your camera motion using SwitchX in Beeble Canvas
A 4-step tutorial on **camera tracking with SwitchX** in Beeble Canvas, transforming a green screen studio shoot into a seamless, cinematic Sci-fi environment with consistent background replacement and relighting across multiple shots.
The video walks you through the complete workflow:
1. **Generate a reference image** with Nano Banana Pro and the Camera Angle node
2. **Generate a video matte** to mask the subject
3. **Swap backgrounds with SwitchX** while keeping correct camera tracking and relighting across every shot
4. **Assemble the final sequence** in the Compositor node
***
## Related Resources
Learn about Beeble Canvas
Full SwitchX feature guide
# Crowd VFX with Canvas
Source: https://docs.beeble.ai/tutorial/canvas-crowd-vfx
Transform an empty stadium into a cheering crowd with Beeble Canvas
An AI **Crowd Simulation VFX** tutorial β transforming an empty stadium by adding a highly active, cheering crowd.
The video walks you through the complete 3-step workflow:
1. **Generate a realistic background** with AI video models like Seedance, Happy Horse, and Kling
2. **Isolate and composite the subject** using the Video Matte node
3. **Match the original color and tone** seamlessly with SwitchX
***
## Related Resources
Learn about Beeble Canvas
Full SwitchX feature guide
# Driving Plate VFX with Canvas
Source: https://docs.beeble.ai/tutorial/canvas-driving-plate
Composite realistic driving plate VFX with Beeble Canvas
A 5-step tutorial on compositing **realistic driving plate VFX** using Beeble Canvas, transforming a green screen studio shoot into a cinematic, golden hour driving sequence without expensive LED volumes.
The video walks you through the complete workflow:
1. **Generate a video matte** to isolate the car and subjects
2. **Combine FG & BG elements** inside the layer-based Compositor node
3. **Generate a golden hour reference image** with Nano Banana 2
4. **Blend the scene with SwitchX**, matching colors and generating new reflections across the windshield and hood
5. **Assemble the final shots** in the Compositor node
***
## Related Resources
Learn about Beeble Canvas
Full SwitchX feature guide
# Realistic Fire VFX with Canvas
Source: https://docs.beeble.ai/tutorial/canvas-fire-vfx
Add realistic fire VFX to your footage using Beeble Canvas
A 5-step tutorial on adding **realistic fire VFX** to an unlit torch using Beeble Canvas.
The video walks you through the complete workflow:
1. **Auto-generate prompts** with the Gemini LLM node
2. **Craft detailed masks** for precise control
3. **Composite seamlessly** with SwitchX
4. **Relight naturally** while perfectly preserving the subject's original details
5. **Match colors** across multiple shots for a blazing fire effect
***
## Related Resources
Learn about Beeble Canvas
Full SwitchX feature guide
# Introducing Canvas
Source: https://docs.beeble.ai/tutorial/canvas-launch
Stop prompting, start compositing with Beeble Canvas
Meet **Beeble Canvas** β a node-graph workspace where you compose AI VFX pipelines visually instead of prompting shot by shot. Connect inputs, mattes, relighting, and compositing into one repeatable graph and iterate on the whole scene at once.
***
## Related Resources
Learn about Beeble Canvas
Full SwitchX feature guide
# Sky Replacement with Canvas
Source: https://docs.beeble.ai/tutorial/canvas-sky-replacement
Create a quick and stunning sky replacement using Beeble Canvas
Discover how to perform a quick and stunning **Sky Replacement** using Beeble Canvas β transforming a dull, overcast sky into a vibrant blue sky, golden sunset, or breathtaking aurora.
The video walks you through the complete 4-step workflow:
1. **Mask the sky** using the Video Matte or Depth Generator node
2. **Create beautiful reference images** with GPT Image
3. **Swap the sky instantly** with SwitchX
4. **Let SwitchX relight automatically** β even matching complex water reflections
***
## Related Resources
Learn about Beeble Canvas
Full SwitchX feature guide
# Green Screen Keying with CorridorKey
Source: https://docs.beeble.ai/tutorial/corridorkey-green-screen
Key green screens without green spill using CorridorKey in Background Remover
Meet **CorridorKey**, the AI model built by Corridor Crew specifically for green screens, now available in Beeble Background Remover β no more green spill.
The video walks you through the complete workflow:
1. **Select CorridorKey** as the model for your green screen footage
2. **Preview a frame** to check the key before running the full clip
3. **Edit the alpha** to refine the result
4. **Export** with the format options that fit your pipeline
***
## Related Resources
Full Background Remover feature guide
Turn green screen footage into cinematic shots
# Green Screen to VFX
Source: https://docs.beeble.ai/tutorial/green-screen-to-vfx
Transform your green screen footage into a stunning cinematic shot with Beeble
Transform your green screen footage into a stunning cinematic shot with Beeble. The video walks you through the full workflow:
1. **Generate VFX passes** from your footage to make it **relightable**
2. **Add point lights and refine details** for final touch
See the transformation in action with dramatic before-and-after comparisons that speak for themselves.
***
## Related Resources
Learn about 3D Relight
# Nuke Tutorial
Source: https://docs.beeble.ai/tutorial/nuke-tutorial
Relight any video directly inside Nuke with PBR passes and Nuke plugin
Learn how to integrate Beeble's AI-generated VFX passes into your Nuke workflow. This tutorial covers:
1. **One click Import:** Load VFX passes generated from Beeble directly into Nuke.
2. **Relight 2D footage:** Use Point Light, Directional Light, and HDRI Environment Light.
3. **Animate Lights:** Create advanced muzzle flashes or seamlessly match plate lighting by animating lights using the CurveTool node.
# Overview
Source: https://docs.beeble.ai/tutorial/overview
Step-by-step video guides to master Beeble workflows
## Canvas
Stop prompting, start compositing with Beeble Canvas
Match your camera motion using SwitchX in Beeble Canvas
Composite realistic driving plate VFX with Beeble Canvas
Add realistic fire VFX to your footage using Beeble Canvas
Create a quick and stunning sky replacement using Beeble Canvas
Transform an empty stadium into a cheering crowd with Beeble Canvas
## SwitchX
Learn how to use SwitchX to transform your footage with AI video generation
Transform your scene from day to night with SwitchX relighting
Swap outfits while keeping your original subject intact with SwitchX
## SDR to HDR
Recover true HDR from any footage and export ACES EXR sequences
## Background Remover
Professional-grade AI rotoscoping with automatic foreground masks
Key green screens without green spill using CorridorKey in Background Remover
## 3D Relight & Integrations
Transform green screen footage into stunning cinematic shots with AI-powered relighting
Relight any video directly inside Nuke with PBR passes and Nuke plugin
Relight any video directly inside Blender with PBR passes and Blender plugin
Integrate real camera tracking data for dynamic 3D scenes with Beeble VFX passes in Blender
Relight any video directly inside Unreal Engine with PBR passes and Unreal Engine plugin
Bring camera tracking to Beeble with our iPhone app, Beeble Camera
[Watch All Tutorials on YouTube β](https://www.youtube.com/playlist?list=PLv0yLOEloeOADrXUXqV5pAEdxUMo0K9aY)
***
## Need Help?
Common questions and answers
Get help from the community
# SDR to HDR
Source: https://docs.beeble.ai/tutorial/sdr-to-hdr-tutorial
Recover true HDR from any footage with Beeble SDR to HDR
A full walkthrough of **SDR to HDR**, which recovers scene-linear HDR from any SDR video and outputs ACES2065-1 (AP0) EXR sequences, ready for professional color and VFX pipelines.
In 3 minutes, the video covers the complete workflow:
1. **Prep your source** footage for conversion
2. **Adjust masks** to control where reconstruction happens in clipped highlights and shadows
3. **Guide reconstruction with prompts** β everything outside the mask stays untouched
4. **Export the output** as an EXR sequence
5. **Load the result** in DaVinci Resolve and Nuke
***
## Related Resources
Full SDR to HDR feature guide
Learn about Beeble Cloud
# Day to Night Relighting with SwitchX
Source: https://docs.beeble.ai/tutorial/switchx-day-to-night
Transform your scene from day to night with SwitchX relighting
Part of the **SwitchX tutorial series** β tips and tricks for getting the most out of SwitchX. This tutorial covers relighting, and how to use SwitchX to transform your scene from day to night.
SwitchX is guided directly by your source footage at the pixel level. That means consistent identity, preserved detail, and controllable results that stay grounded in your original performance.
SwitchX is available only on Beeble (Cloud app).
***
## Related Resources
Full SwitchX feature guide
Swap outfits while keeping your subject intact
# Outfit Swap with SwitchX
Source: https://docs.beeble.ai/tutorial/switchx-swap-outfits
Swap outfits while keeping your original subject intact with SwitchX
Part of the **SwitchX tutorial series** β tips and tricks for getting the most out of SwitchX. This tutorial shows how to swap outfits while keeping your original subject completely intact.
SwitchX is guided directly by your source footage at the pixel level. That means consistent identity, preserved detail, and controllable results that stay grounded in your original performance.
SwitchX is available only on Beeble (Cloud app).
***
## Related Resources
Full SwitchX feature guide
Transform your scene from day to night
# SwitchX
Source: https://docs.beeble.ai/tutorial/switchx-tutorial
Learn how to use SwitchX to transform your footage with AI video generation
Learn how to use **SwitchX**, Beeble's generative video-to-video model. Switch lighting, backgrounds, props, and more β while keeping your original subject completely intact.
SwitchX is available only on Beeble (Cloud app).
***
## Related Resources
Full SwitchX feature guide
Learn about Beeble Cloud
# Unreal Engine Tutorial
Source: https://docs.beeble.ai/tutorial/unreal-engine-tutorial
Relight any video directly inside Unreal Engine with PBR passes and UE plugin
Take your Beeble VFX passes into Unreal Engine for real-time compositing and interactive relighting.
***
## Related Resources
Install and setup the Unreal Engine plugin
Generate VFX passes with Beeble