Node Catalog

Explore 86 node references across knowledge, automation, motion, simulation, 3D, and media. Open a node's full reference for its connections, parameter options, buttons, and usage steps. Search by name, control, or capability, or choose a category.

Workflow guides: Image generation and review · Patterns and cloth · Motion and batch rendering · Image-GS Splat.

Core and Utility

For Each

for_each

Loop over Mocap Collection outputs, checked BVH paths, or a numeric parameter range. The start node passes the active animation downstream.

Use and connections: Connect Collection output to source, route the animation through processing and Scene to Render, and connect Render to for_each_end.render. Use Run For Each, Stop, Loop Limit, Single pass, or Start at iteration. A comment wrapper groups the loop; each render must finish before the next iteration.

Workflow guide →

Inputs, parameters, buttons, and usage

Connections and result

Connect a Mocap Collection to source. Send the start node output through animation processing, Scene, and Render. Connect Render to the paired For Each End render input.

Parameters and options

Control	What it does
Iterate	Collection outputs respects the collection’s Checked only setting. Checked paths always uses checked files. Parameter range changes a numeric parameter instead of selecting takes.
Loop Limit	0 / All visits every eligible input. A positive number caps the iterations run, including when starting partway through the list.
Single pass / iteration	Runs one eligible iteration; numbering starts at 1. This overrides Loop Limit and counts eligible inputs, not the original collection row numbers.
Loop Start / start iteration	Starts at a chosen eligible iteration and continues. Enabling it turns off Single pass.
Parameter / Count / First value / Step	In Parameter range mode, choose the parameter to vary, number of values, initial value, and increment.

Buttons and editing actions

Control	What it does
Run For Each	Starts the loop and waits for each connected render to complete before advancing.
Stop	Stops the running loop.
Create wrapper	Recreates the comment wrapper and paired end node if the wrapper was deleted.

Using this node

Load and check takes in Mocap Collection.
Connect the render chain and its completion output to For Each End.
Try Single pass first, then run the full range.

Putting a Render node inside the comment wrapper does not replace the required connection to the end node.

For Each End

for_each_end

Complete a For Each iteration when its connected Render job finishes.

Use and connections: Use the paired end node created with For Each. Connect the Render node to its render input; grouping nodes visually is not enough to define render completion.

Workflow guide →

Inputs, parameters, buttons, and usage

Connections and result

Connect the final Render node to render. This is the completion boundary for the paired For Each start node.

Parameters and options

Control	What it does
render	The render job that must finish before the start node advances.
Iteration status	Reports loop progress; this is runtime state rather than a second loop counter to configure.

Buttons and editing actions

Control	What it does
Paired loop controls	Use Run For Each and Stop on the start node. The end node supplies the completion connection.

Using this node

Create a For Each node and use its paired end node.
Connect Render output to render on the end node.
Run a single iteration to confirm the render finishes before advancing.

note

Note tasks and text content with per-parameter controls.

Inputs, parameters, buttons, and usage

Connections and result

Use a Note to supply text or task parameters to downstream nodes. Gantt Chart can turn connected Note parameters into scheduled tasks.

Output and checks: Note keeps all regular nonempty values available, with their parameter names as metadata, whether checked or unchecked. Prompt selection happens in the receiving Qwen Image or MiniMax H3 node: a Note with multiple visible parameters contributes only checked values, without parameter labels. A Note with exactly one visible parameter contributes its value even unchecked. Hidden/internal parameters do not count; an empty second visible parameter still makes it a multi-parameter Note. H3 also honors these selections through Append and Switch; an empty connected selection reports an error instead of using a saved local prompt.

Parameters and options

Control	What it does
Parameter name	Identifies a text value or task. Use distinct names when matching tasks between charts.
Parameter value	Contains the text sent downstream. Select a parameter in the info panel to edit its contents.
Featured parameter	Chooses which parameter is expanded in the node body; other parameters remain on the node.
Row checkbox	Marks a value for consumers that use selection, including Qwen Image and all MiniMax H3 prompt inputs. It does not remove unchecked data from the Note's general output.

Buttons and editing actions

Control	What it does
Add Param / Remove Selected	Adds a parameter row or removes the selected row in the info panel.
Apply Changes	Saves the edited parameter names and values to the graph.
Edit Params… / Rename…	Opens parameter editing or changes the node name.
Set display to selected param	Select a row in the parameter table, then use this info-panel button to show its value inside the Note.

Using this node

Add named parameters and enter their text.
Select the most useful row and set it as the displayed parameter.
Connect the Note to Append, Librarian, or a Gantt Chart.

node

Standard general-purpose parameter node.

Inputs, parameters, buttons, and usage

Connections and result

A general-purpose graph node carries named parameters and links. Choose a specialized node when you need a renderer, model request, or file-processing action.

Parameters and options

Control	What it does
Name and parameter names	Give the node and each value meaningful names so downstream connections can be identified.
Parameter values	Edit values in the parameter/info panel. Their meaning depends on the node receiving them.
Connections	Route the desired value to a downstream input; a generic node has no specialized conversion settings.

Buttons and editing actions

Control	What it does
Add Param	Adds a named value in the info-panel parameter table.
Remove Selected	Removes the selected parameter row.
Apply Changes	Saves the edited names and values to the graph.
Edit Params… / Rename…	Opens parameter editing or changes the node name. There is no node-specific generation button.

Using this node

Create a Node and add the values needed by your workflow.
Name the values clearly.
Connect them to the receiving node and configure that node for the operation.

append

Ordered input aggregation; can drive Gantt group order.

Inputs, parameters, buttons, and usage

Connections and result

Connect several upstream text sources. Append combines their content in its displayed input order; Gantt Chart also uses this order for groups.

Parameters and options

Control	What it does
Input order	Order matters: the preview and saved result follow the Append list, not alphabetical node names.
Upstream parameter text	Each entry identifies the source node/parameter and its resolved text. Empty text contributes no content.
Local and connected values	The merge preview distinguishes the entries collected for this Append node.

Buttons and editing actions

Control	What it does
Preview Merge (Append order)	Opens the collected entries and merged text for inspection.
Copy Text	Copies the merged text from the preview dialog.
Save JSON	Writes the collected merge data to a chosen JSON file.

Using this node

Connect the notes or text-producing nodes to combine.
Arrange their order in Append.
Preview the merge before connecting it to a prompt or Gantt Chart.

switch

Single-branch selection from multiple upstream nodes.

Inputs, parameters, buttons, and usage

Connections and result

Connect alternative branches and route the selected branch to a downstream node.

Parameters and options

Control	What it does
Active branch	Only the selected input branch supplies the active value downstream.
Input order	The branch selector follows the connected branch list. Check the displayed source when stepping through alternatives.

Buttons and editing actions

Control	What it does
Previous branch / Next branch	The left and right arrow buttons change the selected input.

Using this node

Connect two or more alternative sources.
Use the arrows to select the desired source.
Check the downstream preview before running its operation.

gantt_chart

Scheduling board with multi-note grouping, collapse state persistence, and CSV copy/paste transfer.

Inputs, parameters, buttons, and usage

Connections and result

Connect Notes directly or through Append. Each connected Note becomes a task group; Append determines group order.

Parameters and options

Control	What it does
Task rows and dates	Assign work to days on the chart. The horizontal day scrollbar moves the visible date range.
Progress	Track completion for individual tasks alongside their scheduled days.
Groups	Expand or collapse each Note group. The group state is saved with the workflow.
Reminder date / time / message	Select a task, choose a notification date and 12-hour time with AM/PM, and enter the reminder message.
Task panel width	Resize the task-name area to leave enough room for labels.

Buttons and editing actions

Control	What it does
Today	Jumps the chart back to the current date.
Copy	Copies assignments and progress and writes a CSV transfer log.
Paste	Matches task names and transfers their assignments and progress to this chart; unrelated tasks remain.
Reminder control	Opens reminder scheduling for the selected task.

Using this node

Connect Notes containing named tasks.
Assign dates and progress in the chart.
Copy and paste between charts when their task names should share a schedule.

Copy/paste matches task names. Use consistent names for tasks that should receive the same schedule.

python

Run custom scripts in graph context.

Inputs, parameters, buttons, and usage

Connections and result

Connected text is available to the script through inputs and primary_input. The script also receives node, params, raw_params, and graph_scene.

Parameters and options

Control	What it does
Code	The Python source executed by this node. Edit and save it before running.
params / raw_params	Read named parameter values or the original parameter entries.
inputs / primary_input	inputs includes source-node keys and in1, in2-style keys. primary_input is the first nonempty resolved text input.
output_text / result	Set output_text for the downstream text; result is used next, then captured standard output when neither is set.

Buttons and editing actions

Control	What it does
Edit Code…	Opens the node’s Python script editor.
Run Python	Executes the script and displays captured output or errors in the info-panel console.
Add to Shelf	Saves this node as a user-invoked shelf tool through the app.

Using this node

Connect source text and open Edit Code.
Read primary_input and assign the transformed text to output_text.
Run Python and inspect the console and downstream value.

output

Terminal collector for final graph output.

Inputs, parameters, buttons, and usage

Connections and result

Connect the final branch to this terminal node. Running it refreshes the active upstream path and its displayed result.

Parameters and options

Control	What it does
Mode: Auto	Updates automatically as the relevant graph state changes.
Mode: Manual	Leaves execution under the Run button’s control.
Mode: Run On Startup	Runs the output path on startup of the loaded workflow.

Buttons and editing actions

Control	What it does
Run	Recomputes the active path and refreshes the output display and connected response widgets.

Using this node

Connect the final processing node to Output.
Choose Manual while assembling the graph.
Press Run, then select the automatic mode appropriate to the workflow.

AI and Knowledge

local_server

Local server endpoint configuration.

Inputs, parameters, buttons, and usage

Connections and result

Embeds the configured server webpage in the node. It is a browser-facing endpoint node; LLM Prompt provides provider/model request settings.

Parameters and options

Control	What it does
url / address / endpoint	Set the server address using one of these recognized parameter names. Changing it updates the embedded browser target.
Embedded page	Controls inside the browser belong to the server you opened and depend on that service.

Buttons and editing actions

Control	What it does
Page interaction	Use the embedded webpage’s controls. This node does not install or start the external server for you.

Using this node

Start the local service you want to use.
Enter its address on the node.
Confirm the embedded page loads and use its own interface.

The embedded page requires Qt WebEngine. An unavailable service or incorrect URL will not become reachable simply by adding this node.

llm_prompt

OpenAI or Ollama/DeepSeek model settings and response generation for Chatbot workflows.

Inputs, parameters, buttons, and usage

Connections and result

Connect prompt text and optional files; connect this node to Chatbot to supply its model configuration. output_path can specify where standalone output is saved.

Parameters and options

Control	What it does
Provider	Choose OpenAI, DeepSeek, or Ollama. Provider selection changes the relevant connection and model controls.
Model	Select or enter a model supported by the chosen provider. The configured default is gpt-4.1-mini.
Temperature	Controls generation variability; the node default is 0.2. Supported behavior depends on the selected model.
API key	Credentials for the selected hosted provider.
Ollama URL	Address of the local Ollama server; default http://localhost:11434. The model must be installed on that server.
prompt / files / output_path	Provide the request, optional referenced files, and optional saved-output location. Connected inputs supply the values used by the request.

Buttons and editing actions

Control	What it does
Send to GPT	Collects the prompt and file inputs and sends them to the selected provider; the button also serves Ollama and DeepSeek.

Using this node

Choose the provider and a model available there.
Provide credentials or a working Ollama address.
Connect a Note to prompt and send a small request before adding files.

chatbot

Conversation workflows with Database history, Voice Actor input, LLM Prompt runtime, and optional mediator_input.

Inputs, parameters, buttons, and usage

Connections and result

Connect llm_prompt for generation settings, database for stored chat history, Voice Actor to the voice input, and optional mediator_input for agent tool handoff.

Parameters and options

Control	What it does
Message entry	Text for the next conversation turn.
Model connection	The linked LLM Prompt node supplies provider, model, credentials, and generation settings.
Database connection	The connected Database node chooses the stored conversation context.
Voice and Mediator connections	Voice Actor can supply recognized speech. Mediator receives supported tool requests when connected.

Buttons and editing actions

Control	What it does
Send	Submits the entered message using the configured conversation and model context.
Refresh	Reloads the displayed conversation state.

Using this node

Connect and configure LLM Prompt.
Optionally select a Database collection/project.
Enter a message and Send; add voice or agent handoff after the text path works.

Chatbot owns its spoken response when Voice Actor is connected to it; adding Mediator is not a second independent speaking path.

database

Persistence layer for graph and chat data.

Inputs, parameters, buttons, and usage

Connections and result

The mongo_uri, collection, project, and note inputs configure a MongoDB-backed context that can be connected to Chatbot.

Parameters and options

Control	What it does
Mongo URI	MongoDB connection string; default mongodb://localhost:27017. The database service must be reachable.
Collections / Collection name	Choose an existing collection or enter the name to use.
Projects / Project name	Choose or name the project within the collection.
Note text	Text to store in the selected collection/project.

Buttons and editing actions

Control	What it does
Refresh	Reloads available database selections.
Create/Use	Creates or selects the entered context.
Save Note	Stores the entered note in the chosen context.
Delete Project / Delete Collection	Removes the selected stored project or collection. Check the selection before using these actions.

Using this node

Enter a reachable Mongo URI and Refresh.
Choose a collection and project, or enter names and Create/Use.
Save a note or connect the configured Database to Chatbot.

data_nexus

Folder-aware knowledge canvas for points, vault files, graph relationships, question and slide point types, review rings, references, and answer-to-question links.

Inputs, parameters, buttons, and usage

Connections and result

Outputs a structured knowledge graph for Skills, Task, and Mediator. The canvas organizes points, folders, links, questions, and generated slides.

Parameters and options

Control	What it does
Point and folder selection	Select the item whose content or relationships you want to edit. Folder organization also controls the vault representation.
Needs? / Refine?	Show or hide source-point lines for questions needing stronger answers or refinement.
Pull / maximum link stretch	Pull linked points together only after a link exceeds the chosen stretch distance.
Zoom	Use −, 1:1, and + to inspect the graph without changing its data.
Point types	Question, refinement, slide, and ordinary point types have distinct colors. White review rings identify newly added points.

Buttons and editing actions

Control	What it does
Add point / Create folder	Adds knowledge or an organizational folder.
Link selected point	Creates a relationship from the selected point.
Delete selected point	Requests deletion of the selected point and asks first.
Arrange / Cluster	Repositions linked points or separates point types for review.
Save / Open-Switch vault / Merge vault	Saves the sidecar or selects and combines vault data.
Reload / Open folder	Reloads vault files or opens their folder for inspection.

