Easy Pattern (Koolook)
Easy Pattern is your pipeline's test card
- images
Easy Pattern generates a batch of solid-color test images, each stamped with a per-frame number. That's it. It's a test card generator for people who are tired of squinting at identical black frames trying to figure out whether their sequence got shuffled.
The use case is debugging pipeline order. When you're wiring up a video workflow - a batch merge, a frame-insert node, a saver that numbers files - the fastest way to prove it works is to feed it frames that tell you exactly where they are. One frame says 007, the next says 008, and if your saver writes them out of order or your merge drops one, it's immediately visible. The pack frames it as "anywhere a more flexible alternative to KJNodes' ImageBatchTestPattern is needed," which is accurate.
The settings that matter
The defaults are sane, so a beginner mostly touches a few things:
- batch_size - how many frames to generate (default 81, matching the video shot length this pack defaults to everywhere).
- start_from and step - what the first frame says and how the counter advances. Step goes negative too, if you want to test backwards.
- show_text - on by default. Turn it off and you get plain solid frames.
- zero_pad - minimum digit count, so 7 becomes
007at pad 3. This is the one that makes filenames sort correctly downstream. - position, font_size, bg_color_mode / text_color_mode - cosmetic, but the color presets include a Custom option that reads
bg_color/text_coloras#RRGGBB,RRGGBB, or shorthand#RGB(the default background is a magenta-ish#C71585, because test cards should never be mistaken for real content). - prefix / suffix - text before and after the number, if you want
A_001_B.
Output is a single images batch you can feed to anything that takes IMAGE. If you need the numbers as actual metadata rather than pixels, you're looking at the wrong node - but for order-checking, pixels are exactly what you want.
Install
It ships in ComfyUI-Koolook. ComfyUI Manager → Install Custom Nodes → Git URL:
https://github.com/malkuthro/ComfyUI-Koolook.git
Or:
cd ComfyUI/custom_nodes
git clone https://github.com/malkuthro/ComfyUI-Koolook.git
Restart and it appears under Koolook/Testing. No models, no extra dependencies. It uses Pillow for the text drawing, which ComfyUI already has. And yes, the pack-wide rule still applies: install once, via one method. A second install (Manager at custom_nodes/koolook/ plus a clone at custom_nodes/ComfyUI-Koolook/) loads both on every boot and the plugin's workflow store starts corrupting until you delete one.
Common issues
- Text clipped -
font_sizeis bigger than the image width; the tooltip calls it out. Drop the font size or widen the frame. - Frames out of order downstream - check
zero_pad. Without it,9sorts after10in most file managers. Pad to the same width as your shot length. - You expected a grid or gradient - this is solid-color only. It's a sequence test card, not a camera test chart. For that you want an actual test-pattern node.
Inputs (15)
| Name | Type | Default | Description |
|---|---|---|---|
| batch_size | INT | 811–4096 | Number of test-pattern images to generate. |
| width | INT | 51216–8192 | Output image width. |
| height | INT | 51216–8192 | Output image height. |
| bg_color_mode | COMBO | Custom | Background color preset. Custom reads bg_color. |
| show_text | BOOLEAN | true | Draw the generated frame number text on each image. |
| text_color_mode | COMBO | White | Text color preset. Custom reads text_color. |
| start_from | INT | 10–999999 | Number shown on the first generated frame. |
| step | INT | 1-1000–1000 | Number added for each next frame. Negative values count backward. |
| font_size | INT | 2568–1024 | Text size. Very large values may clip if the label is wider than the image. |
| position | COMBO | center | Where to place the text label. |
| zero_pad | INT | 00–8 | Minimum digit count. 7 with padding 3 becomes 007. |
| bg_coloropt | STRING | #C71585 | Custom background color as #RRGGBB, RRGGBB, or #RGB. |
| text_coloropt | STRING | #FFFFFF | Custom text color as #RRGGBB, RRGGBB, or #RGB. |
| prefixopt | STRING | Text added before the generated number. | |
| suffixopt | STRING | Text added after the generated number. |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| images | IMAGE | — |