ComfyUI-CCXManager Introduction
ComfyUI-CCXManager helps keep the SD-PPP plugin in Photoshop in step with the SD-PPP nodes in ComfyUI. SD-PPP has a ComfyUI side and a Photoshop side. When one side changes, updating the other side manually can interrupt your creative workflow. This extension provides nodes that can download or use a local Photoshop plugin file, apply the update, and show progress in the ComfyUI console.
The extension can remember your settings and check for SD-PPP updates when ComfyUI restarts. It supports the Photoshop plugins for SD-PPP 1.0 and 2.0, as well as an option to update the ComfyUI-side SD-PPP nodes. The author also notes that the workflow can create a missing installation directory.
ComfyUI-CCXManager supports locally deployed ComfyUI only; it does not support cloud-based ComfyUI. The original documentation lists Photoshop version 24 or later, the SD-PPP nodes, and network access through a proxy as requirements for the online update workflow.
How ComfyUI-CCXManager Works
Think of SD-PPP as a connection between two workspaces: your ComfyUI workflow and your Photoshop plugin. ComfyUI-CCXManager helps maintain the Photoshop part of that connection when SD-PPP changes.
A .ccx file is the Photoshop plugin package that the extension uses. For a Photoshop-side update, you choose the node for SD-PPP 1.0 or 2.0, tell it where to obtain the corresponding .ccx file, and provide the appropriate destination path. The node then reports what it is doing in the ComfyUI console. You can check Photoshop afterward to confirm that the plugin is available.
The extension can also check the SD-PPP GitHub repository for changes. With automatic operation enabled, it remembers your settings after you run the node once. On later ComfyUI restarts, it checks for an update and runs the update operation only when it detects one. If you disable automatic operation, run the node once again to save that choice.
ComfyUI-CCXManager Features
Photoshop-side updates for SD-PPP 1.0 and 2.0
There are separate nodes for the SD-PPP 1.0 and 2.0 Photoshop plugins. This lets you maintain either version or use both versions alongside each other. Choose the node that matches the plugin you intend to update, and make sure its destination points to the matching installation location.
SD-PPP 1.0 destination-path example
SD-PPP 2.0 destination-path example
ComfyUI-side SD-PPP updates
A third node provides an automatic update option for the SD-PPP nodes on the ComfyUI side. This addresses the other half of the ComfyUI–Photoshop setup.
Download or use a local plugin file
The source_type setting determines where the Photoshop plugin package comes from:
urldownloads the.ccxfile from a web address. This is the recommended choice in the original documentation; you can normally leave its default address unchanged.local_pathuses a.ccxfile already on your computer. The original documentation describes this as an alternative when the network-based method is unavailable.
For a local file, the documented examples are sd-ppp_PS.ccx for SD-PPP 1.0 and sd-ppp2_PS.ccx for SD-PPP 2.0. These files are typically found in the static folder of an SD-PPP installation. The precise path depends on where SD-PPP is located on your computer.
Update source and destination settings
In url mode, source_path identifies the download address. The documented default sources are:
- SD-PPP 1.0:
https://gitee.com/zombieyang/sd-ppp/raw/main/static/sd-ppp_PS.ccx - SD-PPP 2.0:
https://gitee.com/zombieyang/sd-ppp/raw/main/static/sd-ppp2_PS.ccx
The target_path identifies the destination for the corresponding Photoshop-side plugin. The 1.0 and 2.0 nodes use different plugin files, so check that you have selected the correct node and path. If you move your installation, update the path in the node and run it again to save the change.
Choose the destination carefully. The author warns that an update clears file contents at the selected installation path. Do not point target_path at a folder containing unrelated or important files.
Update detection and automatic operation
The github_repo_url input tells the extension which repository to check for SD-PPP updates. The documented default is https://github.com/zombieyang/sd-ppp.git; you normally do not need to change it.
Set auto_run_on_restart to enable to check for updates when ComfyUI restarts, or disable to stop automatic operation. After changing either setting, run the node once so the new choice takes effect on subsequent restarts.
Console status
The extension displays operation information in the ComfyUI console. Check the console after running a node or restarting ComfyUI to see what happened, then check Photoshop to confirm the plugin is installed.
Example ComfyUI console output
Troubleshooting ComfyUI-CCXManager
The automatic update does not run after a restart
- Check that
auto_run_on_restartis set toenable. - Run the node once after changing the setting. The choice takes effect on later restarts.
- Check the ComfyUI console for status messages.
- Remember that the extension is designed to run an update only when it detects an SD-PPP change; no update may mean there is nothing new to apply.
The extension cannot check for or download an update
- Check your network connection and the documented proxy-network requirement.
- Confirm that
source_typeisurland thatsource_pathpoints to the intended.ccxfile. - Check the ComfyUI console for an error message.
- If the online method remains unavailable and you already have the correct
.ccxfile, trylocal_pathinstead.
The Photoshop plugin is missing or is not the expected version
- Confirm that you used the node for the intended SD-PPP version.
- Check that the 1.0 node uses the
sd-ppp_PSdestination and the 2.0 node uses thesd-ppp2_PSdestination. - If you changed installation locations, correct
target_pathand run the node again. - Review the console output, then check the plugin in Photoshop.
The node stops working after a ComfyUI-CCXManager update
Review the node’s inputs and reconfigure them according to its current requirements, as advised in the original documentation. Recheck paths before running an update so that unrelated files are not affected.
Frequently asked questions
Can I use this with cloud-based ComfyUI?
No. The author states that ComfyUI-CCXManager supports locally deployed ComfyUI only.
Can I use SD-PPP 1.0 and 2.0 at the same time?
Yes. The extension provides separate Photoshop-side update nodes for the two versions.
Do I need to change the default download address or repository URL?
Usually not. The original documentation recommends keeping the defaults unless your setup requires a different source.
Why did changing auto_run_on_restart have no immediate effect?
Run the node once to save the new setting. It then applies on subsequent ComfyUI restarts.
Learn More about ComfyUI-CCXManager
- ComfyUI-CCXManager project repository: Project information and issue reporting.
- SD-PPP repository: Information about the companion ComfyUI and Photoshop project.
- Chinese-language README: The author’s alternate-language documentation.