Using this node

Create folders and factual points.
Link related points and arrange the canvas.
Connect Data Nexus to Task and review generated questions or slides before generating another draft.

skills

Local Skills library browser for human templates, agent templates, task guides, approval state, validation warnings, review diffs, and Sales Agent deck generation.

Inputs, parameters, buttons, and usage

Connections and result

Connect Mediator for template/guide creation and Data Nexus for generation. The skills output supplies the selected library asset to Task.

Parameters and options

Control	What it does
Library selection	Choose the human template, agent template, task guide, or agent guide to work with.
Version and approval state	Latest, active approved, draft, and deprecated entries describe different versions and readiness states.
Validation results	Check required metadata and referenced resources before using a template for generation.

Buttons and editing actions

Control	What it does
Refresh	Rescans the local Skills library.
Create Template / Create Guide	Uses Teacher Agent to derive an agent template from a human template, or a task guide from an agent template.
Generate Deck	Uses an approved Sales Agent template and connected Data Nexus to create an HTML deck.
Review Diff	Compares the selected version with the active approved or latest version.
Approve / Draft / Deprecate	Changes the selected asset’s lifecycle state.

Using this node

Refresh and select a template.
Review validation and the version diff before approving it.
Connect the selection and Data Nexus to Task, or generate a deck directly from the approved template.

task

Workflow step controller that reads Skills, Data Nexus, and optional Mediator AI; checks readiness, writes questions, generates drafts, refreshes HTML, and indexes slides.

Inputs, parameters, buttons, and usage

Connections and result

Connect skills, data_nexus, and optionally mediator. The node exposes status, questions, and artifact outputs for the task workflow.

Parameters and options

Control	What it does
Task status	Set Draft, Approved, Dismissed, or another supported workflow state; this is separate from merely generating a draft.
Template and task guide	The selected Skills assets define the instructions and expected output.
Questions and report	Inspect missing facts, refinement questions, and readiness feedback before the next step.
Artifact	The latest generated output can feed an HTML Preview path input.

Buttons and editing actions

Control	What it does
Run Step	Checks connected assets, facts, and Mediator readiness.
Write Questions	Writes preparation/refinement questions into Data Nexus without generating a deck.
Generate Draft	Asks the Sales Agent to create or update deck copy and indexes the resulting slides.
Refresh HTML	Rebuilds the current deck using the latest style without rewriting its copy.
Index Slides	Reads the existing deck and creates or updates its Data Nexus slide points.

Using this node

Choose an approved Skills template and add supporting facts to Data Nexus.
Run Step and answer outstanding questions.
Generate Draft, review it in HTML Preview, and then set the appropriate task status.

librarian

Document indexing, search, summarize, and analysis.

Inputs, parameters, buttons, and usage

Connections and result

The query, docs_dir, mode, top_k, and action inputs configure retrieval or analysis. Connected text takes priority over the corresponding local value.

Parameters and options

Control	What it does
query	Question or search text. Note and Append can provide longer queries.
docs_dir	Directory containing the documents to work with.
mode	Choose tree_summarize, the default, or compact for the Librarian response-synthesis mode.
top_k	Limits the number of retrieved results used by the operation; default 5.
action	Supports search, analyze, analyze_with_sources, summarize, and summarize_with_sources.

Buttons and editing actions

Control	What it does
Search	Retrieves material matching the query.
Analyze	Requests analysis of the query and available document context.
Analyze (with Sources)	Requests an analysis that includes source references.

Using this node

Configure the document folder and Librarian service.
Connect query text or enter it locally.
Search first to check coverage, then analyze with sources when you need traceable support.

Automation, Voice, and Control

voice_actor

Speech-to-text and text-to-speech node with Auto Respond, Ask First, and Manual send modes.

Inputs, parameters, buttons, and usage

Connections and result

text supplies speech content; audio can receive Audio Capture. The text output carries recognized speech to Chatbot, Translator, or Mediator.

Parameters and options

Control	What it does
Voice → Text / Text → Voice	Switch between recognition and speaking. Some connected automatic response sources force Text → Voice.
Parameter selector	Chooses the connected parameter to speak when several text values are available.
Voice / M-F / Lang	Choose an installed or configured voice, applicable gender selection, and recognition/voice language. Availability depends on the installed speech backend.
STT	Select the recognition engine; local Whisper and Google have different dependencies.
Send mode	Auto Respond sends after speech pauses. Ask First confirms before sending. Manual sends when Stop is pressed. Connected live capture can stream queued transcript chunks.

Buttons and editing actions

Control	What it does
Listen / Speak	Starts the operation for the current mode; the same main control can replay the latest automatic response.
Pause / Send	Pauses listening or sends the transcript, depending on the active send mode.
Replay / Undo	Replays spoken output or undoes the last transcript chunk in the applicable mode.
Stop / Clear	Stops the active operation or clears the transcript when idle. In Manual recognition mode, stopping sends the transcript.

Using this node

Choose the mode, language, and speech backend.
For captured system audio, connect Audio Capture to audio.
Listen and inspect the transcript, or connect text and test Speak.

audio_capture

Capture output-device, input-device, or application audio with source, backend, sample-rate, threshold, silence, and phrase controls. Continuous streaming supports buffered speech recognition, exclusion of Qubit Field playback, and Test & Listen monitoring.

Inputs, parameters, buttons, and usage

Connections and result

The audio output supplies captured audio to Voice Actor or another compatible audio consumer. This node chooses the source; the consumer starts ongoing capture.

Parameters and options

Control	What it does
Source / device / application	Choose output-device audio, an input device such as a microphone, or application audio, then select the relevant device/process.
Backend	Select the capture backend; auto lets the node choose.
Sample rate	Capture sampling rate; default 16000 Hz.
Threshold	Audio level used to identify speech/activity; default 0.012.
Silence / phrase duration	Silence ends a phrase; maximum phrase length bounds a chunk. Defaults are 850 ms silence and 20000 ms maximum phrase duration.
Live	Keeps capture waiting for speech and breaks long speech into shorter live chunks.
Exclude QubitMCP audio (all outputs)	Captures other applications while excluding this app’s speech and test playback. It ignores the output-device selector and needs supported Windows process-loopback capture. Restart listening after changing it.

Buttons and editing actions

Control	What it does
Refresh	Reloads available capture sources.
Test & Listen	Records three seconds, reports its level, then plays the sample after recording has stopped.

Using this node

Select a source and run Test & Listen.
Adjust the level threshold if the sample is too quiet or noisy.
Connect audio to Voice Actor and start listening there.

The level meter is in dBFS: 0 is full scale and more negative values are quieter.

translator

Translate incoming text or voice transcripts with language, style, and automatic translation controls.

Connect: Send text to text and connect an llm_prompt node to the matching input to choose the provider and model. The translated result leaves through text and can feed a Voice Actor for speech.

Use: Select From and To languages, choose Natural or Literal style, and enable Auto for new incoming text or click Translate manually.

Inputs, parameters, buttons, and usage

Connections and result

Connect text to text and LLM Prompt to llm_prompt. The text output carries the translation, for example into Voice Actor.

Parameters and options

Control	What it does
From / To	Source and target languages; automatic source detection and Mandarin Chinese are the initial settings.
Style	Natural favors fluent wording; Literal stays closer to the source construction.
Auto	Translates new incoming text automatically when enabled.
Model settings	Provider, credentials, and model come from the connected LLM Prompt node.

Buttons and editing actions

Control	What it does
Translate	Runs a translation manually with the current text and language settings.
Debug control	Writes Translator diagnostics for troubleshooting.

Using this node

Configure LLM Prompt and connect it.
Choose From, To, and Style.
Enter or connect text and Translate before enabling Auto.

openai_realtime_translate

Translate live microphone speech with spoken output and a live translation transcript.

Setup: Enter an OpenAI API key, select the model and voice, and set the source and target languages. This node captures microphone audio directly and requires the PyAudio and websockets dependencies.

Use: Click Listen to begin. Configure bidirectional translation or add a second language route, and adjust the silence interval for speech turns. The node exposes audio and text outputs.

Inputs, parameters, buttons, and usage

Connections and result

Captures the microphone directly and exposes audio and text outputs. It requires the node’s realtime connection and microphone dependencies.

Parameters and options

Control	What it does
API key / model	Configure access to the realtime model used by this node.
Source / target language	Choose the language route; initial settings are English to Mandarin Chinese.
Bidirectional	Allows the configured language pair to translate in both directions.
Second route	An additional source/target language route can be added.
Voice	Select marin or cedar in the node’s voice control.
Silence	Sets the speech-turn silence interval; initial value is 500 ms.

Buttons and editing actions

Control	What it does
+	Adds another language route.
Listen / Stop	Starts or ends live microphone translation.

Using this node

Configure credentials, model, and a language route.
Set the silence interval to suit speech pauses.
Press Listen and monitor the transcript and spoken translation.

minimax_tts_api

Generate speech audio from text through the MiniMax Speech API.

Connect: Feed the text input or enter text in the node. Connected text takes priority. Supply a MiniMax API key and choose a speech model and voice ID, including a custom voice ID when available.

Controls: Set speed, volume, pitch, output format, sample rate, and output folder. The generated file is available through audio and audio_path for playback or downstream audio effects.

Inputs, parameters, buttons, and usage

Connections and result

Connect text or type it in the node. A connected input overrides typed text. audio and audio_path expose the generated result.

Parameters and options

Control	What it does
Model / voice ID	Choose the speech model and voice. Custom or cloned voice IDs can be entered.
API key / base / endpoint / timeout	Configure the speech service connection. The node’s endpoint default is /v1/t2a_v2 and timeout is 120 seconds.
Speed / volume / pitch	Adjust delivery speed, loudness, and pitch shift. Initial speed and volume are 1; pitch shift is 0.
Format / sample rate / bitrate / channels	Choose output encoding. Supported format choices include MP3, WAV, and FLAC.
Output folder / history	Choose where generated files are saved and select an existing result to replay.

Buttons and editing actions

Control	What it does
Generate	Requests speech for the current text.
Play / Stop	Plays or stops the selected audio file.
Refresh	Refreshes generated-file history.
Open	Opens the output location.

Using this node

Enter credentials and select a model/voice.
Generate a short text sample and play it.
Connect the audio path downstream once its format and sound are suitable.

mediator_agent

Agent profile layer and technical executor for direct voice workflows, Chatbot-origin tool handoff, and Sales Agent AI task review.

Inputs, parameters, buttons, and usage

Connections and result

Inputs include voice_input, chatbot_history, system_prompt, data_nexus, and sandbox. The selected agent profile interprets requests and coordinates the supported tools.

Parameters and options

Control	What it does
Agent profile / system prompt	Choose the role and instructions used to interpret incoming work.
Command entry	A manual command for the agent instead of waiting for connected input.
Auto	Processes fresh incoming work automatically; disabling it lets you inspect inputs first.
Sandbox connection	Supplies the configuration for supported coding-tool execution.
Output/log view	Shows progress, responses, and failures so the requested action can be reviewed.

Buttons and editing actions

Control	What it does
Run Cmd	Processes the manually entered command.
Process Inputs	Processes the current connected input context.
Stop	Stops the current operation.
Clear / Open Folder	Clears the displayed log or opens the agent working/output folder.
Approval dialogs	Grant/Deny and deletion approval controls are presented for actions requiring a decision.

Using this node

Select the agent role and connect its required context.
Process a simple request manually and inspect the result.
Enable Auto when incoming work should be handled as it arrives.

codex_sandbox

Configure the local coding runner used by Mediator, including account, model, sandbox, approval, working directory, network, and output capture settings.

Inputs, parameters, buttons, and usage

Connections and result

Connect this configuration node to Mediator’s sandbox input. It supplies the local coding runner settings; it is not a standalone prompt/chat node.

Parameters and options

Control	What it does
Runner / executable / Codex Home / account profile	Choose how the local CLI is launched and which account state it uses.
Model / reasoning effort	Select the configured coding model and effort for the runner.
Sandbox mode / approval policy	Controls the runner’s filesystem mode and when it requests approvals.
Project root / working directory / writable roots	Set the project context, execution directory, and additional permitted write locations.
Network access / output capture	Choose network and captured-output behavior supported by the runner.
Advanced / extra arguments	Exposes CLI paths, roots, and additional runner arguments.

Buttons and editing actions

Control	What it does
Detect CLI	Searches common installation locations and PATH for the executable.
Status	Checks login status using the selected CLI and home.
Login / Logout	Signs in through a terminal or logs out of the selected account state.
Browse controls	Choose the relevant executable and directory paths.

Using this node

Detect the CLI and check Status.
Set project paths and the runner policy you intend to use.
Connect it to Mediator before running a coding request.

qubit_deck_controller

List or execute Qubit Deck actions from manual fields or Mediator JSON.

Inputs, parameters, buttons, and usage

Connections and result

Use manual fields or connect Mediator JSON to mediator_input. The controller sends requests to the configured Qubit Deck API.

Parameters and options

Control	What it does
API base	Address of the running Qubit Deck API.
Button / button name / slot	Identify the button to resolve or invoke; inspect the returned label/thumbnail to confirm it.
Action	Select the supported request, such as invoke, highlight, context listing, or health check.
Mode	Choose the controller/executor behavior offered by the node; executor accepts structured requests.

Buttons and editing actions

Control	What it does
Run Action	Sends the selected action with the current target fields.
Invoke	Invokes the resolved deck button.
Open Debugger	Opens the deck debugging interface.

Using this node

Point API base at the running deck service.
Resolve the target by name or slot and inspect its preview.
Invoke the button or connect Mediator requests for automated control.

keyboard_sequence

Keyboard Auto Runner for timed key/action sequences with lead-in, hold time, delays, and injection mode.

Inputs, parameters, buttons, and usage

Connections and result

Runs a sequence of keyboard, mouse, text, delay, and loop actions. A connected Serial COM/Pico path can provide supported hardware injection.

Parameters and options

Control	What it does
Action type / key / text	Choose what each step does. Key/text lists can supply a different value on each loop pass.
Lead-in / key hold / delay after	Sets the time before execution, how long keys remain pressed, and pauses between actions.
Delay tags	Named delays can be reused for action delays and hold times.
Mouse target / X / Y / button / click time	Configure a captured click location and whether coordinates are tied to a window.
Loop ID / run count / conditions	Controls repeated blocks and actions restricted to particular loop passes.
Injection mode	Select the supported key-injection method for the target application.

