Nodes/ComfyUI-Simple_QR_Codes/🚒 CreateTextFrame
ComfyUI Node

🚒 CreateTextFrame

A QR poster card with a fixed label

By zentrocdotΒ·Created 2 years agoΒ·Updated 2 years agoΒ· 2
🚒 CreateTextFrame
  • image
  • IMAGE
β—„fg_color(255, 255, 255)β–Ί
β—„bg_color(0, 0, 0)β–Ί
β—„thickness4β–Ί
β—„frame_size40β–Ί

The QR that comes with a sign

CreateTextFrame is the opinionated one of the pack's three frame nodes. Where the solid and corner frames just decorate, this one builds an actual poster card: a fixed canvas with the text "READ ME" rendered across the bottom, and your image pasted above it. It's the node you reach for when a QR needs to be self-explanatory on a shelf, a counter, or a door - the code plus a literal instruction to scan it.

What it actually does (and the catch)

The node starts with a hardcoded 1024Γ—1408 canvas, fills it with bg_color, draws a fg_color border of thickness, and stamps "READ ME" using OpenCV's Hershey duplex font at the bottom. Then it resizes that canvas to fit your image plus the frame and pastes the image in the top portion. The result: your QR up top, "READ ME" below it, all in one output image.

Here's the catch, and it's worth knowing before you build a workflow around it: there is no text input. The label is hardcoded "READ ME" - you can change its color and thickness via fg_color and thickness, but not its content. The frame_size input nudges the padding, and that's the full extent of the controls besides image, fg_color, and bg_color. If you want "SCAN HERE" or your brand name, this isn't the node - you'd composite your own text over the output instead.

Why it's still useful

For the one job it does, it's a two-input workflow: drop in a QR from this pack, pick your two colors, hit run. The output is sized as a portrait card (the canvas is resized to width + frame_size by height Γ— 1.25 + frame_size, so the image itself gets slightly squashed into the top region) - fine for a print card, less ideal if you need precise image proportions. It's decoration, not a generator: no mask outputs, just the single framed IMAGE.

Common issues

  • "Can I change the text?" - No. Hardcoded "READ ME". Plan accordingly.
  • Image looks squashed - the 1.25Γ— height card stretches your input; account for it or crop before wiring in.
  • Colors come out gray - fg_color/bg_color must be tuple strings like "(0, 0, 0)"; the node silently falls back to gray on a parse failure.

Installing it

Part of ComfyUI-Simple_QR_Codes: ComfyUI Manager β†’ search "Simple QR Codes" β†’ install β†’ restart, or:

cd ComfyUI/custom_nodes
git clone https://github.com/zentrocdot/ComfyUI-Simple_QR_Codes
cd ComfyUI-Simple_QR_Codes
pip install -r requirements.txt

Uses OpenCV (already a pack dependency) for the text and rectangle drawing. No models to download. Find it under QR Code Nodes β†’ frames after restart.

Category🍭 QR Code Nodes/🎨 frames

Inputs (5)

NameTypeDefaultDescription
imageIMAGEβ€”
fg_colorSTRING(255, 255, 255)β€”
bg_colorSTRING(0, 0, 0)β€”
thicknessINT41–8192β€”
frame_sizeINT402–8192β€”

Outputs (1)

NameTypeDescription
IMAGEIMAGEβ€”