Files

56 lines
2.0 KiB
Markdown

# ⏸️ FreezeFrame (Pausable Sampler)
A custom sampler node for [ComfyUI](https://github.com/comfyanonymous/ComfyUI) that allows you to **Pause** generation mid-cycle and **Resume** it.
Useful for inspecting intermediate steps, managing GPU/CPU heat, or simply halting a long render without losing progress. This is particularly useful if you are on older hardware that causes gens to be longer than a minute.
This is a rebuild of the KSampler and Advanced KSampler and simply inserts a listener, signaler, and a trigger into the loop, effectively creating a "trap." There is a running loop that loops back around after each step is performed. all this does is tell the loop to wait while the state is "paused."
<img width="485" height="515" alt="image" src="https://github.com/user-attachments/assets/e51cfd23-1c37-4132-ac53-88f43d8f9f27" />
---
## ✨ Features
* **🛑 Live Pause/Resume:** Hit "PAUSE" mid-generation to hold the current state. The process stays alive in RAM.
---
## ⚠️ Important Note
**Changes made during a Pause do NOT affect the current run.**
If you pause and change the CFG slider, the current generation will finish using the *original* CFG value. The new settings will only apply to the **next** job you queue.
---
## 📦 Installation
1. Navigate to your ComfyUI `custom_nodes` directory:
```bash
cd ComfyUI/custom_nodes/
```
2. Clone this repository:
```bash
git clone [https://github.com/YourUsername/ComfyUI-Pause.git](https://github.com/YourUsername/ComfyUI-Pause.git)
```
3. **Restart ComfyUI.**
---
## 🛠️ The Nodes
### 1. ⏸️ Pausable Sampler (Standard)
A drop-in replacement for the standard KSampler.
* **How to use:** Connect it exactly like a normal KSampler.
* **Controls:** Adds "PAUSE" and "RESUME" buttons directly on the node.
### 2. ⏸️ Pausable Sampler (Advanced)
A drop-in replacement for KSampler (Advanced).
* **Extra Features:** Exposes `add_noise`, `start_at_step`, `end_at_step`, and `return_with_leftover_noise` for complex workflows.
---
## 📜 License
MIT License.