Buttons and editing actions

Control	What it does
Add / Insert / Remove Action	Edits the action sequence; insertion uses the selected position.
Make Loop	Creates loop start/end blocks around a selection or at the end.
Add Delay Tag	Edits shared timing values.
Capture Click	Captures the target used by a mouse action.
Run Sequence / Stop	Starts or stops execution.
Load JSON / Save JSON / Copy output log	Loads or saves the action list and copies the execution log.

Using this node

Build a short sequence and set a lead-in long enough to focus the target.
Test the sequence, checking key holds and mouse coordinate mode.
Add loops and shared delay tags after individual actions work.

serial_com

Stores COM port, baud, and timeout settings for serial/Pico HID automation paths.

Inputs, parameters, buttons, and usage

Connections and result

Stores the serial connection used by supported keyboard/Pico automation. Select the correct device before downstream hardware actions.

Parameters and options

Control	What it does
Port	The COM device to communicate with.
Baud	Serial communication speed; it must match the device firmware.
Timeout	How long to wait for a response before the request is treated as timed out.

Buttons and editing actions

Control	What it does
Refresh	Rescans available COM ports.
Ping	Checks communication with the selected device.
Install pyserial / Copy Command	When the dependency is absent, install it through the app or copy the provided command.

Using this node

Connect the device and Refresh.
Select its COM port and matching baud/timeout.
Ping before using it with Keyboard Sequence.

3D, Rigging, and Scene Processing

Look At

look_at

Aim or constrain a scene object to another object or a skeleton joint.

Use and connections: Connect an object, choose the target owner, and configure aim/up axes, look-at or copy-rotation mode, position matching, offsets, and live updating. Use joint targets for camera or object tracking in character scenes.

Workflow guide →

Inputs, parameters, buttons, and usage

Connections and result

Connect the object to constrain to object and send its object output into Scene. In Scene, assign an object or skeleton joint as the target owner.

Parameters and options

Control	What it does
Target owner	Drag an object or joint into the Scene target row, or use a joint path such as Character/Skeleton/Head.
Aim axis / Up axis	Choose the object’s forward and up axes; defaults are −Z and Y.
Rotation mode / Match rotation	Use look-at aiming or copy-rotation behavior and choose whether rotation is applied.
Match position / Position axes	Enable positional following and choose the affected X/Y/Z axes.
Maintain offset / Position offset	Preserve the existing positional relationship or apply the stored offset.
Live update	When enabled in Scene, follows viewport target movement immediately; otherwise updates on timeline frames and Scene rebuilds.

Buttons and editing actions

Control	What it does
Scene target and live controls	Assign the target and toggle live updating in the Scene outliner. This node does not have a separate generation step.

Using this node

Connect a camera or other object through Look At to Scene.
Assign the target object or joint.
Check the aim/up axes and enable only the rotation/position behavior you need.

Animation Blend

animation_blend

Build a transition from a character bind pose into a skeletal animation, useful for settling a garment before motion begins.

Use and connections: Connect the character to bind_pose and a compatible animation to animation. Set blend frames, hold frames, FPS, and curve; enable the target-frame option to start from a later pose. Send the animation output to Scene or the cloth collider path. Retarget incompatible rigs first.

Workflow guide →

Inputs, parameters, buttons, and usage

Connections and result

Connect a character reference pose to bind_pose and a compatible animation to animation. Send the animation output to Scene or an animated cloth collider path.

Parameters and options

Control	What it does
Blend frames	Transition length from the starting pose to the animation; default 30 frames. Zero skips the transition.
Hold pose frames	Keeps the starting pose before blending, useful for letting cloth settle; default 0.
Use target frame / Target frame	Overrides the animation’s starting pose with a later frame; frame 0 is the first frame.
Frame rate	Used for durations and target-frame interpretation; default 24 FPS. Match the Scene timeline.
Blend curve	Choose Smooth for an eased transition or Linear for a constant-rate blend; the default is Smooth.

Buttons and editing actions

Control	What it does
View	Previews the resulting animation in the viewport.

Using this node

Retarget the animation first if it uses a different skeleton.
Connect the reference pose and animation.
Set a hold and blend duration, then View and scrub the transition.

Delete Joint

delete_joint

Remove selected joints from a derived FBX or BVH skeleton and preview the result.

Use and connections: Connect a supported rig to rig, choose Select joints, and inspect with View before using the result downstream. The derived rig leaves the imported source file intact.

Workflow guide →

Inputs, parameters, buttons, and usage

Connections and result

Connect the source rig to rig. The node produces a derived skeleton with selected joints removed, leaving the imported file unchanged.

Parameters and options

Control	What it does
Joint selection	Select joints in the skeleton list or preview before deleting/restoring them.
Removed joints	The saved selection records the joints excluded from the derived rig.
Preview	Inspect the resulting skeleton before connecting it to later rig processing.

Buttons and editing actions

Control	What it does
Select joints…	Opens the joint-selection editor.
Delete selected / Restore selected	Updates the exclusion set for the selected joints.
Restore all	Clears all joint exclusions.
View	Shows the modified skeleton in the main viewport.

Using this node

Connect an FBX/BVH rig and open Select joints.
Remove only the joints you intend to exclude.
View the result and verify downstream mapping before exporting.

Mocap Collection

mocap_collection

Organize BVH takes with an active output, Use checkboxes, Checked only filtering, and live preview. Load individual files or scan a folder recursively.

Use and connections: Use Update paths after moving source files. Load renders and Review renders associate visual reviews with takes; Rename and Archive manage BVH run folders and assigned render folders. Output a selected take to retargeting, or connect the collection to For Each for a render batch.

Workflow guide →

Inputs, parameters, buttons, and usage

Connections and result

The output supplies the active BVH take. Connect the collection to retargeting for one take or For Each for a render batch.

Parameters and options

Control	What it does
Use checkboxes	Mark takes eligible for checked-file processing; row selection alone does not change these checks.
Output index	Selects the active take. With Checked only enabled, it indexes the eligible list while the displayed path number identifies the original row.
Checked only	Restricts the output slider to checked takes, in list order.
Live view	Updates the viewport as the active output changes while retaining the current camera.
Render thumbnails	Assigned renders let you review a take visually before choosing it.

Buttons and editing actions

Control	What it does
Load BVH files / Load BVH folder	Adds individual files or scans a folder recursively; existing paths are skipped.
Remove / Update paths	Removes the active collection path or relocates selected files beneath a new parent folder.
Check all / Uncheck all / Select all	Changes eligibility checks or row selection; these are separate operations.
Load renders / Review renders	Associates generated renders and opens their review.
Rename / Archive	Renames the active BVH run folder and assigned render folders, or moves selected runs and renders into an archive.
View / Open in Explorer	Previews the active animation or opens its file location.

Using this node

Load a BVH folder and preview several takes.
Check the takes you want to process and enable Checked only.
Connect the collection to For Each and run a test render.

Rename and Archive operate on folders/files, not just the displayed list labels.

Animation Correction

animation_correction

Manually correct an animated BVH or FBX take with joint position and rotation keys and body or limb IK ranges. Save per-take drafts and export an approved corrected BVH.

Manual correction workflow →

Inputs, parameters, buttons, and usage

Connections and result

Connect an animated BVH or FBX source, Mocap Collection, or Rig Limiter to animation. The animation output supplies the clip with saved corrections to downstream nodes, including Scene and Anim Retarget. Scene displays the corrected skeleton; use Anim Retarget to apply it to a character mesh.

Controls and editing actions

Control	What it does
Preview / edit animation	Opens the input take in the 3D viewport. Select a joint in the viewport or embedded hierarchy, then scrub and pose it. The panel's ? button opens editing hints.
IK Controls / FK keying	Enables pelvis, chest, wrist, and ankle controls. Dragging previews a pose without creating keys. With IK off, select a joint and use Set key to key its local position or rotation; the selected timeline channels determine which axes are keyed. Local FK edits can also override an IK pose.
Start IK / End IK / Set key	Start and End bound an overwrite, marked S and E above the triangle keys and yellow between them. Set key adds intermediate IK poses inside a range. Select Px, Py, or Pz before Start to limit the target coordinates; separate position axes can overlap in time and share boundary frames. Clear the channel selection for full IK keying, including chain rotations.
Join IK ranges (Fuse icon)	Between Start IK and End IK. Select an End and the next Start on the same control with matching channels and limb-lock settings; the right range must have its End. Joining fills the gap and keeps both selected keys as intermediate poses. The button is disabled and desaturated without a valid selection. Also available by right-click or Ctrl+J.
Show colliders	Displays body and hand capsule guides when the input rig supports them. A Rig Limiter input supplies its saved limits and volumes.
Reload all / selected joint / selected axes	With no joint selected, restores the entire input take, including IK and regular edits. With a joint selected, restores that joint and removes IK ranges driving it. Select timeline channels to restore only those axes across the take. The reset is saved to the draft immediately and can be undone in the current session.
Save draft	Saves corrections beside the source as `.bvh.animation_correction.json` or `.fbx.animation_correction.json`. Keyframe actions and Reload also save the draft. Saved corrections are tied to the source take and base clip; changing the base animation can invalidate them.
Approve & export BVH	Saves the draft and writes a uniquely named `_corrected_` BVH beside the source. Keeps the original animation and records the approved export.

Using this node

Select a collection take and, if using Rig Limiter, finish its automatic repair first.
Open Preview / edit animation, scrub to the affected frames, and adjust joints or key an IK range.
Save the draft, review the motion, then approve and export or pass the saved corrected animation to Scene or Anim Retarget.

Use Settings > Joint names to display joint labels. Undo and redo restore correction edits; a viewport drag is one undo step. Drafts remain specific to each source take; save the current edits before changing previews. Unkeyed IK previews are not included in drafts or BVH exports. Use the timeline curve editor to fit or frame keys, pan and scale the graph, edit tied or independent handles, and expand or detach the panel.

Rig Limiter

rig_limiter

Repair existing PriorMDM/HumanML animation with joint limits and optional body/finger collision correction. Preview a derived clip or export new BVHs without replacing the source files.

Repair workflow →

Inputs, parameters, buttons, and usage

Connections and result

Connect a compatible Mocap Import or Mocap Collection to animation. The animation output supplies a corrected skeleton clip to Anim Retarget, Animation Blend, Transforms, Animation Correction, or Scene. It preserves root motion, timing, and bone lengths; it does not output a skinned character mesh.

Use the original PriorMDM/HumanML joint names, hierarchy, and rest axes, with fixed bone lengths and no bone scaling. Apply this node before retargeting. Supported finger joints are processed when present.

Parameters and options

Control	What it does
Correct capsule intersections	Enables contact correction between the tapered body, palm, and finger volumes when IK repair is also enabled. Enabled initially.
IK repair	Attempts constrained finger adjustments before arm correction, and supports limb contact repair. Disable it to apply only bend/twist limits. Enabled initially.
Thorough repair (slower)	Spends more time resolving between-frame contacts. Off by default for fast repairs. Both modes report unresolved contacts.
Bend / Twist or Spread	Select joints in the preview to edit the supported angular ranges, including finger bending and base spread.
Capsule radius: Start end / Far end	Sizes each end independently in input rig units. Pick joints or capsules to inspect the matching controls. Foot capsules run from ankle to foot; select the ankle to adjust them in either Preview Rig or Rig Limiter.
Collision preview (blocks rotations)	Shows collision volumes and stops manual rotations at contact. Save the preview panel to store its limits, radii, and collision option on this node.

Buttons and editing actions

Control	What it does
Preview	Opens the current source or available repaired clip without running a repair. Inspect joints and adjust limits and capsule volumes in the preview panel.
Repair	Turns red when the input or saved settings need repair. For a connected BVH import or collection, checks for matching saved repairs in the background as the path or settings change, without requiring Preview. Click to calculate with progress/cancellation controls and report corrected frames, finger capsules, arm IK adjustments, and remaining overlap.
Export corrected BVH	Requires an up-to-date Repair result, then writes it to a chosen folder with a unique `_limited_` filename. Preserves hierarchy, root motion, timing, and End Sites.
Export checked collection	Requires a directly connected Mocap Collection. Repairs its checked takes into new files while preserving collection entries and source BVHs. Completed files remain if the batch is interrupted.
Save in the preview panel	Stores this node's joint limits, capsule radii, and collision option without repairing the animation. Save the graph to persist them. The previous repair stays visible until you click Repair again; compatible saved BVH repairs are restored when their source and settings still match. Otherwise the source is shown until repaired.
Reset limits and volumes	Restores the default limits and capsule sizes. Run Repair again to apply them.

Repair progress includes solving and saving the corrected BVH. Stop, Escape, or closing the progress dialog requests cancellation. Matching saved repairs can be recovered after reopening the workflow without recalculating; compatible repairs saved by earlier versions are also recognized when their source and settings match.

Using this node

Connect an original PriorMDM/HumanML clip or collection before Anim Retarget.
Click Repair, then Preview to inspect body and finger contact, and adjust limits or capsule sizes as needed.
Review remaining overlaps, then connect the animation downstream or export the active/checked takes.

Capsules are collision approximations. Unreachable contacts remain reported instead of relaxing joint limits, stretching bones, or moving the root. Inspect the retargeted character mesh before cloth simulation or rendering.

PriorMDM

priormdm

Generate a humanoid motion take from text with duration, seed, guidance, and device controls. Preview the reconstructed BVH or add completed takes to a Mocap Collection.

Use and connections: Run Setup PriorMDM and configure its runtime/model paths. Preview Rig exposes bend/twist limits and collision guides. Optional Animate Hands uses a separate Setup HandMDM runtime, side, description, time window, and blend controls. Finger and palm retargeting remain preview features.

Workflow guide →

Inputs, parameters, buttons, and usage

Connections and result

Generates a BVH motion take from text. Completed results can become MocapBVH nodes or entries in Mocap Collection.

Parameters and options

Control	What it does
Prompt / Duration	Describe the movement and requested clip length; initial duration is 5 seconds.
Seed / Guidance	Seed controls repeatability for the same setup; guidance changes how strongly generation follows the text. Initial values are 42 and 2.5.
Device	Choose cuda:0 or cpu according to the configured runtime.
Preview proportions	Changes the exported preview proportions while preserving original motion data. Reference proportions can require foot/contact cleanup.
Collision volumes / Joint limits	Choose which guides Preview Rig displays for inspection.
Add hand articulation / Hand / Hand description	Enables the separate HandMDM pass and chooses side and gesture text.
Gesture start / end / Blend	Limits the hand gesture’s time window and transition.
Advanced runtime paths	Set body/hand repositories, inference Python executables, checkpoints, normalization folder, download cache, and output folder.

