commit 3ceb733757d74a77fa3876dffc314759d66282bb Author: loficoding Date: Fri Jan 23 03:55:28 2026 -0700 Many fixes. Almost a fresh start. diff --git a/LICENSE.txt b/LICENSE.txt new file mode 100644 index 0000000..63b4b68 --- /dev/null +++ b/LICENSE.txt @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) [year] [fullname] + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..f4c853c --- /dev/null +++ b/README.md @@ -0,0 +1,86 @@ +# ComfyUI Node HUD 🛠️ + +**Stop the spaghetti. Keep the data.** + +A lightweight UI extension for [ComfyUI](https://github.com/comfyanonymous/ComfyUI) that adds a smart "Heads-Up Display" (HUD) to your nodes. It allows you to stack nodes behind one another to clean up your workspace, while still seeing exactly what is happening inside the stack via a sleek, tinted-glass dock. + +![Demo GIF](mainuse.gif) + +## ✨ Features + +### 1. Hiding Nodes +Hide utility nodes (like String Primitives, Notes, or multiple LoRAs) behind a single "Parent" node. Clean Layout Dock detects these hidden nodes and generates a live status bar attached to the bottom of the parent. + +### 2. Smart I/O Indicators 🚦 +No more guessing if a hidden node is connected. The dock displays **Smart Dots** that visualize the data flow: +* **Left Dots (Inputs):** Shows active incoming connections. +* **Right Dots (Outputs):** Shows active outgoing data. +* **Color Coded:** The dots match ComfyUI's standard wire colors: + * 🟣 **Purple:** Model + * 🟡 **Yellow:** CLIP + * 🔴 **Red:** VAE + * 🌸 **Pink:** Latent + * 🔵 **Blue:** Image + * 🟢 **Green:** String / Text + +### 3. Live Status Feedback +The dock updates in real-time to reflect the state of your nodes: +* **Active:** Green text / Standard border. +* **Muted:** Gray border & dimmed text. +* **Bypassed:** Purple border. +* **Disconnected:** If a node has no active inputs or outputs, a red error dot 🔴 appears. + +### 4. "Tinted Glass" UI +The dock uses a semi-transparent dark background (85% opacity) to ensure readability without feeling "heavy" or blocking the grid entirely. + +--- + +## 📥 Installation + +### Method 1: Manager (Coming Soon) +*Once indexed, you can install this via the ComfyUI Manager.* + +### Method 2: Manual Install +1. Navigate to your ComfyUI `custom_nodes` directory: + ```bash + cd ComfyUI/custom_nodes/ + ``` +2. Clone this repository: + ```bash + git clone https://github.com/loficoding/ComfyUI-Node-HUD.git + ``` +3. **Restart ComfyUI**. + +--- + +## 🖱️ Usage + +1. **Stack Your Nodes:** Drag utility nodes (like *Primitive* or *Note*) physically behind a larger "Parent" node (like *Prompt Manager* or *KSampler*). +2. **Activate the Dock:** + * Right-click the Parent Node. + * Select **"Toggle Stack Info"** from the menu. +3. **That's it!** The dock will appear. If you move the nodes out from behind the parent, the dock updates instantly. + +--- + +## 🎨 Color Legend + +| Color | Meaning | +| :--- | :--- | +| 🟣 | **Model** (Checkpoint / LoRA) | +| 🟡 | **CLIP** (Conditioning) | +| 🔴 | **VAE** | +| 🌸 | **Latent** | +| 🔵 | **Image** | +| 🟢 | **String** / Text | +| 🔴 (Solid) | **Error** / Disconnected | + +--- + +## 🤝 Contributing + +This extension is pure JavaScript. Feel free to submit PRs for new features or styling tweaks! + +## 📄 License + +MIT License. \ No newline at end of file diff --git a/__init__.py b/__init__.py new file mode 100644 index 0000000..d038001 --- /dev/null +++ b/__init__.py @@ -0,0 +1,2 @@ +WEB_DIRECTORY = "./web" +__all__ = ["WEB_DIRECTORY"] \ No newline at end of file diff --git a/mainuse.gif b/mainuse.gif new file mode 100644 index 0000000..4167dd6 Binary files /dev/null and b/mainuse.gif differ