Nodes/ComfyUI_KubaNodes/kubakub director sequence
ComfyUI Node

kubakub director sequence

Turns the kubakub director's timeline into video: renders every frame of the timeline (frames / fps / audio, e.g. into Create Video or kubakub keyframe clips (h3)) and / or writes it as a delivery file. Changing these settings does not re-render the director's still; bypass the node when you only need the still.

By kubakubkub·Created 15 days ago·Updated 3 days ago· 9
kubakub director sequence
  • director
  • frames
  • fps
  • audio
  • report
  • folder
  • files
  • frame_count
  • projection_mask
  • document
◄framestrue►
◄sequence_scale0.50►
◄skip_h3_framesfalse►
◄exportnone►
◄export_scale1.00►
◄export_alphafalse►
◄export_namedirector►
◄light_scale1.00►
Categorykubakub/2d/director

Inputs (9)

NameTypeDefaultDescription
directorKUBA_DIRECTORThe director output of kubakub director.
framesBOOLEANtrueReturn every frame in RAM (frames output). Off when you only export: the frames output is then the still.
sequence_scaleFLOAT0.500.1–1Size of the frames relative to the matrix (RAM: 250 frames at 1600x1080 = ~5 GB).
skip_h3_framesBOOLEANfalseDo not render the frames that H3 keyframe clips replace anyway (a dissolve stands in for them). Only applies when a kubakub keyframe clips (h3) node takes these frames; otherwise every frame is rendered.
exportCOMBOnoneWrite the whole timeline as a file at the delivery size, frame by frame (no RAM limit): PNG sequence 8/16 bit, ProRes 4444 / 422 HQ, H.264 (4:2:0 8 bit or 4:4:4 10 bit), H.265 10 bit, or a small preview. Rec.709 tagged, with the timeline sound. Into output/kubakub_director/<name>_<time>/.
export_scaleFLOAT1.000.1–11 = the delivery size (the matrix).
export_alphaBOOLEANfalseThe layers without the base, transparent where they do not cover (and outside the projection mask): PNG sequences and ProRes 4444.
export_nameSTRINGdirectorName of the export folder and files.
light_scaleoptFLOAT1.000.25–1Render size of light layers in the frames (1 = the frame size). 0.5 is 2-3x faster with softer shadows; the export always uses 1.

Outputs (9)

NameTypeDescription
framesIMAGEEvery frame of the timeline (or the still with frames off).
fpsFLOATFrames per second of the timeline.
audioAUDIOThe timeline's sound, trimmed to its length (silence without one).
reportSTRINGFrames rendered (or reused from the last run), size and time, and the export folder.
folderSTRINGThe export folder (full path); empty when nothing was exported.
filesSTRINGWhat the export wrote, one full path per line: the video file, or for a PNG sequence the folder of frames and the .wav. Empty when nothing was exported.
frame_countINTFrames of the timeline (its length x fps); 1 while there is no composition.
projection_maskMASKThe building's silhouette at the size of the frames output (1 = building; all ones when the director's projection mask is off).
documentSTRINGThe director's composition document (JSON), passed through: straight into kubakub keyframe clips (h3).