Buttons and editing actions

Control	What it does
Setup PriorMDM / Setup HandMDM	Manages the separate body and finger-motion runtimes/checkpoints.
Generate / Stop	Starts generation or stops the current job.
Preview Rig	Displays the selected reference proportions and chosen rig guides.
Create MocapBVH / Add to Collection	Uses the last completed result downstream; changing options does not rewrite an already created BVH node.
Create T-pose BVH / Create A-pose BVH	Creates separate single-frame reference rigs using the last skeleton; A-pose lowers the arms by 45 degrees.
Open result folder	Opens the generated files.

Using this node

Set up the body runtime and generate a short prompt.
Preview the completed take and inspect the rig.
Add it to a collection for retargeting/rendering; configure HandMDM separately if hand motion is needed.

Preview Rig also exposes finger bend/spread limits, tapered capsule end radii, and Collision preview (blocks rotations). Its Save action stores limits and radii in application settings. Use Rig Limiter to repair an existing generated clip without running generation again.

Hand articulation and finger/palm retargeting remain preview features. Changing generation hand settings requires another generation.

import

Load mesh or splat assets.

Inputs, parameters, buttons, and usage

Connections and result

Loads an asset file for the viewport or downstream geometry/splat processing. Use FBX Import or Mocap Import when you need their rig-specific validation.

Parameters and options

Control	What it does
File path	Choose the mesh or Gaussian-splat asset to load. Keep referenced files available when moving the workflow.
Asset summary	Check the resolved file and asset information shown in the node before sending it to Scene.

Buttons and editing actions

Control	What it does
File and viewport controls	Use the path/file picker to choose the asset and the app’s viewport controls to inspect it. Import is a source node, not a conversion job.

Using this node

Choose an existing asset file.
Inspect its resolved path and preview.
Connect it to Scene, Modeler, or the appropriate processing node.

fbx_import

Ingest and validate FBX rest geometry, capture pose, and animated pose roles for rigging workflows.

Inputs, parameters, buttons, and usage

Connections and result

The rest_geometry, capture_pose, and animated_pose roles describe the mesh/rest data, rig capture pose, and animation source. The validated result feeds retargeting, Scene, or rig-aware processing.

Parameters and options

Control	What it does
Rest geometry	Source used for the rest mesh and skinning information.
Capture pose	Reference skeleton pose used to interpret the skin binding.
Animated pose	Source of the animated rig; validation checks compatibility with the other roles.
Skin Weight Colors	Colors the mesh by joint influence for skinning inspection.
Show Capture Joints / Show Animated Joints	Overlays the corresponding skeletons on the mesh.
Debug logging	Enables additional diagnostic information when investigating an import.

Buttons and editing actions

Control	What it does
Validate FBX Sources	Resolves the three roles and reports compatibility problems.
Setup FBX SDK	Installs or configures the runtime required for full FBX support.
View	Displays the validated import in the viewport.
Copy Report	Copies the complete validation report.

Using this node

Provide the required FBX roles.
Validate and resolve missing-runtime or incompatible-rig errors.
View with the joint/weight overlays before retargeting or exporting.

fbx_animation

Import an FBX animation clip with skeleton validation and a viewport preview.

Use: Choose an FBX in path, click Validate FBX Anim, and inspect the clip and skeleton summary before previewing it.

Connect: Feed the node into fbx_import through animated_pose for animation or capture_pose for a capture source, or connect it to Scene for playback. The Create Node name is fbx_animation; fbx_animation_import is an alias.

Inputs, parameters, buttons, and usage

Connections and result

Reads skeleton animation from an FBX path. Use its animation as a retargeting source or inspect it independently.

Parameters and options

Control	What it does
Path	FBX file containing the skeleton/animation to load.
Resolved path	Shows the file actually used after resolution.
Clip and skeleton report	Lists the parsed hierarchy and animation information; inspect it before choosing the take downstream.
Debug logging	Adds diagnostics for parsing and validation.

Buttons and editing actions

Control	What it does
Browse FBX	Chooses the source file.
Validate FBX Anim	Parses the skeleton hierarchy and animation clips.
View	Opens the animated skeleton wire preview.
Copy Report	Copies validation details.

Using this node

Browse to an animated FBX.
Validate it and check its clip/skeleton report.
View the animation before connecting it to retargeting.

genx_video_mocap

Run GEN-X/GEM-X video mocap and create downstream BVH import nodes.

Inputs, parameters, buttons, and usage

Connections and result

Processes source video through the GEN-X/GEM-X runtime and creates a downstream MocapBVH node from the generated result.

Parameters and options

Control	What it does
Source video	Video file whose subject motion should be reconstructed.
Output folder	Root location for generated results.
Rig export	Choose SOMA BVH or Unitree G1 according to the downstream rig requirement.

Buttons and editing actions

Control	What it does
Browse controls	Choose the input video and output directory.
Open Full UI	Opens the GEM-X Qt launcher for the complete runtime interface.
Run	Runs reconstruction and creates a MocapBVH node when a BVH result is available.

Using this node

Set up the GEN-X runtime and choose a source video.
Choose the export rig and output folder.
Run, then validate and preview the generated mocap before retargeting.

mocap_import

Import and validate BVH mocap clips with skeleton, frame, and clip summaries.

Inputs, parameters, buttons, and usage

Connections and result

Loads a BVH skeleton and motion clip for retargeting, collections, or viewport inspection.

Parameters and options

Control	What it does
Path	The input BVH file.
Resolved path	The file used after path resolution.
Skeleton / frame / clip summary	Inspect joint count, hierarchy, duration, and motion information after validation.
Debug logging	Enables additional diagnostics for the file reader.

Buttons and editing actions

Control	What it does
Browse BVH	Selects a mocap file.
Validate BVH	Parses its hierarchy and motion data.
View	Shows the animated skeleton in the viewport.
Copy Report	Copies the validation report.

Using this node

Browse and validate a BVH.
View the motion and check its frame information.
Connect the validated source to Anim Retarget or another animation consumer.

anim_retarget

Connect a mocap/FBX source to a target FBX rig with joint mapping, root controls, pose offsets, preview options, and rig bend/twist constraints. Preview and adjust the rig before exporting or using it as an animated cloth collider. Retargeting guide.

Inputs, parameters, buttons, and usage

Connections and result

Connect source and target rig contexts and the intended animation to the node’s matching ports. The output drives the target rig; validate both rigs before mapping.

Parameters and options

Control	What it does
Joint map	Pairs source joints with target joints. Check left/right limbs, spine, and root correspondences.
Root source / Root target / Scale mode	Choose the root pair and how source motion is scaled to the target; initial scale mode is auto.
Rotation mode	Controls how source joint rotations transfer; initial mode is copy_global_delta.
Pelvis constraint	Select a source/target pelvis pair independently of ordinary mappings. Snap matches position; Position Offset preserves the target’s positional offset while following aligned rotation.
Target pose offsets	Adjust the target reference pose joint by joint. These correct alignment before motion is applied.
Joint display size / curve thickness	Changes inspection handles and skeleton line visibility.
Animate Source and Target Skeletons	Previews source motion and its retargeted target; disable to inspect reference poses.
Rig limits and collision guides	Use the rig preview controls to inspect and adjust bend/twist constraints before cloth or final output.

Buttons and editing actions

Control	What it does
Use Mapping Row	Sets the pelvis constraint pair from the selected mapping row.
Reset Joint / Reset All	Clears pose-offset adjustments for one joint or the entire target.
Validate	Checks the source and target connections.
View / Copy Report	Opens the source/target preview or copies validation results.

Using this node

Validate the source animation and target FBX rig.
Map corresponding joints and align their reference poses.
Preview several frames, then use the retargeted rig in Scene or as a cloth collider.

camera

Scene camera placement/control node.

Inputs, parameters, buttons, and usage

Connections and result

Connect the Camera to Scene. Its placement is edited in the Scene outliner/viewport, rather than camera-node position parameters.

Parameters and options

Control	What it does
FOV	Field of view in degrees; initial value 60. Wider values show more of the scene.
Aspect width / height	Defines the camera frame ratio; initial values 1920 × 1080. This is framing information, not a render-completion action.
Scene transform	Move and rotate the camera in Scene to establish the shot.

Buttons and editing actions

Control	What it does
Scene camera controls	Select and position the camera using Scene and viewport controls. There is no separate camera generation button.

Using this node

Connect the Camera and visible assets to Scene.
Choose the frame aspect and FOV.
Position the camera and confirm the shot before configuring Render.

light

Directional, point, spot, and area light setup with intensity, range, and shadow parameters. The node picker also offers directional_light, point_light, spot_light, and area_light presets.

Inputs, parameters, buttons, and usage

Connections and result

Connect the light to Scene and use the Scene transform controls for placement and orientation. The node picker also provides directional, point, spot, and area presets.

Parameters and options

Control	What it does
Type / Intensity	Choose the light type and brightness; initial intensity is 1.
Range	Controls the light’s reach where applicable; initial value 300.
Width / Height	Area-light dimensions, initially 1 × 1.
Shadow strength	Controls the darkness/contribution of the light’s shadow.
Shadow range / FOV / resolution / bias	Advanced shadow settings used by the relevant light/render path. Zero-valued overrides use the renderer’s applicable defaults.
Placement	Position and rotation belong to the Scene outliner, not this node.

Buttons and editing actions

Control	What it does
Type and parameter editing	Edit the light’s parameters and inspect the scene. This node does not require a separate bake/run action.

Using this node

Choose a light preset and connect it to Scene.
Place it and tune intensity/range.
Adjust shadows only after the basic illumination and scene scale are correct.

instance

Create repeated scene instances.

Inputs, parameters, buttons, and usage

Connections and result

Connect a source mesh to mesh. The result supplies repeated instances to Scene.

Parameters and options

Control	What it does
Count	Number of copies; initial value 3.
Prefix	Optional naming prefix for the generated instances.
Mesh	The source geometry to repeat. Its resolved path is managed from the connection.

Buttons and editing actions

Control	What it does
Parameter editing	Change Count and Prefix, then inspect the result in Scene; the node has no independent generation dialog.

Using this node

Connect a source mesh.
Set a small count and useful naming prefix.
Add the result to Scene and arrange the instances as needed.

copy_to_points

Copy source geometry onto point inputs with instancing and material/texture support.

Inputs, parameters, buttons, and usage

Connections and result

Connect the placement geometry to points and the geometry to duplicate to copy.

Parameters and options

Control	What it does
Match Normal	Rotates each copy so its local up axis follows the target point normal.
GPU Instances	Draws the source mesh using per-point transforms. This is faster to render but does not create baked per-copy vertex ranges. Enabled initially.
Pack	In baked mode, records each copied mesh range so later per-copy effects can deform it. It does not add those ranges to GPU instances.

Buttons and editing actions

Control	What it does
View	Displays the copies on the target points.

Using this node

Connect target points and source geometry.
Enable Match Normal if orientation should follow the surface.
Use GPU Instances for drawing efficiency, or baked mode with Pack when later deformation needs per-copy ranges.

primitive

Generate procedural primitive geometry.

Inputs, parameters, buttons, and usage

Connections and result

Creates basic geometry that can feed Scene, Transforms, materials, or geometry-processing nodes.

Parameters and options

Control	What it does
Shape	Choose Sphere, Plane, Cube, Cone, Tube, or Torus.
Placement and scale	Use Transforms or Scene to position and resize the generated shape; the compact primitive selector is not a full modeling editor.

Buttons and editing actions

Control	What it does
View	Generates/resolves the selected primitive and previews it.

Using this node

Choose a shape and View it.
Connect it to Transforms or Scene.
Apply materials or further geometry processing downstream.

curve

Create line, circle, or spiral curve scene assets.

Inputs, parameters, buttons, and usage

Connections and result

Creates a procedural curve asset for Scene and compatible point/curve workflows.

Parameters and options

Control	What it does
Curve type	Choose Line, Circle, or Spiral.
Generated points	The selected preset supplies the curve points and line segments used downstream. Use Scene transforms to place the curve.

Buttons and editing actions

Control	What it does
View	Displays the selected curve in the viewport.

Using this node

Choose a curve type.
View its point/line layout.
Connect it to the curve-processing or placement workflow you need.

modeler

Inspect model object names, hide/isolate submeshes, and save object/point/edge/face selection groups.

Inputs, parameters, buttons, and usage

Connections and result

Connect mesh to inspect its submeshes and create named groups from object, point, edge, or face selections.

Parameters and options

Control	What it does
Viewport selection mode	Choose the element type before selecting geometry; the group records that selection type and its element IDs.
Selection groups	Stores named selections for reuse on the model.
Submesh visibility	Eye controls show or hide objects in the outliner without deleting their source geometry.

Buttons and editing actions

Control	What it does
View	Displays the connected mesh for selection.
Group Selection	Creates a Modeler group from the active viewport selection.
Isolate Selected	Restricts the visible content to the selection.
Show All	Restores visibility for the model’s objects.

Using this node

Connect a mesh and View.
Choose point/edge/face/object mode and select elements.
Group Selection to preserve the selection, then isolate it to check coverage.

transforms

Apply translate/rotate/scale offsets in-chain.

Inputs, parameters, buttons, and usage

Connections and result

Connect the incoming geometry to mesh. The result carries the selected transform or its baked geometry downstream.

Parameters and options

Control	What it does
Position	X/Y/Z translation; initial 0,0,0.
Rotation	X/Y/Z rotation; initial 0,0,0.
Scale	X/Y/Z scale factors; initial 1,1,1.
Auto bake	Controls whether changes are baked automatically; initially disabled.
Source / path	Identifies the resolved input and processed geometry path; the mesh connection supplies the source.

Buttons and editing actions

Control	What it does
View	Previews the transform on the connected asset.
Bake	Writes the transformed geometry for downstream use.

Using this node

Connect the mesh and adjust position, rotation, or scale.
View to confirm axes and proportions.
Bake when the next operation needs the transformed geometry rather than only its placement.

ply_sequence

Sequence playback/control for PLY streams and splat frame workflows.

Inputs, parameters, buttons, and usage

Connections and result

Connect a mesh/PLY source or choose the first frame manually. The node resolves a sequence for animated viewport playback.

Parameters and options

