Nodes/Shibiko AI ComfyUI Tools/Shibiko AI - BBOX Split
ComfyUI Node

Shibiko AI - BBOX Split

The boring box unpacker that unblocks your layout math

By Shibiko-AI·Created 2 years ago·Updated 8 months ago· 13
Shibiko AI - BBOX Split
  • bbox
  • x
  • y
  • width
  • height

Some nodes are stars; this one is the adapter cable. BboxSplit takes a BBOX and hands you its four parts as separate integers: x, y, width, and height. That's the entire job, and it's exactly what you need the moment a bounding box lands in your workflow and you want to do arithmetic on it.

Say Cascade detects a face and hands you a BBOX, but what you actually want is the center of that face - or to grow the box by 20% before cropping, or to check whether the detected region is inside the frame. You can't add to a box object directly; you need its numbers. Split them out, run them through a math node or a text node, and feed the result into a crop, a mask builder, or a composite. The two BBOX nodes in this pack are designed to work as a pair: Cascade emits, BboxSplit unpacks, BboxInsertImage puts something back.

How it works

There's no real mechanism to explain - it's a one-liner:

x, y, width, height = bbox[0]

It unpacks the first box in the list and returns the four values. BBOX in ComfyUI is a list-of-boxes format (each box being [x, y, width, height]), so the [0] indexing takes the first one. If your BBOX carries multiple detections, this node only looks at the first - pair it with something that selects a single box if that matters.

Inputs and outputs

  • bbox - the only input, a BBOX.
  • Outputs: x, y (the top-left corner), width, height.

Four INT sockets out, all standard ComfyUI integers, so they plug into anything that accepts an int: image dimensions, crop nodes, math, string formatting.

Install

It's part of the Shibiko AI ComfyUI Tools pack:

cd ComfyUI/custom_nodes
git clone https://github.com/Shibiko-AI/ShibikoAI-ComfyUI-Tools

Or ComfyUI Manager → "Shibiko", then restart. No dependencies beyond what the pack installs, no models, nothing to go wrong - which, honestly, is the point. It's a utility you'll forget you're using until the day you're grateful it exists.

CategoryShibiko AI

Inputs (1)

NameTypeDefaultDescription
bboxBBOX

Outputs (4)

NameTypeDescription
xINT
yINT
widthINT
heightINT