Nodes/D2 Nodes ComfyUI/D2 Save Audio Eagle
ComfyUI Node

D2 Save Audio Eagle

Send generated audio straight into Eagle — your library, not the output folder

By da2el-ai·Created 2 years ago·Updated 5 days ago· 66
D2 Save Audio Eagle
  • audio
  • audioUI
    filename_prefixaudoi/ComfyUI
    eagle_folder
    formatFLAC
    mp3_qualityV0
    opus_quality128k
    memo_text

    If you generate audio in ComfyUI (audio diffusion, TTS, that kind of thing), you've got the classic problem: the files land in a ComfyUI/output folder and your real library is somewhere else. D2 Save Audio Eagle is the pack's answer - it saves the audio file normally and pushes it into Eagle, the local asset manager, complete with a memo. It's the audio twin of the pack's popular D2 Save Image Eagle.

    Eagle is a desktop app (eagle.cool) that organizes images and files in a local library, and it exposes a local HTTP API. This node talks to that API on localhost:41595. So the requirement is straightforward: Eagle installed, running, and its API enabled. No cloud, no keys, no account - it's all on your machine.

    The inputs that matter

    • audio - the AUDIO tensor to save.
    • filename_prefix - the save filename (the default audoi/ComfyUI includes a subfolder). Note the typo: "audoi". It's in the shipped default.
    • eagle_folder - the destination folder inside Eagle. If it doesn't exist, the node creates it. Leave blank to skip the folder.
    • format - FLAC, MP3, or Opus.
    • mp3_quality / opus_quality - bitrate for the lossy formats (V0, 128k, 320k for MP3; 64k320k for Opus). Ignored when format is FLAC.
    • memo_text - freeform text saved into Eagle's memo field for the item. This is where you'd dump generation parameters via a D2 Filename Template or similar.

    It's an output node - no outputs, and there's an audioUI input purely so the node renders an audio player in the UI so you can listen before saving.

    How it works

    The flow: it encodes the audio to your chosen format, saves the file to the normal ComfyUI output directory, then calls Eagle's addFromPath API to register that file into the library under eagle_folder, with memo_text as the annotation. The Eagle folder is found by name, or created on the fly if missing.

    The one thing the docs call out: the file is also saved to the regular output folder. That's a double copy on disk, which matters if you generate a lot of long audio. If drive space is a concern, you'll want to periodically clear the ComfyUI output folder - Eagle already has the copy you care about.

    Installing

    Ships in the D2-nodes-ComfyUI pack - install the pack, not the node.

    • ComfyUI Manager → search "D2-nodes-ComfyUI" → Install → restart.
    • Or cd ComfyUI/custom_nodes && git clone https://github.com/da2el-ai/D2-nodes-ComfyUI and restart.

    Dependencies are light (piexif, charset-normalizer); no model downloads. Pack gotcha: v32.0.0+ needs the newer ComfyUI V3 schema; older ComfyUI → use a pre-32.0.0 release.

    Troubleshooting

    The most common failure is Connection refused or silence from Eagle - that's almost always Eagle not running, or the local API port being off. Open Eagle, make sure the API is enabled in its settings, and retry. If Eagle is running but files don't show up, check that eagle_folder doesn't contain a typo; the node will happily create a folder with whatever name you give it. And if you get an error about the audio format, remember mp3_quality and opus_quality only apply to their respective formats - a weird bitrate string in the wrong field won't break FLAC, but it will break that one format.

    CategoryD2/Audio

    Inputs (8)

    NameTypeDefaultDescription
    audioAUDIO
    filename_prefixSTRINGaudoi/ComfyUI
    eagle_folderSTRING
    formatCOMBOFLAC3 options: FLAC, MP3, Opus
    mp3_qualityCOMBOV03 options: V0, 128k, 320k
    opus_qualityCOMBO128k5 options: 64k, 96k, 128k, 192k, 320k
    memo_textSTRING
    audioUIAUDIO_UI

    Outputs (0)

    No outputs