Control	What it does
Source	The first PLY frame. A connected source takes precedence and disables manual browsing.
Enabled	Enables sequence behavior.
Loop	Repeats the sequence during playback; initially enabled.
Follow Cam	Enables the sequence’s follow-camera behavior; initially disabled.

Buttons and editing actions

Control	What it does
Choose file	Selects the first frame when no input drives the source.
Reload file	Reloads the selected source sequence.
View	Opens the sequence in the viewport.

Using this node

Select the first frame of a consistently named PLY sequence.
Reload and View it.
Play the timeline and check Loop and Follow Cam for the intended shot.

image_gs_splat

Download a URL or local image, run Image-GS, preview the generated Gaussian result in the node, and output a viewport-ready PLY splat. Open detailed page.

Inputs, parameters, buttons, and usage

Connections and result

Provide an image URL or local image. The output is a viewport-ready Gaussian-splat PLY with generated preview/report files.

Parameters and options

Control	What it does
Generation mode	Exact Pixel exports a direct front-facing per-pixel splat sheet. Image-GS runs the optional optimization runtime.
Gaussians / Steps / Render height	Control optimization capacity, training duration, and image resolution. Increasing these can increase time and memory use.
Sheet scale / Radius scale / Alpha	Adjust the sheet’s size, splat footprint, and opacity.
Initialization	Choose gradient, saliency, or random initialization for optimization.
Auto HQ	Enables progressive error-guided training and quality settings based on source-image detail.
Quantize / Points	Controls the available quantization and Gaussian visualization options.
Advanced quality parameters	Progressive additions, loss ratios, axis limits, anisotropy, coverage, and exact-pixel limits refine output quality; use the detailed Image-GS guide for the full tuning context.

Buttons and editing actions

Control	What it does
Setup Image-GS	Installs or repairs the optimization runtime.
Browse / Generate	Chooses an image and creates the result in the selected mode.
View / Folder	Previews the splat or opens its files.
Stop	Stops active processing.
Debug report: Refresh / Copy / Open Logs	Updates, copies, or opens diagnostic output.

Using this node

Start with Exact Pixel to confirm the input and scale.
View the PLY in Scene.
For optimization, set up Image-GS and try Auto HQ before manual advanced tuning.

A single-image splat sheet is not a reconstructed, fully observed 3D object. The dedicated Image-GS guide remains available from this catalog.

scene

Assemble and manage multi-asset scenes.

Inputs, parameters, buttons, and usage

Connections and result

Collects connected assets, cameras, lights, rigged characters, cloth, and effects. Connect Scene to Render or an export node for delivery. Rig Limiter and Animation Correction outputs can connect directly: Scene resolves their processed animation and displays the skeleton clip. Save Animation Correction edits before rebuilding Scene; use Anim Retarget first when you need an animated character mesh.

Parameters and options

Control	What it does
Outliner / visibility	Select objects and use eye controls to show or hide them.
Position / Rotation / Scale	Transforms the selected scene entry; camera and light placement also lives here.
Hierarchy and skeleton rows	Inspect object children and skeletons; select joints for the relevant rig controls.
Look At target / live toggle	Assign an object or skeleton-joint target. Live follows viewport changes immediately; otherwise evaluation occurs on timeline frames and rebuilds.
Cloth arrangement	Move, rotate, and scale individual panels before simulating. Placement is saved with the workflow and changing it resets the cloth.
Cloth collider rows	Choose the meshes/owners that interact with the cloth. Multiple colliders can be added.

Buttons and editing actions

Control	What it does
View Scene	Builds and displays the assembled scene.
Visibility controls	Shows/hides selected scene entries.
Add / Remove collider	Changes the collider rows for a cloth object.
Browse skeleton joints	Lets you drag a target joint or double-click to copy its target path.

Using this node

Connect geometry, lights, and a camera, then View Scene.
Arrange objects and confirm visibility and animation.
Connect Scene to Render or an exporter and test a frame before a batch.

export_fbx

Export scene geometry to FBX.

Inputs, parameters, buttons, and usage

Connections and result

Connect Scene to scene. This exporter writes scene geometry to an FBX file; use Export FBX Animation for the rig/animation-specific workflow.

Parameters and options

Control	What it does
Output	Destination FBX file.
Include hidden	Includes hidden scene entries when enabled; initial value is on.
Triangulate (Unreal compatible)	Converts exported faces to triangles for the receiving application; initially off.

Buttons and editing actions

Control	What it does
Browse	Chooses the destination path.
Export FBX	Writes the connected scene geometry with the selected options.

Using this node

Check the Scene and its visibility.
Choose the output file and triangulation/hidden-object settings.
Export and inspect the file in the receiving application.

export_fbx_animation

Export validated FBX rigs with skeletons, skinned meshes, animation ranges, FPS, and optional joint-scale curves.

Inputs, parameters, buttons, and usage

Connections and result

Connect a validated rig context to source. The exporter writes skeleton, supported skinned meshes, and optional sampled animation.

Parameters and options

Control	What it does
Output	Destination FBX file.
Export animation	Includes the animated clip when enabled.
Start / End	Frame range to export; initial range 0–120.
FPS	Sampling rate for the exported animation; initial value 30.
Scale curves	Includes joint-scale animation; enabled initially. Disable only when the target does not support it.

Buttons and editing actions

Control	What it does
Browse	Chooses the output file.
Export FBX	Exports the rig and selected animation range.

Using this node

Preview and validate the rig or retarget result.
Set FPS and frame range to match the intended clip.
Export, then check skinning and motion in the destination application.

export_obj

Export to OBJ/MTL.

Inputs, parameters, buttons, and usage

Connections and result

Connect Scene to scene. Writes static geometry and related OBJ/MTL material information.

Parameters and options

Control	What it does
Output	Destination OBJ file.
Include hidden	Includes hidden scene entries when enabled; initially on.
Triangulate faces	Converts polygons to triangles during export; initially off.

Buttons and editing actions

Control	What it does
Browse	Chooses the destination.
Export OBJ	Writes the geometry with the selected visibility and triangulation options.

Using this node

Assemble and inspect the Scene.
Choose an output path and export options.
Export and keep associated material/texture files with the OBJ.

OBJ is a static geometry format; it does not preserve the skeleton animation workflow.

Mesh, Materials, and Grooming

Cloth Solver

cloth_solver

Simulate saved pattern panels with CPU or CUDA, sewing, elastic edges, stretch and bend controls, collisions, self collision, gravity, and pins.

Use and connections: Connect Pattern Design to pattern, an optional static/animated mesh to collider, and the result to Scene. Arrange panels, then Play or Step, or enable Simulate with timeline. Bake, Load cache, Save state, and Stop & save support reusable results and resuming a settled pose.

Cache behavior: Simulation-setting changes clear calculated timeline frames and unload outdated baked playback. Preview and rendering recalculate from the starting pose; saved drape inputs and files on disk are preserved.

Workflow guide →

Inputs, parameters, buttons, and usage

Connections and result

Connect a saved Pattern Design document to pattern, an optional static/animated mesh to collider, and cloth to Scene. Scene collider-owner rows can select additional collider meshes.

Parameters and options

Control	What it does
Enabled / Backend	Enable the solver and choose auto, cpu, or cuda. CUDA requires a compatible configured runtime.
Stretch stiffness / Bend stiffness	Resistance to stretching and folding. Higher stiffness generally needs adequate substeps/iterations to solve reliably.
Sew stiffness / Sew closure / Seam gap	Controls how strongly paired seams pull together, the closure duration in seconds, and the target separation in meters. A 1–2 second closure can pull seams together more gently around a body.
Surface density / Damping	Fabric mass per square meter and velocity damping. A density of 0.2 kg/m² is 200 g/m²; gravity acceleration is not reduced by choosing a lighter fabric.
Gravity / Gravity Y	Enable gravity independently of its stored strength. Earth gravity is −9.81 m/s².
Collision thickness / Friction	Surface clearance in meters and resistance to sliding. Try 0.003–0.005 m for body clearance; friction 0 is slippery.
Self collision / Ground plane Y = 0	Enable fabric-to-fabric contact or collision with the ground plane.
Collider owner	Drop Scene meshes into the owner field or use comma-separated owner names. Leave empty to use the collider input.
Mesh spacing / Scene units per meter	Mesh spacing is in millimeters; smaller spacing creates a finer cloth mesh. Use 1 for meter-scale scenes or 100 for centimeter-scale scenes.
Substeps / Constraint iterations / Collision quality	More solves/contact passes improve difficult motion at higher cost. The UI suggests 8 substeps for dressing, 16 for fast motion, and collision quality 4 as starting points.
FPS / Start frame / End frame	Sets standalone simulation timing and bake range. Timeline simulation uses the viewport timeline FPS.
Simulate with timeline	Playing or scrubbing simulates from the current or loaded starting pose and keeps calculated frames in memory. The cloth toggle beside FX changes this option for all solvers in the current view and stays synchronized with the node checkboxes. Toggling off/on preserves calculated frames; save the graph to persist the node settings.
Grab cloth with mouse	Allows interactive cloth manipulation in the viewport.

Buttons and editing actions

Control	What it does
Play / Stop / Step	Runs realtime settling or advances one solve step; in timeline mode, Step advances one animation frame and playback uses viewport controls.
Reset	Returns the cloth to its starting arrangement.
Pin selected points / Unpin selected / Clear pins	Uses viewport point selection to edit pins. Pin edits retain the current pose and recalculate subsequent frames.
Bake…	Calculates the Start–End range from the arranged pattern and saves an animation cache.
Load cache… / Clear cache	Loads saved pose/animation data or unloads it and returns to the arranged pattern.
Save state…	Saves pose, velocity, and sewing progress so simulation can resume later.
Stop & save	Stops baking after the current solve and saves completed frames.

Using this node

Save the pattern and arrange its panels around the collider in Scene.
Use a short Play/Step test to check scale, seams, and collisions.
Set the timeline/bake range and save a state or bake once the drape is suitable.

Changing simulation settings clears calculated timeline frames and unloads outdated baked playback. Preview/render recalculate from the starting pose; saved drape inputs and files on disk remain.

Pattern Design

pattern_design

Draft garment panels in an embedded canvas or Open Full Editor. Edit millimeter dimensions, points, cubic curves, linked mirrors, combined outlines, sewing pairs, and elastic edges.

Use and connections: Save a standalone .pattern.json document before using the pattern output. Closed, valid panels feed Cloth Solver or can be placed directly in Scene. The workflow references the pattern file; it does not embed unsaved edits or copy the pattern when saved.

Workflow guide →

Inputs, parameters, buttons, and usage

Connections and result

The pattern output references a standalone .pattern.json file. Connect it to Cloth Solver or Scene after saving valid closed panels.

Parameters and options

Control	What it does
Width / Height	Dimensions for new rectangle/trapezoid panels, in millimeters; initial dimensions are 300 × 400 mm.
Selected edge / curve handles	Choose an edge and edit its geometry. Cubic edges expose handles for smooth shaping.
Point and panel selection	Select points, edges, or panels for editing, moving, combining, or mirrored editing in the canvas/full editor.
Sewing pairs	Pairs panel edges so Cloth Solver can pull the corresponding boundaries together.
Elastic enabled / Strength / Rest length	Enable contraction on selected edges. Higher strength pulls harder; 80% rest length shortens the desired edge length by 20%.
Linked mirrors	Use linked mirrored panels where symmetric edits should remain related.

Buttons and editing actions

Control	What it does
New Pattern / Open-Locate	Creates a document or locates an existing pattern file.
Save .pattern.json	Writes the standalone file used by the output.
Open Full Editor	Opens the larger pattern editing workspace.
+ Rectangle / + Trapezoid	Adds a panel from the dimension fields.
Draw Points / Close	Draws an outline and closes it into a panel.
Make Cubic Curve / Insert Point / Delete Point(s)	Changes edge shape or point topology.
Sew / Elastic tools	Selects the edge-pairing or elastic editing operation.
Undo / Redo / Fit	Reverts/reapplies edits or frames all panels.

Using this node

Draw or add closed panels and set their dimensions.
Pair seam edges and adjust curves or elastic settings.
Save the pattern file, then arrange it in Scene and connect Cloth Solver.

Saving the workflow does not embed unsaved pattern edits or copy the pattern file. Keep the referenced .pattern.json with the project.

uv_unwrap

UV workflow stage.

Inputs, parameters, buttons, and usage

Connections and result

Connect geometry to mesh. The processed mesh supplies UV coordinates for texture, mask, and related workflows.

Parameters and options

Control	What it does
Mesh / source	The connected geometry to unwrap.
Path	The processed mesh path used downstream; check that the input has resolved before previewing.
UV inspection	Inspect the result with a checker texture before relying on it for painting or grooming. This compact node does not expose an island-packing editor.

Buttons and editing actions

Control	What it does
View	Processes/resolves and displays the connected mesh for inspection.

Using this node

Connect the mesh to UV Unwrap.
View and apply a checker texture downstream.
Inspect distortion before adding a painted mask or detailed texture.

normals

Smooth mesh normals and cache an updated OBJ for downstream texture, mask, and scene workflows.

Inputs, parameters, buttons, and usage

Connections and result

Connect mesh. The node computes smoothed normals and caches a processed OBJ for downstream geometry, texture, mask, or Scene use.

Parameters and options

Control	What it does
Angle	Smoothing threshold in degrees; initial value 180 permits broad smoothing. Reduce it when hard surface boundaries should remain distinct.
Weld tolerance	Tolerance used when matching nearby vertices for smoothing; initial value 0.0001.
Source / path	The original mesh and processed result path. Work at a consistent scale before changing the tolerance.

Buttons and editing actions

Control	What it does
View	Builds and previews the normal-adjusted result.

Using this node

Connect a mesh with unwanted faceting or seams.
Adjust Angle and test a small weld tolerance.
View under lighting before passing the mesh to materials or Scene.

texture

Base texturing stage.

Inputs, parameters, buttons, and usage

Connections and result

Connect geometry to mesh and choose an image texture. The result can feed Scene or another material/texture stage.

Parameters and options

Control	What it does
Texture	Image file applied to the connected mesh.
Source / path	Resolved geometry from the mesh connection.
Preview	Shows the chosen texture; the View control reports whether a mesh or texture is still missing.

Buttons and editing actions

Control	What it does
Choose texture	Browses for the image file.
View	Displays the textured model or connected scene.

Using this node

Connect a mesh with suitable UVs.
Choose the texture image.
View and check orientation/coverage before rendering.

texture_pro

Expanded texture processing controls.

Inputs, parameters, buttons, and usage

Connections and result

Connect geometry to mesh. Generates a procedural Checkerboard or Matrix Rain texture for the model/scene.

