Batch Processor- Unlimited sequences within a single JSON file - Import settings from any file or history entry - Per-shot custom keys (e.g. Shot 1: `fog: 0.5`, Shot 2: `fog: 0.0`) - Clone, reorder, and manage sequences visually - Conflict protection against external file modifications - Snippet library for reusable prompt fragments |
|
Visual Timeline- Git-style branching with horizontal node graph - Non-destructive: forking on old-version edits preserves all history - Visual diff highlighting changes between any two versions - Restore any past state with one click |
Dynamic Node (New)- Auto-discovers all JSON keys and exposes them as outputs - No code changes needed when JSON structure evolves - Preserves connections when keys are added on refresh - Native type handling: `int`, `float`, `string` |
### Dynamic Node The **JSON Loader (Dynamic)** node reads your JSON file and automatically creates output slots for every key it finds. No code changes needed when your JSON structure evolves. **How it works:** 1. Enter a `json_path` and `sequence_number` 2. Click **Refresh Outputs** 3. Outputs appear named after JSON keys, with native types preserved
**Type handling:** Values keep their native Python type — `int` stays `int`, `float` stays `float`, booleans become `"true"`/`"false"` strings, everything else becomes `string`. The `*` (any) output type allows connecting to any input. **Refreshing is safe:** Clicking Refresh after adding new keys to your JSON preserves all existing connections. Only removed keys get disconnected. ### Standard & Batch Nodes | Node | Outputs | Use Case | |:---|:---|:---| | **JSON Loader (Standard/I2V)** | prompts, flf, seed, paths | Single-file I2V workflows | | **JSON Loader (VACE Full)** | above + VACE integers | Single-file VACE workflows | | **JSON Loader (LoRAs Only)** | 6 LoRA strings | Single-file LoRA loading | | **JSON Batch Loader (I2V)** | prompts, flf, seed, paths | Batch I2V with sequence_number | | **JSON Batch Loader (VACE)** | above + VACE integers | Batch VACE with sequence_number | | **JSON Batch Loader (LoRAs)** | 6 LoRA strings | Batch LoRA loading | | **JSON Loader (Custom 1/3/6)** | 1, 3, or 6 string values | Manual key lookup by name | --- ## Web Interface Usage Navigate to your container's IP (e.g., `http://192.168.1.100:8080`). **Path navigation** supports case-insensitive matching — typing `/media/P5/myFolder` will resolve to `/media/p5/MyFolder` automatically. - **Custom Parameters:** Scroll to "Custom Parameters" in any editor tab. Type a key and value, click Add. - **Timeline:** Switch to the Timeline tab to see version history as a graph. Restore any version, and new edits fork a branch automatically. - **Snippets:** Save reusable prompt fragments and append them with one click. --- ## JSON Format ```jsonc { "batch_data": [ { "sequence_number": 1, "general_prompt": "A cinematic scene...", "negative": "blurry, low quality", "seed": 42, "flf": 0.5, "camera": "pan_left", "video file path": "/data/input.mp4", "reference image path": "/data/ref.png", "my_custom_key": "any value" // ... any additional keys are auto-discovered by the Dynamic node } ] } ``` --- ## File Structure ``` ComfyUI-JSON-Manager/ ├── __init__.py # ComfyUI entry point, exports nodes + WEB_DIRECTORY ├── json_loader.py # All ComfyUI node classes + /json_manager/get_keys API ├── web/ │ └── json_dynamic.js # Frontend extension for Dynamic node (refresh, show/hide) ├── main.py # NiceGUI web UI entry point & navigator ├── state.py # Application state management ├── utils.py # I/O, config, defaults, case-insensitive path resolver ├── history_tree.py # Git-style branching engine ├── tab_batch_ng.py # Batch processor UI (NiceGUI) ├── tab_timeline_ng.py # Visual timeline UI (NiceGUI) ├── tab_comfy_ng.py # ComfyUI server monitor (NiceGUI) ├── tab_raw_ng.py # Raw JSON editor (NiceGUI) └── tests/ ├── test_json_loader.py ├── test_utils.py └── test_history_tree.py ``` --- ## License [Apache 2.0](LICENSE)