Nodes/ComfyUI-LightQueueCounter/Light Queue Counter Set Title
ComfyUI Node

Light Queue Counter Set Title

The node whose only job is to rename itself

By ruminar·Created 4 months ago·Updated 3 months ago· 1
Light Queue Counter Set Title
    • title
    title

    Some nodes do one thing and do it well. LightQueueCounterSetTitle does exactly one thing: it takes a string, sets its own node title to that string, and hands the string back. That's the entire job - but it turns out "show this text as a node title" is a surprisingly useful primitive when you're trying to keep a busy workflow readable.

    What it is

    A display-only output node from the ComfyUI-LightQueueCounter pack. Its intended wiring, per the author, is to take the title or status output from LightQueueCounterAnyPassthrough and render it as a proper node title. But the input is just a plain STRING with no secret sauce, so it works with anything - a Text node, a prompt from some other pack, a value you built with a string concatenation node. If you can get text into it, that text becomes its title.

    How it works

    The backend run() is boring on purpose: it squashes newlines to spaces, and returns a UI payload (light_queue_counter_title and text) alongside the echoed string. The pack's web extension - a small light_queue_counter_title.js file - listens for ComfyUI's executed event and writes that payload straight into node.title. That's the whole mechanism.

    Two details matter. First, IS_CHANGED returns NaN, which tells ComfyUI to re-execute the node on every pass instead of skipping it as "unchanged." For a display node that's exactly right: you want the title re-rendered whenever upstream runs, not cached. Second, it's marked as an output node, so it never sits mid-graph blocking anything - it just does its display thing and exits.

    The input and output

    • title - required, STRING, forced input. The text that becomes the node title.
    • Output: title - STRING, the same text echoed back (newlines squashed to spaces).

    There are no optional fields here. Don't go looking for format toggles - this node is deliberately dumber than its siblings. The formatting choices (total / short / full) live on the counter nodes that generate the string; SetTitle just displays whatever arrives.

    Installing it

    Same as the rest of the pack - clone and restart, no pip step, no model downloads:

    cd ComfyUI/custom_nodes
    git clone https://github.com/ruminar/ComfyUI-LightQueueCounter.git
    

    Then restart ComfyUI, or use ComfyUI Manager and search "LightQueueCounter". Zero Python dependencies, GPL-3.0.

    Common issues

    • Stale titles when idle. The title updates only when the node executes - there's no polling timer. Leave the graph sitting there and the title holds whatever the last run produced. That's the pack-wide design, not a bug.
    • Always re-runs. Because of the NaN change-signal, it executes every pass even if nothing upstream changed. Harmless for an output node, but it means it shows up in every execution log.
    • Titles get clipped. ComfyUI truncates long node titles on the canvas, so a full format string will visually cut off. Prefer the short or total formats if you're feeding this from a counter.
    • It's display only. Don't expect the title to end up in image metadata or saved workflow output - a node title is just canvas furniture.

    For the classic use case - fold a node and read the queue count off its title bar - the pack's LightQueueCounterTitleTap does that in one node with zero wiring. SetTitle is the one you reach for when you want any text, from anywhere, rendered as a title instead.

    Categoryutils/queue

    Inputs (1)

    NameTypeDefaultDescription
    titleSTRING

    Outputs (1)

    NameTypeDescription
    titleSTRING