Parameters and options

Control	What it does
Pattern / Resolution	Choose Checkerboard or Matrix Rain and texture resolution; available resolutions include 256, 512, and 1024.
Tiling / Pack X / Pack Y	Controls tile density and horizontal/vertical packing.
Offset X / Y	Shifts the checker pattern in cell units.
Speed / Direction / Pan	Sets animation rate and rain direction. Pan slides cells smoothly; disabling it steps by cell.
Life min / max	Minimum and maximum lifetimes of rain chains, in seconds.
Chain gap min / max	Time interval range between new rain-chain spawns.
BG Color / BG Alpha	Background color and opacity.
Lighting / Emissive / Softness	Controls lighting contribution, procedural-text glow, and glyph-edge softness.

Buttons and editing actions

Control	What it does
BG Color	Opens the background color chooser.
View	Displays the procedurally textured model or scene.

Using this node

Select the pattern and View on a UV-mapped mesh.
Set tiling/packing before tuning animation.
For Matrix Rain, adjust chain timing and glow while playing the timeline.

texture_layer

Layered texture compositing.

Inputs, parameters, buttons, and usage

Connections and result

Connect the target geometry to mesh and texture-producing sources to base and overlay.

Parameters and options

Control	What it does
Base	The lower texture layer.
Overlay	The layer composited over the base; use the source layer’s transparency to control its contribution.
Mesh	Geometry receiving the composed texture.
Source layer settings	Edit texture generation, colors, and opacity on the upstream nodes; this compact compositor does not present a full layer-stack editor.

Buttons and editing actions

Control	What it does
View	Displays the combined layers on the connected model/scene.

Using this node

Connect a mesh and a base texture.
Connect the overlay texture and set its upstream alpha as needed.
View to verify the combined result.

material

Material setup and conversion utilities.

Inputs, parameters, buttons, and usage

Connections and result

Connect mesh to apply the material settings before Scene or export.

Parameters and options

Control	What it does
Transparency	Controls how much of the surface is transparent.
IOR / Refraction	Sets the index of refraction and refractive contribution used by the material.
Tint color	Colors the material’s transmitted/tinted appearance.
Fresnel amount / color	Controls the angle-dependent contribution near grazing views.
Source / path	Geometry receiving the material; the connection supplies the source.

Buttons and editing actions

Control	What it does
Color swatches	Choose tint and Fresnel colors.
View	Previews the material on the connected geometry.

Using this node

Connect the mesh and View it with scene lighting.
Set transparency and tint first.
Adjust IOR/refraction and Fresnel while inspecting both front and grazing angles.

mask

Paint foreground/background mesh masks with brush, falloff, invert, clear, and preview controls.

Inputs, parameters, buttons, and usage

Connections and result

Connect mesh to paint a surface mask. Feed the mask result to Groom Guides or other mask-aware processing.

Parameters and options

Control	What it does
Foreground / Background	Paint and clear colors; initial values are white foreground and black background.
Brush size	Brush footprint; initial value 48.
Falloff	Edge softness of the brush; initial value 0.35.
Brush mode	Selects the painting operation, initially add.
Mask path	Stored mask result used downstream.

Buttons and editing actions

Control	What it does
Paint brush	Enables mask painting in the 3D viewport.
Invert	Swaps foreground and background colors.
Clear	Fills the mask with the background color.
View	Displays the mask on the connected model.

Using this node

Connect a mesh and View.
Set brush size/falloff and paint the intended region.
Inspect boundaries before connecting the mask to Groom Guides.

split_volume / volume_selector

Filter/split geometry by volume.

Inputs, parameters, buttons, and usage

Connections and result

Connect the geometry to mesh and the selection volume to volume. Also registered as volume_selector.

Parameters and options

Control	What it does
Volume	Defines the spatial region used to filter/split the mesh.
Invert	Reverses which side of the volume selection is kept; initially off.
Source / result path	The input geometry and processed result; inspect the split before later processing.
Debug	Enables diagnostic output when investigating the result.

Buttons and editing actions

Control	What it does
View	Previews the connected selection/result.
Split	Performs the volume-based geometry split.

Using this node

Connect the mesh and volume.
Place the volume and choose whether the selection is inverted.
Split and inspect the result before export or downstream processing.

fx

Post-process and trail-style pipeline stage.

Inputs, parameters, buttons, and usage

Connections and result

Connect the animated source to mesh and optional repeated geometry to instance. This node builds trail-style effects from sampled motion.

Parameters and options

Control	What it does
Enabled / Global	Enables the trail and selects global-space behavior.
Samples / Frame step	Number and spacing of motion samples; initial values 28 and 1.
Spawn rate / Substeps / Lifespan	Controls how frequently trail elements appear, intermediate sampling, and their lifetime.
Repeats / Radius / Sides	Controls repeated trail geometry and its thickness/resolution.
Color / Line width	Sets trail appearance.
Profile ramp	Shapes the trail profile along its extent.
Age scale min / max / ramp	Changes element size over its lifetime.

Buttons and editing actions

Control	What it does
Wave	Resets the profile ramp to its wave-shaped preset.
Linear	Resets the age-scale ramp to a linear progression.
Ramp editing	Adjust the ramp points to control the shape and age response.

Using this node

Connect an animated source and view it through Scene.
Start with a short lifespan and modest sample count.
Tune the profile and age scale while playing the animation.

fx_splat_physics

Add motion lag, gravity, noise, and fading trails to animated skinned splats.

Connect: Feed skinned_splat_proxy into splats, then send the result to Scene. Physics follows the animated target positions while allowing controlled drift.

Controls: Choose a preset, then tune Follow, Drag, Velocity, Gravity Y, noise, substeps, and Max Lag. Trail and Glow add visual effects; Reset on timeline jumps resets the simulation when scrubbing beyond the Jump threshold.

Inputs, parameters, buttons, and usage

Connections and result

Connect an animated Gaussian-splat source to splats. Adds follow/lag, force, trail, and physics-driven glow behavior during playback.

Parameters and options

Control	What it does
Enabled / Preset	Toggle physics and choose a starting preset. Apply copies the preset into the node values.
Follow / Drag / Velocity / Scale	Controls attraction to the moving source, motion damping, inherited velocity, and overall physics scale.
Noise Type / Noise / N Scale / N Speed	Choose None, Curl Force, Velocity Multiply, Follow Multiply, or Drag Multiply. Set noise strength, pattern scale, and animation speed; lower N Scale makes broader noise, while higher values make tighter breakup.
Gravity Y	Vertical force contribution; initial value −0.25.
Substeps / Max Lag	Substeps improve temporal resolution; Max Lag limits displacement from the source.
Reset on timeline jumps / Jump	Resets history when a sufficiently large frame jump occurs; initial threshold 12 frames.
Trail / T Rate / T Life / T Alpha / T Size / T Curl	T Rate is the fraction of source splats emitted per frame; T Life is their lifetime in frames. The other controls set starting opacity, size, and curl force.
Glow from physics / glow intensity / radius boost	Adds a glow response and controls its strength and expanded splat footprint.

Buttons and editing actions

Control	What it does
Apply	Applies the selected preset to the current parameter values.

Using this node

Connect an animated splat proxy and apply a mild preset.
Play forward to inspect follow and drag.
Add trails/glow after the core motion is stable, and enable jump resets when scrubbing.

fx_splat_fx

Apply audio-driven glow and traveling wave effects to Gaussian splats.

Connect: Supply a skinned splat proxy or a compatible splat-effects node to splats. Connect an audio source to audio or browse to an audio file, then use View to preview with the timeline.

Controls: Adjust audio gain, smoothing, threshold, and start offset, then tune glow intensity, radius, saturation, and wave strength, width, speed, and axis. This node is also available through the splat_fx and splat_glow aliases.

Inputs, parameters, buttons, and usage

Connections and result

Connect splats and an audio source to audio, or choose an audio file. Creates audio-reactive glow and waves on the splats.

Parameters and options

Control	What it does
Enabled / Audio path	Enables the effect and provides a local sound source when needed.
Analysis gain / Smoothing / Threshold	Sets audio sensitivity, response smoothing in milliseconds, and the minimum activity level.
Audio start offset	Aligns the audio analysis with the scene timeline in milliseconds.
Glow intensity / Radius boost / Saturation	Controls audio-reactive glow strength, footprint, and color saturation.
Wave strength / Width / Speed / Axis	Controls the deformation wave and chooses its X, Y, or Z direction.

Buttons and editing actions

Control	What it does
Browse	Chooses the audio file.
View	Previews the audio-reactive splat effect.

Using this node

Connect a splat source and audio.
Align the start offset and tune gain/threshold.
View during playback and adjust glow/wave strength.

colorize

Recolor splats with a three-color ramp driven by their shape or height.

Connect: Feed a skinned splat proxy or compatible splat-effects chain into splats, then preview it in Scene or with View.

Controls: Choose Thickness, Density, Radius, Area, or Height Y as the metric. Set low, middle, and high colors, then adjust percentile limits, invert, gamma, and blend. splat_colorize and fx_splat_colorize are aliases.

Inputs, parameters, buttons, and usage

Connections and result

Connect Gaussian splats to splats. Recolors them from a measurable splat property.

Parameters and options

Control	What it does
Metric	Choose Thickness, Density, Radius, Area, or Height Y to drive the colors.
Low / Mid / High color	Defines the three-stop color ramp.
Low / High percentile	Bounds the mapped range while reducing the influence of extremes; initial values 2 and 98.
Gamma	Adjusts the distribution through the ramp; initial 1.
Blend	Mixes the recoloring with the source appearance; initial 1.
Invert ramp / Enabled	Reverses the mapping or toggles the effect.

Buttons and editing actions

Control	What it does
Color buttons	Chooses low, mid, and high colors.
View	Previews the recolored splats.

Using this node

Choose a metric appropriate to the shape.
Set contrasting ramp colors and inspect the result.
Tune percentile limits and Blend to preserve useful source detail.

fx_music_effects

Drive mesh displacement from an audio track, including animated character geometry.

Connect: Supply geometry to mesh and a sound source to audio, or select an audio file in the node. Use View to preview the deformation with timeline audio.

Controls: Set analysis gain, smoothing, threshold, and audio start offset. Displacement, maximum displacement, and outward-only movement control how far the surface responds to the sound.

Inputs, parameters, buttons, and usage

Connections and result

Connect mesh and audio or choose an audio file. Converts audio activity into mesh displacement.

Parameters and options

Control	What it does
Enabled / Audio path	Enables the effect and selects a file when the audio connection does not supply it.
Analysis gain / Smoothing / Threshold	Controls sensitivity, temporal smoothing in milliseconds, and the minimum activity level.
Audio start offset	Aligns the sound with the scene timeline in milliseconds.
Mesh displacement / Maximum displacement	Sets the displacement response and its upper limit.
Outward only	Restricts deformation to outward motion; initially enabled.

Buttons and editing actions

Control	What it does
Browse	Selects an audio file.
View	Displays the mesh with the audio-reactive deformation.

Using this node

Connect a mesh and a sound source.
Align playback and start with a low displacement.
Adjust gain and smoothing before raising the displacement limit.

wire

Wire and curve-based geometry path workflows.

Inputs, parameters, buttons, and usage

Connections and result

Connect mesh/point geometry to mesh. Creates line/curve paths using its point order and grouping attributes.

Parameters and options

Control	What it does
Enabled	Enables the wire result.
Order	Choose id, file, x, y, z, probability, or hamming ordering along each path; initial value id.
Group attribute	Separates paths using an attribute such as name, the initial setting.
Source / path	The input geometry and resolved result.

Buttons and editing actions

Control	What it does
View	Displays the generated wires/curves.

Using this node

Connect geometry with the intended point order.
Choose the grouping attribute so unrelated objects are separate.
View and correct ordering before using the paths downstream.

groom_guides

Generate guide curves from a painted mask and source mesh.

Inputs, parameters, buttons, and usage

Connections and result

Connect a painted Mask to mask. The source mesh and mask define where guide roots are generated.

Parameters and options

Control	What it does
Guide count	Number of guides to seed; initial 256.
Segments	Segments along each guide; initial 5.
Threshold	Mask cutoff for eligible root locations; initial 0.35.
Length	Initial guide length; initial 0.08 in the source geometry’s scale.
Seed	Repeatable random distribution of roots; initial 7.
Guides path / diagnostics	Identifies the generated guide data and reports generation issues.

Buttons and editing actions

Control	What it does
View	Generates/resolves and previews the guides.
Diagnostic Copy	Copies the report when a diagnostics dialog is opened.

Using this node

Paint the growth region with Mask.
Set guide density, length, and threshold.
View, then connect the guides to Groom Deform or Guide Tube.

groom_deform

Bind guide curves to FBX/retarget rigs and optionally hide the deformer geometry.

Inputs, parameters, buttons, and usage

Connections and result

Connect guides and a compatible rig. Binds the guides to the animated character context.

Parameters and options

Control	What it does
Mode	The initial skinned_cv mode deforms guide control vertices with the rig.
Hide deformer geo	Hides the driving geometry in the result; initially enabled.
Rig compatibility	The guides and rig must refer to compatible geometry/placement for roots to follow the intended surface.

Buttons and editing actions

Control	What it does
View	Previews the bound guides on the rig.
Diagnostic Copy	Copies the available diagnostic report.

Using this node

Generate guides on the character’s source mesh.
Connect the corresponding animated rig.
View several frames and check root attachment before adding simulation.

groom_guide_pose

Pose guide curves from animation frames with XPBD-style strand settings and optional GPU support.

Inputs, parameters, buttons, and usage

Connections and result

Connect guides and an optional collider. Produces a settled/simulated guide pose and a pose cache for later strand processing.

Parameters and options

Control	What it does
Enabled / Start frame / FPS	Enables the strand calculation and sets its starting frame and timing; initial start 0 and FPS 24.
Substeps / Iterations	Temporal subdivisions and constraint solves; initial values 4 and 8. Higher values cost more processing.
Stretch / Bend / Damping	Controls resistance to elongation and bending plus motion damping.
Gravity Y / Wind X-Y-Z	Forces applied to the guides; initial gravity −9.81 and wind 0.
Scene units per meter	Converts scene scale for physical settings; initial value 100.
Root pin	Controls attachment strength at guide roots; initial 1.
Maximum velocity	Limits motion velocity; initial 250.
Device	Backend selection; auto initially. Choose a supported device for the configured runtime.
Settle seconds / Warmup frames	Controls how long the guide pose settles before being used. Initial warmup is 36 frames.

