Skkut Utils

ComfyUI-skkut-utils

About

ComfyUI-skkut-utils is a single-repo collection of small, practical utilities for ComfyUI. Instead of maintaining a dozen tiny custom-node repos — each with its own clone-and-install step — every utility lives here, installs together.

What's inside:

• Auto Dark mode — Auto Dark Mode keeps ComfyUI's colour palette in sync with your OS light/dark setting, in the browser and in ComfyUI Desktop.
• Timer while generating — Detailed Job Status adds a floating, draggable timer that shows how long a job has been running or ran (not queued), with final status colours.
• One settings section for everything — Settings puts the switches for the automatic utilities in a dedicated skkut-utils section of ComfyUI's Settings dialog, instead of burying them in General. Currently: Auto Dark Mode and the Job Status timer.
• Compressed WebP with metadata — Save Compressed Weppy exports compressed WebP with the prompt and workflow embedded, so dragging the image back into ComfyUI recovers the workflow that made it.
• High Resolution Aspect ration selector — Skutils Resolution Calculator turns an aspect-ratio preset and a megapixel target into exact width/height values for an Empty Latent Image, with 20 presets spanning the SD1.5, SDXL, SD3/Flux and video-model ladders.
• Resizing optional images — Skutils Scale Image to Total Pixels is the built-in Scale Image to Total Pixels node with an optional image input, so an image slot you may leave empty no longer blocks the whole workflow from queueing. <<<<<<< HEAD
• Text Preview that is saved in the workflow — Skutils Text Preview shows any output (text, boolean, number, image, latent, dict, …) converted to text right on the node and stores it as part of the saved JSON workflow, so opening the workflow again in ComfyUI (or drag & drop the respective image) brings the text back — no re-run, no external file. The built-in text preview does not save this info.
• Style picker for prompts — Skutils Style Selector is a visual picker over a bundled 434-style library (curated Clio + OreX sets, plus a hand-added style). Select one or many styles in a large searchable panel, combine them into one prompt or batch one run per style, and get finished positive/negative prompts plus a filename-ready style name. Add your own styles in the in-panel editor. =======
• Text Preview that is saved in the workflow — Skutils Text Preview shows any text output right on the node and stores it as part of the saved JSON workflow, so opening the workflow again in ComfyUI (or drag & drop the respective image) brings the text back — no re-run, no external file. The built-in text preview does not save this info.
• Style picker for prompts — Skutils Style Selector is a visual picker over a bundled 1400+ style library (curated Clio + OreX sets, u/Dear-Spend-2865, plus custom added styles). Select one or many styles in a large searchable panel, combine them into one prompt or batch one run per style, and get finished positive/negative prompts plus a filename-ready style name. Add your own styles in the in-panel editor.

bdbbce035b63bc16999e4c4e20448fec363a4c41

Design principles:

• Install once, get everything — one git clone or install from the Comfy Registry, restart, done. No build step, no config files.
• Small and self-contained — each utility is an independent subpackage with its own docs; use one, or use them all.
• Zero-config by default — features just work on startup; nothing is intrusive until you use it.

Compatible with ComfyUI in the browser and the ComfyUI Desktop app, on Windows, macOS and Linux. MIT-licensed.

Installation

1. Navigate to your ComfyUI custom nodes directory:

   cd ComfyUI/custom_nodes/
   

2. Clone this repository:

   git clone https://github.com/skkut/ComfyUI-skkut-utils.git
   

   Or install from the Comfy Registry via ComfyUI Manager (search for skkut-utils).

3. (Optional) Install the optional dependency for the Weppy EXIF writer:

   pip install -r requirements.txt
   

4. Restart ComfyUI.

No build step. Everything except the Weppy node is zero-config and activates on startup.

Available utils

| Utils | What it does | How to use | |---|---|---| | 🎨 Auto Dark Mode | Switches the ComfyUI theme to match the OS Light/Dark colour-scheme, in real time (browser + ComfyUI Desktop) | Automatic — toggle in Settings → skkut-utils | | ⏱ Detailed Job Status | Floating, draggable execution timer (MM:SS) in the UI, timed from actual execution start | Automatic — toggle in Settings → skkut-utils | | 🖼 Save Compressed Weppy | Saves images as compressed WebP with embedded prompt/workflow metadata | Add the Save Compressed Weppy node, or right-click any image → "Save Compressed Weppy" | | 📐 Skutils Resolution Calculator | Width/height from 20 aspect-ratio presets + a megapixel dropdown (0.5–5.0 MP) — like the built-in Resolution Selector, with more options | Add the Skutils Resolution Calculator node and feed width/height into an Empty Latent Image | | 🔍 Skutils Scale Image to Total Pixels | The built-in Scale Image to Total Pixels node with an optional image input — leave it unconnected and the node outputs nothing instead of failing prompt validation | Add the Skutils Scale Image to Total Pixels node wherever you resize a reference image that may not always be supplied | <<<<<<< HEAD | 📝 Skutils Text Preview | Shows any value (string, boolean, number, image/latent tensor, dict, …) as text in the node and stores it in the saved workflow JSON — reloading the workflow brings the displayed text back (no re-run). Its text input is optional; a run with no value clears the preview | Add the Skutils Text Preview node, connect any output into its text port (or leave it unconnected), run once, then save the workflow | | 🎭 Skutils Style Selector | 434 bundled styles in a searchable visual picker; multi-select, combine or batch-per-style, positive + negative output, custom styles | Add the Skutils Style Selector node, click Choose styles…, select styles, then connect its positive/negative outputs to your text encoder |

