Nodes/ComfyUI-Apt_Preset/IO_LoadAudioBatch
ComfyUI Node

IO_LoadAudioBatch

Manage a list of audio files and step through them

By cardenluo·Created 2 years ago·Updated 22 days ago· 309
IO_LoadAudioBatch
    • audio_list
    • audio_index
    • name_index
    • index
    • total
    audio_list
    card_size64
    index0
    audio_list_in

    Part of a small family of "visualization batch loading" nodes this pack added specifically to make managing a pile of inputs less of a chore - the same idea shows up for images, text, video, and shot data. IO_LoadAudioBatch is the audio one: it holds a list of audio file paths, shows them as a scrollable strip of cards inside the node, and lets you both pull the whole list and step through it one at a time with an index.

    How it works

    audio_list is where the paths live - one entry per line, typed in or built up in the widget. card_size (64–384, default 64) controls how big the visual cards are in the node's UI; it's purely cosmetic, not a functional setting. index (0–9999) picks which entry is "current" for the single-pick outputs. There's also an optional audio_list_in input, typed STRING, that lets you feed the list in from somewhere else instead of typing it - a natural pairing is IO_PathProcessor, whose NewPathList output is the same STRING-list shape, if you want regex filtering or sorting applied to the audio paths before they land here.

    One detail worth knowing up front: this node manages paths, not decoded audio. audio_list, audio_index, and name_index are all STRING types - you still need something downstream that actually reads the file at that path into an AUDIO object. Think of this node as the file-browser layer, not the decoder.

    Inputs and outputs

    • audio_list - the multiline list of file paths.
    • card_size - visual card size, cosmetic only.
    • index - which entry is currently selected.
    • audio_list_in (optional) - feed the list in from an upstream STRING-list node instead of typing it.

    Outputs: audio_list (the full STRING list), audio_index and name_index (the currently-selected path and filename), plus index and total so a downstream loop knows where it is.

    How to install it

    ComfyUI Manager → search ComfyUI-Apt_Preset, install, restart. Manually:

    cd ComfyUI/custom_nodes
    git clone https://github.com/cardenluo/ComfyUI-Apt_Preset.git
    

    then run install.bat for dependencies - it's a Windows batch file, so on Linux/macOS run the pip install lines inside it yourself - and restart ComfyUI.

    Common issues & troubleshooting

    Expecting an AUDIO output and getting a string. This is the most common trip-up with this whole batch-loader family: the node organizes and steps through paths, it doesn't decode media. Wire audio_index into whatever your actual audio-loading node expects as a path input.

    The gallery widget looks broken or won't render. Custom in-node canvas/gallery widgets like this one are exactly the kind of thing ComfyUI's ongoing frontend rewrite ("Nodes 2.0") has been known to break for various packs during the transition - if the card view goes blank after a ComfyUI update, try the legacy frontend before assuming the node itself is at fault.

    IMPORT FAILED at startup. There's at least one reported case of this pack failing to import on a stock install - usually because the install.bat dependency step got skipped, which is easy to do off Windows. Check the console for the actual missing package name.

    CategoryApt_Preset/IO_Port/batch_input

    Inputs (4)

    NameTypeDefaultDescription
    audio_listSTRING
    card_sizeINT6464–384
    indexINT00–9999
    audio_list_inoptSTRING

    Outputs (5)

    NameTypeDescription
    audio_listSTRING
    audio_indexSTRING
    name_indexSTRING
    indexINT
    totalINT