ComfyUI Extension: ComfyUI-ExtraLinks

Authored by edoardocarmignani

Created

Updated

5 stars

A one-click collection of alternate connection styles for ComfyUI.

Custom Nodes (0)

    README

    <div align="center"> <img src="imgs/extralinks_logo.png"> </div><br>

    GitHub Tag GitHub License Last Commit Issues

    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)

    👉 Open an issue

    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 via extralinks/__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