ComfyUI Extension: ComfyUI-ExtraLinks
A one-click collection of alternate connection styles for ComfyUI.
Custom Nodes (0)
README
A one-click collection of alternate connection styles for ComfyUI.
<div align="center"> <img width=400 height=190 src="imgs/curved.png"> <img width=400 height=190 src="imgs/rounded.png"> </div> <div align="center"> <img width=800 src="imgs/extralinks_example.gif"> </div>
Requirements
ComfyUI frontend: ≥ 1.27.1 (new link renderer API)
On older ComfyUI versions, use ExtraLinks v0.0.2 (see Compatibility).
Installation
Git Clone
cd ComfyUI\custom_nodes
git clone https://github.com/edoardocarmignani/extralinks.git
Restart ComfyUI.
ComfyUI Manager
Go to Custom Nodes Manager and search for Extra Links, install and restart ComfyUI.
Comfy CLI
comfy node install extralinks
Restart ComfyUI.
Usage
Open Settings → Extra Links and configure:
- Enable: toggle on/off
- Shape:
Curved
|Rounded
- Radius: corner smoothing
- Offset: horizontal separation for multi-outputs
- Curvature: strength of turn-in/out
Changes apply immediately to the canvas.
Compatibility
| ExtraLinks version | ComfyUI frontend | Notes |
|--------------------|------------------|-------|
| 1.0.0+ | ≥ 1.27.1 | Uses new drawLinkPath
API |
| 0.0.2 | < 1.27.1 | Legacy renderLink
patch |
Staying on an older ComfyUI? Keep using v0.0.2 (see legacy tag/releases).
Troubleshooting
- Only the center dot appears
Likely start/end were read as arrays. Ensure you’re on v1.0.0+; we read{x,y}
points. - No lines drawn
Check DevTools Console for warnings from ExtraLinks; verify ComfyUI is ≥ 1.27.1. - After toggling Enable nothing changes
Try reloading the page; ensure there’s no other extension overriding link rendering.
If issues persist, please open an issue with:
- ComfyUI frontend commit/date
- Browser + OS
- A screenshot / brief recording
- Console logs (copy/paste)
Versioning & Releases
- 1.0.0 — Migration to new ComfyUI link renderer (breaking: drops < 1.27.1).
See
CHANGELOG
for details.
Tags:
v1.x.y
→ current series.v0.0.2
→ legacy (for older ComfyUI).
Development
- Main code lives in
extralinks/web/ExtraLinks.js
- Settings/registration live in
extralinks/web/extralinks_register.js
- Python exposes
WEB_DIRECTORY
viaextralinks/__init__.py
Typical flow:
# edit JS files
# reload ComfyUI browser tab
# watch console for "[Extra Links]" logs
Optional Runtime guard:
const ok = app?.canvas?.linkRenderer?.pathRenderer?.drawLinkPath;
if (!ok) {
console.warn("[ExtraLinks] Requires ComfyUI frontend >= 1.27.1");
}
License
MIT (see LICENSE
)
Credits
- Built by @edoardocarmignani
- Thanks to the ComfyUI community for the incredible work