Buttons and editing actions

Control	What it does
Sim Pose	Calculates the settled pose using the selected forces, timing, and collider.
Clear Sim	Clears the stored simulated-pose result.
View	Displays the current guide pose.

Using this node

Connect guides and the correctly scaled collider.
Set the start frame and settling time.
Sim Pose and inspect it; clear/recompute after changing the source setup.

groom_guide_sim

Simulate guides with frame, FPS, substep, stretch, bend, gravity, wind, and collider controls.

Inputs, parameters, buttons, and usage

Connections and result

Connect guides and an optional collider for animated strand simulation. The processed guide data can feed Guide Tube or Scene.

Parameters and options

Control	What it does
Enabled / Start frame / FPS	Enables the strand calculation and sets its starting frame and timing; initial start 0 and FPS 24.
Substeps / Iterations	Temporal subdivisions and constraint solves; initial values 4 and 8. Higher values cost more processing.
Stretch / Bend / Damping	Controls resistance to elongation and bending plus motion damping.
Gravity Y / Wind X-Y-Z	Forces applied to the guides; initial gravity −9.81 and wind 0.
Scene units per meter	Converts scene scale for physical settings; initial value 100.
Root pin	Controls attachment strength at guide roots; initial 1.
Maximum velocity	Limits motion velocity; initial 250.
Device	Backend selection; auto initially. Choose a supported device for the configured runtime.

Buttons and editing actions

Control	What it does
View	Previews the guide simulation; use timeline playback to inspect the animated response.

Using this node

Begin with properly attached or settled guides.
Set scene scale, FPS, and collider.
View and play forward, increasing substeps/iterations if the motion needs more stable constraints.

groom_guide_tube

Convert guide curves into tube geometry with radius ramp, subdivisions, caps, smoothing, and source-guide display.

Inputs, parameters, buttons, and usage

Connections and result

Connect guides to generate renderable tube geometry around the strands.

Parameters and options

Control	What it does
Enabled	Enables tube conversion.
Root radius / Tip radius	Thickness at each end; initial values 0.006 and 0.0015.
Radius profile	Ramp controlling thickness along the strand.
Sides / Segment subdivisions	Cross-section resolution and along-strand subdivisions; initial 8 sides and 1 subdivision.
Caps / Smooth / Guides	Controls closed ends, smoothed normals, and whether the source guides remain visible.

Buttons and editing actions

Control	What it does
Flat	Resets the editable radius profile to a flat profile.
View	Displays the tube geometry.

Using this node

Connect posed or simulated guides.
Choose root/tip radii and tune the radius ramp.
View, then increase resolution only if the shot needs it.

skinned_volume_mesh

Generate skinned voxel collision meshes from rig contexts for grooming simulation and viewport collision.

Inputs, parameters, buttons, and usage

Connections and result

Connect a rig-aware mesh to mesh. Generates a skinned voxel-derived proxy suitable for collision/viewport use.

Parameters and options

Control	What it does
Density / Volume resolution	Voxel resolution along the longest model axis; higher values preserve more detail and require more resources.
Quality / Remesh smoothing	Number of smoothing passes. This rounds voxel edges; it does not add polygons.
Maximum influences	Limits skinning influences retained for the generated proxy.
Fill interior	Controls interior filling of the volume.
Output directory / generated files	The manifest, mesh, volume grid, and skin data describe the generated result.

Buttons and editing actions

Control	What it does
Generate	Builds the proxy from the connected rig context.
View Mesh	Displays the generated volume mesh.

Using this node

Connect the validated rig/mesh.
Generate at moderate density and inspect its silhouette.
Increase density for missed detail or smoothing for blocky edges before using it as a collider.

skinned_splat_proxy

Generate skinned splat proxies from retargeted rigs, FBX imports, or guide tubes.

Inputs, parameters, buttons, and usage

Connections and result

Connect a supported rigged mesh, retargeted character, or guide-tube source to mesh. Generates sampled splats with skinning data.

Parameters and options

Control	What it does
Sample count / Seed	Controls point density and repeatable sampling; initial seed 1234.
Maximum influences	Limits the number of skinning influences retained per sample.
Color mode	Chooses the source of sample colors; initial mode skin_weights helps inspect attachment.
Radius scale / Adaptive size	Controls splat coverage and whether size adapts to the sampled geometry.
Hide source mesh	Hides the original geometry when previewing; initially enabled.
Auto generate if missing	Allows generation when no proxy exists; initially off.
Output directory / Manifest / PLY / Skin data	Files making up the reusable proxy result.

Buttons and editing actions

Control	What it does
Generate	Builds the splat samples and skinning data.
View Proxy	Displays the generated proxy.

Using this node

Connect a validated animated source.
Generate and View Proxy.
Check coverage and deformation across several frames before applying splat effects.

Media and Review

html_preview

In-node HTML rendering with a path input and PDF export for generated decks and other upstream HTML artifacts.

Inputs, parameters, buttons, and usage

Connections and result

Connect an HTML file path to path, for example Task’s generated artifact. The document is rendered inside the node.

Parameters and options

Control	What it does
Path	HTML file to display. A connected artifact path lets the preview follow generated output.
Document resources	Images and styles referenced by the HTML must remain accessible beside the document or at their referenced locations.
Preview backend	Qt WebEngine provides the full browser preview and PDF export; a text fallback is used when it is unavailable.

Buttons and editing actions

Control	What it does
PDF	Exports the displayed HTML to a chosen PDF file. Generated deck layouts can supply their own page breaks.

Using this node

Generate or choose an HTML document.
Connect its path and review the rendered output.
Use PDF when the document is ready to share.

PDF export requires Qt WebEngine; the text preview fallback cannot perform it.

qwen_image

Local Qwen Image 2.1 text-to-image generation and image editing with reference images, presets, seeds, and saved PNG results.

Generation and editing guide →

Inputs, parameters, buttons, and usage

Connections and result

Inputs are prompt, negative_prompt, image, and reference_image. Connected text or images override the corresponding local fields. A single-field Note supplies its value; a multi-field Note supplies checked values. An Image Collection connection supplies its first image path to the selected image input.

Outputs are image, image_path, seed_used, status, job_id, and metadata.

Parameters and options

Control	What it does
Backend and model	ComfyUI offers INT8 and GGUF Q4_K_M. Native Diffusers uses a separate runtime and official BF16 weights; native INT8/GGUF inference is not validated and GPU output-quality validation remains in progress. Each backend requires its own setup.
Mode and prompt	Choose Text to Image or Image Edit. Enter the desired image or an editing instruction; Image Edit requires an input image.
References	Image Edit accepts an optional second reference. Native also accepts additional reference paths, up to ten images total including the input.
Native Guidance and Framing	Guidance can follow the prompt, favor the input composition, or use its pose/layout. Framing can use the last supplied image, match the input or first reference, or use custom dimensions. Guidance does not guarantee exact preservation.
Dimensions and presets	Width/Height use a 32-pixel grid from 64 to 4096. Edit size controls edit conditioning and native automatic/matched pixel budget. Preview, quality, portrait, widescreen, and low-memory presets provide starting settings.
Steps, CFG, and negative prompt	Adjust inference settings. Negative prompts are native-only; native CFG 1 works without negative guidance, while CFG above 1 requires a negative prompt.
Seed and Random seed	Generate variations or reuse a fixed seed. The actual seed is available through seed_used.
Transparent PNG and Low memory	Request transparency and choose a lower-memory execution profile. Inspect alpha warnings in the result. Native CPU offloading can be slower; restart ComfyUI when changing its launch memory profile.

Buttons and editing actions

Control	What it does
Setup	Choose runtime, model storage where available, output folder, and permitted model use; read the license and install/verify the selected model.
Start Local Backend / Stop Local Backend	Start the selected local runtime or stop this app's backend after active jobs finish or are canceled.
Check Backend	Check readiness for the selected runtime and model.
Generate / Cancel	Generate the image or request cancellation of the active generation.
Open PNG / preview double-click	Open the generated PNG in the system image viewer.
Output Folder	Open the save location. Change it in Setup.
Recover Job	Retrieve the saved job's result after a timeout, restart, or detach without queuing a new generation.

Using this node

Choose a backend, open Setup, review the model license and hardware/storage requirements, and install or verify the selected model.
Start and check the backend, choose Text to Image or Image Edit, and enter a prompt and any required images.
Choose a preset or inference settings and Generate. Inspect the preview, seed, status, and output PNG.
Load saved variations into Image Collection for full-resolution review and pinned comparison.

Qwen's model-use acknowledgement does not grant commercial rights. Research/evaluation and separately licensed commercial use have distinct terms; read the linked Qwen Research License in Setup. Native generation does not silently fall back to ComfyUI.

image_collection

Arrange image sets, resize packed previews, and review original-resolution images with slideshow and pinned comparison controls.

Image collection and comparison guide →

Inputs, parameters, buttons, and usage

Connections and result

Stores ordered image paths for review and compatible consumers. Connect multiple Image Collections to the Design images input (reference_images) of MiniMax H3 Ref Video to combine character sheets, environments, and other designs. All collections contribute their paths, duplicates are removed in first-occurrence order, and the combined limit is nine images. Collections follow incoming source order, left-to-right then node name, while retaining their internal image order. A Qwen image or reference_image connection uses the first collection path.

Parameters and options

Control	What it does
Image paths	Load adds the chosen files to the existing collection and removes duplicate path entries while retaining order.
Canvas preview	Single-image sizing follows the source aspect ratio. Multiple images use tightly packed rows, and a thin gray outline identifies the hovered image.
Move and resize	With Edit off, drag an image to move the collection. Drag borders/corners to resize it; images reflow and load sharper previews as space grows. Node dimensions save with the graph. Source images are unchanged.
Supported file picker formats	PNG, JPG/JPEG, BMP, and TIF/TIFF are offered by the picker.

Buttons and editing actions

Control	What it does
Load / Explorer drop	Load appends files to the collection. Dropping local images into the 2D graph creates a new collection.
Edit / Remove / Path	Enable Edit to select an image, copy its path, open its folder, or remove its entry. Removal does not delete the file. Turn Edit off to open the viewer or move the collection by dragging an image.
Double-click with Edit off	Open the clicked original in a large, resizable viewer with position, filename, and dimensions.
◀ ▶ / Left and Right keys	Left triangle or Left key: Previous. Right triangle or Right key: Next. Navigation wraps around. A pin changes navigation to the comparison sequence below.
Click / swipe in Fit mode	Click for Next; drag left for Next or right for Previous. Fit mode uses the standard arrow cursor.
Wheel / mouse side buttons	Wheel up goes Next; down goes Previous. Browser Back/Forward buttons go Previous/Next. These also work at 100% and follow pin behavior.
100%	Show actual pixels. Clicking does not advance, and dragging uses the grab hand to pan. Turn it off to fit the image again.
Slideshow / Pause / Space	Toggle automatic Next every three seconds. Closing the viewer stops playback; Escape closes it. Navigation arrows and slideshow are disabled for a single image.
Pin	The pin sits left of the navigation buttons: gray for an unpinned image, blue on the pinned reference. Previous shows the reference without stepping backward; Next restores the comparison, and a second Next advances. Click the blue pin to unpin or a gray pin on another image to replace it.

Using this node

Load images or drop them into the 2D graph. Move or resize the collection; use Edit for path and removal controls.
Turn Edit off and double-click an image. Browse, inspect at 100%, or play a slideshow.
For comparison, pin A and go Next to B. Previous shows A; Next returns to B. Next again advances to C. Unpin to restore ordinary backward navigation.
Connect the collection to a compatible image input as needed. Keep the referenced source files available.

Pin a reference for back-and-forth comparison

The pin button sits immediately left of the navigation triangles. It is gray on an unpinned image and blue when the displayed image is the pinned reference. Pin one reference to compare it against the other images without losing your place.

Turn Edit off, double-click reference image A, and click its pin button. The pin turns blue.
Go Next to comparison image B.
Go Previous to show A. Repeated Previous actions stay on A; they do not step backward through the collection.
Go Next once to return to B. Repeat Previous/Next to compare A and B as often as needed.
From B, go Next again to advance to C. Previous now shows A, and Next returns to C. Forward browsing continues to wrap through the collection.

Pin A → Next: B → Previous: A → Next: B → Next again: C
Previous: A → Next: C

Click the blue pin on A to unpin and restore ordinary backward navigation. Click a gray pin on another image to replace the reference. The pin applies to the current viewer session.

The triangle buttons, Left/Right keys, mouse wheel, browser Back/Forward side buttons, Fit-mode clicks and swipes, and slideshow all use these same Previous/Next comparison rules. At 100%, clicking does not advance and dragging pans the image.

The workflow stores image paths, so keep the referenced files available when moving it.

video_player

Timeline playback and clip inspection.

Inputs, parameters, buttons, and usage

Connections and result

Connect a video or numbered image-sequence path to path, or choose a local file. For image-sequence delivery, connect Video Player to Sequence to MP4: the exporter receives the sequence path and can inherit this player's marked range.

Parameters and options

Control	What it does
Path	The media file to play. A connected path drives the field instead of the manual selection.
Scrub slider	Seeks through the full source. Cyan/yellow start/end flags mark the selected range; the bar outside them is darker in both the node and large player.
Preview	Displays the current frame and reports when no usable media is loaded.

Buttons and editing actions

Control	What it does
Browse	Chooses a local video.
Play / Pause / Space	Starts or pauses playback, looping within the marked range. Space toggles playback for a selected Video Player when the graph has focus and throughout the large-player window. Space still enters text in the node's path field.
[ / ] / [X]	Set the inclusive first/last frame at the playhead, or clear both flags with [X]. Image sequences use their filename frame numbers. Markers save with the workflow and reset when the source changes.
Large player	Opens original media in a maximized window with matching controls and minimize, maximize/restore, and close caption buttons. F11 toggles full screen; Esc returns to the framed window from full screen or closes a framed window. Closing returns the frame position to the node.
Open	Opens the loaded MP4 in the system's default external video player, like the MiniMax H3 Reference Video node's Open Video button. Available beside the large-player button in both the node and large-player window. Works with local or connected MP4 paths, including when the in-node preview is unavailable; disabled for image sequences, missing files, or an empty path.
Sound On / Off	Enables or mutes audio for the preview.

Using this node

Browse a clip or connect a generated mp4_path.
Play and inspect its audio.
Scrub and click [ and ] to mark the first and last frames; use [X] to clear them. Play, range, clear, and large-player controls sit on the left of the lower row; audio sits on the right.
Open the large player to review the original-resolution source. For sequence export, connect this node to Sequence to MP4 and leave the desired boundaries on Auto.