| 📝 Skutils Text Preview | Shows text in the node and stores it in the saved workflow JSON — reloading the workflow brings the displayed text back (no re-run). Its text input is optional; a run with no text clears the preview | Add the Skutils Text Preview node, connect a STRING into its text port (or leave it unconnected), run once, then save the workflow | | 🎭 Skutils Style Selector | 1400+ bundled styles in a searchable visual picker; multi-select, combine or batch-per-style, positive + negative output, custom styles | Add the Skutils Style Selector node, click Choose styles…, select styles, then connect its positive/negative outputs to your text encoder |

bdbbce035b63bc16999e4c4e20448fec363a4c41

---

🎨 Auto Dark Mode

Description. Detects the OS colour-scheme (Windows / macOS / Linux) on server startup and applies it to ComfyUI instantly, using the same palette loader as the Settings → Appearance → Color Palette menu. A background poll (every 3 s) and WebSocket push keep the UI in sync when you change the OS theme while ComfyUI is open, and a matchMedia listener covers browser-driven changes.

How to use. Nothing to configure or click — it just works. To turn it off, use Settings → skkut-utils → Features → Auto Dark Mode; disabling stops all automatic palette changes (the palette currently applied stays until you pick another one in Settings → Appearance → Color Palette). Diagnostics: look for the skkut-utils/auto-dark-mode logger in the server log (Detected OS theme: …) and [frontend] lines for browser-side events.

---

⏱ Detailed Job Status

Description. Shows a small floating widget in the bottom-right corner displaying how long the current job has been executing (not queued), in MM:SS. It appears when a run starts, ticks every second, and stays with the final status when the job finishes: Running (white) → Completed (green), Error (red), or Stopped (orange).

How to use. Nothing to configure — the timer appears automatically when a job starts. Drag it anywhere with the mouse; its position is remembered per browser between sessions. Turn it off in Settings → skkut-utils → Features → Job Status Indicator.

---

🖼 Save Compressed Weppy

Description. Saves images as compressed .webp files while embedding the ComfyUI prompt and workflow in the EXIF metadata (large base64 blobs are stripped automatically so the metadata stays within EXIF size limits). Two ways to use it:

