IO_LoadAudioBatch
Manage a list of audio files and step through them
- audio_list
- audio_index
- name_index
- index
- total
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.
Inputs (4)
| Name | Type | Default | Description |
|---|---|---|---|
| audio_list | STRING | — | |
| card_size | INT | 6464–384 | — |
| index | INT | 00–9999 | — |
| audio_list_inopt | STRING | — |
Outputs (5)
| Name | Type | Description |
|---|---|---|
| audio_list | STRING | — |
| audio_index | STRING | — |
| name_index | STRING | — |
| index | INT | — |
| total | INT | — |