nodes/thomaskippster-comfymodeldownloader
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Docs: Update README with detailed English documentation

Browse Source
This commit is contained in:
Thomas
2026-04-18 19:18:53 +02:00
parent ca789d361e
commit 19d7eb98e3
1 changed files with 50 additions and 30 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+50 -30
View File
@@ -1,39 +1,59 @@
# ComfyUI Model Download Manager
A robust Java Swing application to identify and download missing models for ComfyUI workflows.
A robust, feature-rich Java Swing application designed to automate the process of identifying and downloading missing models for ComfyUI workflows. It bridges the gap between sharing a JSON workflow and having a fully functional local setup.
## Features
- **Advanced JSON Parsing**: Recursively scans ComfyUI JSON workflows (including subgraphs and `widgets_values`) for model filenames.
- **Model Metadata Support**: Detects and uses embedded model download metadata (URLs, directories).
- **Download Manager**:
- **Resume Capability**: Uses HTTP Range requests to resume interrupted downloads.
- **Pause/Resume/Stop**: Full control over the download queue.
- **Overwrite Protection**: Prompts before overwriting existing local files.
- **Real-time Status**: Shows download speed (MB/s) and per-file progress.
- **Intelligent Sorting**: Automatically infers the correct subfolder (e.g., `checkpoints`, `loras`, `vae`) based on node types.
## 🚀 Key Features
## Requirements
- **Java 11 or higher**
- **Maven** (to build)
### 🔍 Advanced JSON Parsing
- **Recursive Traversal**: Scans deeply nested structures, including subgraphs and custom node definitions.
- **Filename Detection**: Uses smart regex to find model files (`.safetensors`, `.ckpt`, `.pt`, etc.) inside `widgets_values`, `inputs`, and other string fields.
- **Metadata Support**: Automatically detects and prioritizes embedded model metadata (standard `models` array used by ComfyUI managers).
## How to Build
1. Clone the repository.
2. Run the following command:
```powershell
### 📥 Powerful Download Manager
- **Resume Capability**: Implements HTTP Range requests to continue interrupted downloads exactly where they left off.
- **Queue Control**: Start, **Pause**, **Resume**, and **Stop** functionality for full control over your bandwidth.
- **Overwrite Protection**: Interactive dialogs prevent accidental data loss by asking to Resume, Overwrite, or Skip existing files.
- **Live Metrics**: Real-time display of download speed (MB/s), percentage progress, and a global progress bar.
### 📂 Intelligent Sorting
- **Automatic Path Mapping**: Infers the correct subdirectory (e.g., `checkpoints`, `loras`, `vae`, `controlnet`) based on node types like `LoraLoader` or `VAELoader`.
- **Customizable Base Path**: Easily set your ComfyUI models root directory.
## 🛠️ Requirements
- **Java 11** or higher
- **Maven** (for building from source)
## 🏗️ Installation & Build
1. Clone the repository:
```bash
git clone https://github.com/thomaskippster/comfymodeldownloader.git
cd comfymodeldownloader
```
2. Build the "Fat JAR" using Maven:
```bash
mvn clean package
```
3. The runnable JAR will be created in the `target/` directory:
`target/comfymodeldownloader-1.0-SNAPSHOT.jar`
## How to Use
1. Run the JAR:
```powershell
java -jar target/comfymodeldownloader-1.0-SNAPSHOT.jar
```
2. Set your ComfyUI models directory path (e.g., `C:\ComfyUI\models`).
3. Paste a ComfyUI JSON workflow or load a `.json` file.
4. Click **Analyze Models**.
5. Select the models you want to download and click **Start Queue**.
3. Locate the runnable JAR in the `target/` directory:
`comfymodeldownloader-1.0-SNAPSHOT.jar`
## License
MIT
## 📖 How to Use
1. **Launch**: Start the application via `java -jar target/comfymodeldownloader-1.0-SNAPSHOT.jar`.
2. **Setup Path**: Enter or browse to your local ComfyUI models directory (e.g., `C:\ComfyUI\models`).
3. **Provide Workflow**:
- **Paste**: Directly paste the content of your ComfyUI JSON file into the text area.
- **Load**: Use the "Load File..." button to select a `.json` file from your disk.
4. **Analyze**: Click **Analyze Models**. The table will populate with detected models and their types.
5. **Download**:
- Select models using the checkboxes.
- Click **Start Queue**.
- If a file exists, choose to **Resume** or **Overwrite**.
## 📜 License
This project is licensed under the MIT License - see the LICENSE file for details (or just use it freely!).
---
*Developed to make ComfyUI workflow sharing seamless.*