1. Save Compressed Weppy node (Nodes → Extensions → skkut-utils) — add it to your workflow and every generated image is saved to the output directory during execution. Inputs: images, filename_prefix (default ComfyUI_Weppy), quality (1–100, default 80), lossless (default off). The prompt/workflow are captured automatically via hidden inputs.
2. Right-click any image preview → "Save Compressed Weppy" (right next to the native "Save Image" entry) — re-encodes that image and triggers a download. In ComfyUI Desktop this opens the native save dialog. The download is named after the graph when a supported node supplies one (the OreX style selector's selected style → collage_kzqrv.webp, the Clio Style Library's style → Cover_Art_kzqrv.webp, the Skutils Style Selector's selection → Anime_Style_kzqrv.webp), and ComfyUI_Weppy_<random> otherwise.

Saved files keep their metadata: drag a .webp back into ComfyUI to recover the workflow that generated it.

---

📐 Skutils Resolution Calculator

Description. Calculates width and height for your Empty Latent Image from an aspect-ratio preset and a megapixel target — the same idea as the built-in Resolution Selector node, but with 20 presets (the built-in's 8, the SD1.5/SDXL/SD3-Flux/video ladders, and ultra-wide/ultra-tall tiers) and a megapixel dropdown from 0.5 MP to 5.0 MP in 0.5 steps instead of a free float.

How to use. Add the Skutils Resolution Calculator node (Nodes → Extensions → skkut-utils), pick a preset such as 16:9 (Widescreen) and a megapixel value, and connect the width/height outputs to an Empty Latent Image. Each preset is anchored to its canonical ~1 MP resolution (e.g. 16:9 → 1344×768, the SDXL/Flux widescreen), so 1.0 MP reproduces the familiar values exactly. The advanced multiple input is a dropdown (8/16/32/64/128, default 8) — 8 divides all the others, so it works for every model family; pick 16/32/64 for Flux or video models.

---

🔍 Skutils Scale Image to Total Pixels

Description. The built-in Scale Image to Total Pixels node, with one change: its image input is optional. The widgets (upscale_method, megapixels, resolution_steps), their ranges, their defaults and the resize arithmetic are the built-in node's, so it is a drop-in replacement — but with nothing plugged into image it returns None and the workflow still queues instead of being rejected.

Why it exists. ComfyUI validates a prompt's required inputs before it runs anything, and that validation is not lazy-aware: a node with an unconnected required input fails the whole submission even when it sits on a branch nothing will ever execute — so a switch that selects the other side does not protect it. Because the built-in node's image is required (and its body has no None guard either), wiring it to an image slot you may leave empty makes the entire workflow unqueueable. A switch after the resize cannot help, and feeding it a dummy image silently changes the result. This node removes the constraint instead of working around it.

How to use. Add the Skutils Scale Image to Total Pixels node (Nodes → Extensions → skkut-utils) anywhere you would use the built-in one, and connect image. When the slot may be empty, leave it unconnected — the node then outputs None, which propagates like any other value, so put it at the end of an optional branch (autogrow image containers such as TextEncodeQwenImage21's images accept None; a plain required IMAGE input will not). See docs/scale-to-total-pixels.md for the full problem statement and the worked example.

---

📝 Skutils Text Preview

Description. Displays any connected value as text right on the node — strings as-is, booleans/numbers as text, tensors as a compact shape/dtype summary, containers pretty-printed — and, unlike the built-in display-only text-preview nodes, stores the displayed text in the saved workflow JSON. The converted text is written into the node's regular widget (via a small frontend extension), so a workflow save serializes it into the .json and a workflow load restores it: reopen the file later and the text is still there, without re-running.

How to use. Add the Skutils Text Preview node (Nodes → Extensions → skkut-utils), connect any output into its text port — a STRING, BOOLEAN, number, IMAGE, LATENT, etc. — and run the workflow once; the converted value then appears in a read-only text area in the node body. From then on, Ctrl+S — the text is part of the saved JSON (also when the workflow is embedded in an image, e.g. via Save Compressed Weppy). The text port is optional: if it is left unconnected (or the upstream value is empty), the next run clears the node body instead of failing prompt validation. Caveat: like every node's widget values, it is not included in Save (API format) JSON.

---

🎭 Skutils Style Selector

Description. A visual style picker that combines the best parts of the Clio Style Library and OreX selectors: a large searchable panel with 434 styles in 17 categories, multi-select with drag-to-reorder, positive and negative prompt output, and OreX-style batch mode (one downstream run per selected style). The library is bundled with the repo — nothing is read from other custom-node packs — and has been curated: duplicate styles removed, names normalized, sections reorganized, and every style given its own negative prompt.

How to use. Add the Skutils Style Selector node (Nodes → Extensions → skkut-utils). Connect a text node to its positive input socket (and optionally a base prompt to negative), then click Choose styles… and pick one or more styles. In the default Combine styles mode every selected style becomes one prompt; enable batch_mode to emit one positive/negative pair per style, in selection order, so the graph runs once per style. The outputs are positive, negative and a filename-safe file_name — the same name the right-click Save Compressed Weppy download uses. ＋ New style in the panel adds your own custom style (name, section, prompt, negative, optional template and image URL), stored under ComfyUI's user directory and editable/deletable later; bundled entries can be cloned. The advanced template ({name}, {style}, {prompt}) controls how the prose is wrapped.

---

Repository layout

__init__.py                    # Root aggregator (WEB_DIRECTORY, node mappings)
auto_dark_mode/                # Util: Auto Dark Mode (Python backend)
detailed_jobstatus/            # Util: Detailed Job Status (web-only)
save_compressed_weppy/         # Util: Save Compressed Weppy (node + route)
resolution_calculator/         # Util: Skutils Resolution Calculator (node)
scale_to_total_pixels/         # Util: Skutils Scale Image to Total Pixels (node)
text_preview/                  # Util: Skutils Text Preview (node + frontend)
skutils_style_selector/        # Util: Skutils Style Selector (node + library + routes)
web/                           # Frontend extensions, one file per util
scripts/                       # Dev-only generators (excluded from the registry package)
docs/                          # Per-util documentation

Each utility is documented in detail in docs/:

• docs/settings.md — the dedicated skkut-utils settings section and its feature toggles
• docs/auto-dark-mode.md — how theme detection, injection and the WebSocket push work, plus troubleshooting
• docs/detailed-jobstatus.md — event handling, completion detection, widget behaviour
• docs/save-compressed-weppy.md — node inputs, context-menu flow, EXIF metadata strategy
• docs/resolution-calculator.md — preset table, megapixel dropdown, calculation math
• docs/scale-to-total-pixels.md — the problem statement, why the built-in node's required input blocks optional slots, and how the None passthrough behaves
• docs/text-preview.md — how the displayed text is stored in the workflow JSON, what is/isn't saved
• docs/skutils-style-selector.md — picker usage, composition and batch rules, custom-style schema/storage, bundled-library sources and credits

See Agents.md for the repo conventions (layout, docs rule, how to add a util).

License

MIT