youtube_downloader

Download a YouTube video as MP4, extract MP3 audio, and optionally save a Markdown transcript.

Use: Enter a video URL, choose an output folder, and enable transcript export with the preferred caption language when needed. Downloads and audio conversion use yt-dlp and FFmpeg; transcript availability depends on the video captions.

Outputs: mp4_path, mp3_path, and transcript_md. Connect the video to video_player for review or route the audio into the music and splat effects nodes.

Inputs, parameters, buttons, and usage

Connections and result

Connect a URL to url or enter it locally. Outputs mp4_path, optional mp3_path, and transcript_md for downstream review or analysis.

Parameters and options

Control	What it does
URL	The source video address; connected URL input takes precedence.
Output folder	Directory for the downloaded/generated files.
MP3	Requests an extracted audio file; initially disabled.
Transcript / Language	Requests a transcript and chooses its language; initial settings enable transcript with en.
Output paths / status	Read the generated file locations and progress/result messages.

Buttons and editing actions

Control	What it does
Choose output folder	Sets the download destination.
Download	Runs the configured download and optional audio/transcript work.
Open	Opens the result/output location.

Using this node

Enter the source URL and destination.
Choose MP3 and transcript options.
Download, then connect the resulting video/audio/text path to the appropriate consumer.

minimax_h3_video

Generate video from a prompt and optional first/last images through a local MiniMax H3 runtime.

Create Node listing: MiniMax H3 Local Video. For a connected Note prompt, a single visible parameter is automatic; with multiple parameters, only checked values are used. Labels are omitted, and an empty connected selection does not fall back to local text. The Note itself continues to expose all regular nonempty values.

Setup: Use Setup Model to prepare the local checkpoint, choose the model folder and variant, and configure a running local H3 service URL. Generation requires both the checkpoint and the local service.

Connect: Inputs are prompt, first_image, and last_image. Choose duration, aspect ratio, resolution, and output folder, then click Generate. Outputs are mp4_path, task_id, and h3_status.

Inputs, parameters, buttons, and usage

Connections and result

Connect prompt and optional first_image/last_image inputs. This node talks to a locally configured H3 generation service and exposes mp4_path, task_id, and h3_status.

Parameters and options

Control	What it does
Prompt / First frame / Last frame	Defines the scene and optional image conditioning.
Model folder / Variant	Selects the local model files and variant; the initial variant is fl2va.
Local URL / create-query-retrieve paths	Configure the service endpoint. Initial paths are /generate, /status/{task_id}, and /files/{file_id}.
Duration / Ratio / Resolution	Controls requested clip shape and length; initial duration 8 seconds, adaptive ratio, and 768p resolution.
Output folder / Poll interval / Timeout	Chooses where the MP4 is saved, how often status is checked, and how long to wait. Initial polling is 5 seconds and timeout 1800 seconds.

Buttons and editing actions

Control	What it does
Setup Model	Opens the local model setup workflow.
Browse controls	Chooses image, model, and output paths.
Generate	Submits the request to the configured local service and retrieves its result.
Open / Copy	Opens the generated video or copies its MP4 path.

Using this node

Configure the local runtime/service and model folder.
Test a short prompt with optional first/last images.
Generate, monitor status, and review mp4_path with Video Player.

minimax_h3_api_video

Generate MiniMax H3 video through the cloud API using a prompt, frame images, or reference images.

Create Node listing: MiniMax API Vid. Note prompts follow the same selection rule as Qwen and the other H3 nodes: one visible parameter is used even unchecked; multiple parameters require checked values. Use MiniMax H3 Ref Video for previs-video, design-image, and audio references together.

Setup: Enter a MiniMax API key and select the API base, model, duration, aspect ratio, and resolution.

Connect: Use prompt with optional first_image and last_image in Image-to-video mode, or use reference_images in Reference-to-video mode. Reference images and first/last frames are separate modes. Outputs are mp4_path, task_id, and h3_api_status.

Inputs, parameters, buttons, and usage

Connections and result

Inputs are prompt, first_image, last_image, and reference_images. Outputs are mp4_path, task_id, and h3_api_status.

Parameters and options

Control	What it does
Prompt / Mode	The text prompt describes the video. Image mode uses first/last frames; Reference mode uses reference images and cannot mix them with first/last frames.
First / Last images	Accept local supported images or the URL/data/file-reference formats shown by the node.
Reference images	Up to nine references in the implemented H3 interface, including an Image Collection connection.
API key / Base URL / Model	Configure the hosted service and selected model. The key must support the video service.
Duration / Resolution / Ratio	The UI enforces combinations for its H3/H3-Max choices. Image-conditioned requests use adaptive framing; text/reference requests can use the offered ratio choices.
Create / Query / File paths	Advanced service endpoint settings; query paths can contain {task_id}.
Output folder / Poll interval / Timeout	Controls download location and request monitoring; initial poll interval 5 seconds and timeout 1800 seconds.

Buttons and editing actions

Control	What it does
Browse controls	Chooses local conditioning images and output location.
Generate	Submits the request, polls the task, and saves the resulting video.
Open / Copy	Opens the MP4 or copies its path.

Using this node

Choose Image or Reference mode and provide the matching inputs.
Set credentials, model, and compatible clip settings.
Generate and inspect the downloaded MP4 before using it downstream.

minimax_h3_reference_video

Generate a video guided by a 3D layout/previs clip, character sheets, environment designs, an optional audio reference, and a required prompt.

Create Node listing: MiniMax H3 Ref Video. The graph node keeps the full Reference Video name. This cloud API node is separate from MiniMax H3 Local Video and MiniMax API Vid.

Follow the previs and reference-video workflow →

Inputs, parameters, buttons, and usage

Connections and result

Connect prompt, reference_videos (Previs videos), reference_images (Design images), and optionally reference_audio. Browse local files or enter paths, public URLs, or mm_file:// references, one per line. Local media is inspected and uploaded automatically. Outputs are mp4_path, task_id, h3_reference_status, error, and metadata_path; connect mp4_path to Video Player.

Note prompts: With multiple visible Note parameters, only checked nonempty values enter the prompt, without labels. One visible parameter is used even unchecked. Selection also follows Note segments through Append/Switch. An empty connected selection reports an error; it cannot reuse local prompt text. This filtering happens in the H3 consumer, leaving Note output unchanged.

Parameters and options

Control	What it does
Prompt	Required, up to 7,000 characters. Describe what each numbered reference should control: camera, timing, poses, character identity, environment, or lighting.
Previs videos	Up to three MP4/MOV clips using H.264/HEVC, at most 50 MB each, 2–15 seconds per clip and 15 seconds total, at 23.976–60 FPS. Embedded audio must be AAC/MP3.
Design images	Connect multiple Image Collections to this same pin. Their paths are combined in graph source order, each collection keeps its image order, and duplicate paths are removed. The combined limit is nine images, 30 MB each; supported formats are JPG/JPEG/PNG/WEBP/HEIC/HEIF.
Audio references	Up to three WAV/MP3 clips, at most 15 MB each, 2–15 seconds per clip and 15 seconds total. Use at most 12 files across all reference types. Image/video dimensions must be 256–5760 pixels per side with a width/height ratio of 0.4–2.5.
Model / Duration / Resolution	MiniMax-H3: 4–15 seconds at 768P or 2K. MiniMax-H3-Max: 5–15 seconds at 480P or 768P. Both accept reference images/video/audio. Ratio can be adaptive or an offered fixed ratio.
H3 Max prompt	H3 Max prompt expansion: disabled, balanced, or quality.
API key / Save folder	Requires an eligible MiniMax pay-as-you-go key. Enter it for this app session or set MINIMAX_API_KEY / MINIMAX_PAYG_API_KEY. Entered keys are excluded from saved workflows and task metadata. Outputs default to the workflow's videos/minimax_h3_reference folder, or temporary storage for an unsaved workflow.

Buttons and editing actions

Control	What it does
Use previs prompt template / Browse	Insert a camera/motion/design instruction template or append local reference files. Reference numbers follow list order within each media type.
Generate / Generate new	Upload local references, submit a new generation, poll in the background, and download its MP4. A new generation uses provider balance; reference-video input is also billed.
Resume task	Query and download the saved task without uploading the original inputs or submitting another generation. Save the workflow to retain the task ID across app restarts. Tasks are queryable for seven days.
Stop waiting	Stops local waiting after an in-flight request finishes or times out. Submitted work continues at MiniMax and may still incur charges; Resume retrieves the same task later.
Open video	Opens the downloaded MP4 in the system player.

Using this node

Supply a short previs clip and connect character/environment Image Collections to Design images.
Write the prompt or connect a Note, checking the desired values when it has multiple parameters.
Choose the model and output settings, supply a pay-as-you-go key, generate, and review the MP4.

Reference following is generative: exact camera, framing, timing, or pose preservation is not guaranteed. This node uses reference roles; first/last-frame inputs belong to the separate frame-generation node.

wan22_video

Run local Wan 2.2 TI2V-5B text-to-video or image-to-video generation and output an MP4.

Setup: Use Setup Wan and select the runtime and model folders. Connect prompt and optionally image, or fill in those fields directly.

Controls: Set a negative prompt, output size, frame count, seed, sampler, steps, guidance, and Image Change. CPU offload and text-encoder controls help manage GPU memory. Outputs are mp4_path and wan_status; connect the MP4 to Video Player for review.

Inputs, parameters, buttons, and usage

Connections and result

Connect prompt and optional image. Runs the configured local Wan2.2 TI2V-5B runtime and exposes mp4_path and wan_status.

Parameters and options

Control	What it does
Prompt / Negative	Describes what to generate and what to avoid.
Image	Optional starting image for image-to-video.
Runtime / Model	Locations of the Wan2.2 code/runtime and TI2V-5B weights.
Size / Frames	The size key sets target pixel area for image-to-video, which follows the input aspect ratio. Shorter clips generally drift less; initial frame count is 121.
Solver / Seed	Choose the sampler, initially UniPC. A numeric seed allows repeatable runs; blank/random chooses a new seed.
Image change	Preservation helper: lower values reduce effective Denoise and CFG for image-to-video; 1 is normal behavior.
Denoise / CFG / Steps	Denoise is Wan sample shift; lower values can reduce warping. CFG controls prompt guidance. More steps take longer and do not necessarily fix deformation.
Offload / T5 CPU / Dtype	Reduces GPU memory use by offloading model parts, running the text encoder on CPU, or converting model dtype. These are initially enabled.
Output folder	Directory for generated MP4 files.

Buttons and editing actions

Control	What it does
Setup Wan	Installs or repairs the local runtime and model.
Browse controls	Chooses image, runtime, model, and output paths.
Generate / Stop	Starts or stops the local generation job.
Open / Copy	Opens the result or copies its MP4 path.

Using this node

Set up the runtime and weights, then choose an input image if needed.
Test a short clip with memory-saving options enabled.
Review the output and tune Image change/CFG before increasing clip length or step count.

render

Render sequence/export pipeline stage.

Inputs, parameters, buttons, and usage

Connections and result

Connect Scene to scene. The result can feed Post Process, Sequence to MP4, or For Each End’s render input.

Parameters and options

Control	What it does
Camera	Chooses the scene camera used for output; confirm it exists and frames the intended objects.
FPS	Output playback rate, initially 30. Scene animation and cloth are evaluated using the Scene timeline FPS.
Format	Choose PNG, JPG, TIFF, or EXR.
Start / End	Frame range. End = Auto uses the Scene end marker or animation length when no marker is set.
Output path	Destination for the rendered frame sequence.
Take folders / Take number	Writes separate take directories when enabled. For Each supplies its own take folder/number during a batch.

Buttons and editing actions

Control	What it does
Browse	Chooses the output path.
Render Sequence	Renders the configured range from the connected scene.
Stop Render	Stops the active render from its progress interface.

Using this node

View the Scene and select its camera.
Render a small range to check framing and simulation.
Render the full sequence or connect the completion output to For Each End.

Changing Render FPS does not change the Scene simulation step rate; set timeline FPS appropriately before cloth or animation work.

post_process

Apply image-sequence effects such as ordered dithering and produce an output frame pattern.

Inputs, parameters, buttons, and usage

Connections and result

Connect a sequence-producing source such as Render to source, or supply a supported source path. The output_pattern identifies the processed frame sequence.

Parameters and options

Control	What it does
Effect	The implemented processing action is ordered dithering.
Levels	Number of quantization levels; initial value 4.
Matrix	Choose a 2×2, 4×4, or 8×8 ordered-dither matrix.
Strength	Effect strength from 0 to 200; 100 is normal strength.
Gray	Enables grayscale processing.
Output directory / Output pattern / Frame count	Choose where processed frames are written and inspect the resulting pattern/count.

Buttons and editing actions

Control	What it does
Choose output folder	Sets the processed sequence destination.
Apply Dither	Processes the input sequence using the selected settings.

Using this node

Connect a rendered sequence.
Choose output folder, levels, matrix, and strength.
Apply Dither and review frames before connecting Sequence to MP4.

sequence_to_mp4

Encode image sequences to MP4 with FPS, codec, and bitrate settings.

Inputs, parameters, buttons, and usage

Connections and result

Connect an image sequence from Render, Post Process, or Video Player to source, or provide a folder, numbered frame, or sequence pattern. Video Player supplies its image-sequence path and optional markers. This exporter encodes numbered images; it does not trim an existing MP4.

Parameters and options

Control	What it does
Source	Input sequence to encode; use the upstream output pattern where available.
Output	Destination MP4 path.
Codec	Choose H.264 or H.265; initial selection H.264.
Start / End	Inclusive filename frame numbers. Each boundary independently defaults to Auto, using the corresponding connected Video Player marker or the first/last source frame when no marker is set. Type a number to override that boundary only. For example, 1020–1040 exports 21 frames. Invalid, out-of-source, or missing-frame ranges are rejected.
FPS	Playback rate assigned to the frame sequence; initial value 24. Match the intended render playback rate.
Bitrate	Target encoding bitrate, initially 12M. Higher values increase output size and can retain more detail.

Buttons and editing actions

Control	What it does
Choose output MP4 path	Sets the destination file.
Convert to MP4	Encodes the sequence through the configured ffmpeg support.

Using this node

Connect a completed render or processed frame sequence.
Set the intended FPS, codec, output file, and range. Leave Start/End on Auto to inherit Video Player flags, including through Post Process, or enter explicit source frame numbers.
Convert and review the resulting MP4 in Video Player.