ComfyUI Extension: ComfyUI-ExtraLinks

Authored by edoardocarmignani

Created

Updated

4 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 SettingsExtra 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