Nodes/ComfyUI-Keyframed/KfDebug_Curve
ComfyUI Node

KfDebug_Curve

What's actually in that curve, straight to the console

By dmarx·Created 3 years ago·Updated 2 years ago· 92
KfDebug_Curve
  • item
  • KEYFRAMED_CURVE
labeldebugging passthrough

Every node in this pack hands around KEYFRAMED_CURVES, and a curve is a small black box: you build it, you combine it, and you mostly find out what's in it by plotting it or by noticing your animation is wrong. KfDebug_Curve is the quick-and-dirty alternative - a passthrough that prints the curve's structure to the ComfyUI console and returns the same curve untouched. When you want to know "did this arithmetic produce the keyframes I think it did" without opening a plot, this is the node.

It's from the pack's debug family, which are all the same passthrough inspection pattern with different types. For curves specifically, the honest thing to say is that KfCurveDraw (the plotting node) is usually the more informative tool - a picture beats a console dump for understanding a curve's shape. But the debug node has one advantage: it's a passthrough, so you can leave it embedded in a live wire permanently without affecting anything, and it tells you structural facts (how many entries, what labels, what the parameter set looks like) that a plot hides.

How it works

It logs the curve's type, then walks its structure - the debug routine handles objects that expose keys() or items, lists, tuples, and tensor-like shapes. For a keyframed Curve, the interesting output is the parameter/structure information that gets printed: the keyframes and any label attached. It also prints the object itself, which for a curve can show you the underlying keyframe mapping. All of it is tagged with your label input in the console.

The inputs

  • item (required) - the KEYFRAMED_CURVE to inspect.
  • label (default "debugging passthrough") - the tag that appears in the log so you can find this node's output among several.

The output

KEYFRAMED_CURVE - the identical curve, passed through, so you can splice this node into any curve wire without changing behavior.

How to install it

Part of ComfyUI-Keyframed: ComfyUI Manager → search ComfyUI-Keyframed, or

cd ComfyUI/custom_nodes
git clone https://github.com/dmarx/ComfyUI-Keyframed

then restart ComfyUI. No models; the dependency is keyframed (plus toolz), auto-installed on first import.

Troubleshooting

Console, not UI - that's the one rule for the whole debug family, and it's the first thing people miss. If you want the shape of the curve as a picture, you're better served by KfCurveDraw; this node is for structure and labels. And a practical tip: since it's a passthrough, you can leave it on the wire while you debug upstream arithmetic, then delete it without touching anything else in the graph - which is exactly how the pack's author clearly intended these to be used.

Categorykeyframed/debug

Inputs (2)

NameTypeDefaultDescription
itemKEYFRAMED_CURVE
labelSTRINGdebugging passthrough

Outputs (1)

NameTypeDescription
KEYFRAMED_CURVEKEYFRAMED_CURVE