VRGDG Load Audio Split (General)
The workhorse chunker that turns one song into a queue of scenes
- audio
- trigger
- meta
- total_duration
- index
- frames_for_ltx
- start_time
- end_time
- instructions
- total_sets
- frames_per_scene
- preroll_frames
- audio_meta
- output_folder
- overwrite_mode
- audio
- signal_out
This is the node that makes a full music video actually finish on a consumer GPU. VRGDG_LoadAudioSplit_General takes a loaded audio track, chops it into scenes of a fixed length, and - here's the important part - manages them as a queue of work batches so you're never trying to render a whole song in one shot. Instead of one giant video job that OOMs your card, you get a series of per-scene jobs with state tracked between them.
That's the "set" system you'll see scattered across this pack's outputs: the pipeline runs in sets, writes intermediate results to disk, and lets you resume. Long-form video generation in ComfyUI is a marathon, and this node is the pace car.
What it does
The inputs that matter:
- audio (
AUDIO) - the loaded track (wire it from a loader likeVRGDG_LoadAudioWithPath). - trigger (
*) - an any-type kick to advance to the next scene/set. - scene_duration_seconds (
FLOAT) - the fixed scene length. This is the uniform-grid splitter, so every scene is this long (unless you override below). - fps (
INT, default 24) - used to compute frame counts for the LTX side. - folder_path (
STRING, defaultVRGDG_Video) - where per-scene outputs go. - enable_auto_queue (
BOOLEAN, defaulttrue) - auto-advance through the sets. Turn it off to step through manually while you debug. - override_chunk_index (
INT, default -1) - start from a specific chunk instead of the beginning; your resume mechanism. - overwrite_mode (enum
overwrite/backup) - whether rerunning a scene replaces it or keeps a copy. - use_humo_alignment (
BOOLEAN, defaultfalse) - flip on when the target workflow is HUMO-aligned scene generation. - List_of_Scene_durations (
FLOAT, default 0) and manual_total_sets (INT, default 0) - escape hatches for non-uniform scene lengths and manually capping how many sets run.
Outputs: meta (DICT) and audio_meta (DICT) carry the scene state; index, total_sets, start_time, end_time, instructions, frames_for_ltx, frames_per_scene, and preroll_frames describe the current scene and how to render it; audio (AUDIO) passes the current scene's audio through; signal_out (*) chains to the next stage; output_folder and overwrite_mode report where things are landing.
How it fits the pipeline
The flow is: splitter produces the current scene's slice, downstream nodes generate the video for that slice, and the signal_out/trigger loop advances to the next scene. The instructions string is where the per-scene direction (lyrics, motion notes) gets composed for the LLM. Because every scene's metadata and audio come out as proper typed outputs, you can build one self-contained "render one scene" subgraph and let the queue call it N times.
Installing it
Part of the comfyui-vrgamedevgirl pack. ComfyUI Manager: search "vrgamedev", install, restart. Or:
cd ComfyUI/custom_nodes
git clone https://github.com/vrgamegirl19/comfyui-vrgamedevgirl
then install the README's requirements - librosa is here for the audio work:
pip install -r custom_nodes/comfyui-vrgamedevgirl/requirements.txt
If it's not working
- It stops halfway - check
enable_auto_queue. Off means it waits for a manual nudge on every scene. On is the setting you want for unattended runs. - A rerun clobbered good output - switch
overwrite_modetobackup. The default isoverwrite, which is exactly what you want during iteration and exactly wrong when you're happy with a scene. - It restarts from scratch - use
override_chunk_indexto resume from the scene that failed instead of replaying the whole queue. - Scenes mistimed for the video model - if you're on the HUMO path,
use_humo_alignmentis the switch you forgot to flip.
Inputs (11)
| Name | Type | Default | Description |
|---|---|---|---|
| audio | AUDIO | — | |
| trigger | * | — | |
| scene_duration_seconds | FLOAT | — | |
| fps | INT | 24 | — |
| folder_path | STRING | VRGDG_Video | — |
| enable_auto_queue | BOOLEAN | true | — |
| override_chunk_index | INT | -1 | — |
| overwrite_mode | COMBO | 2 options: overwrite, backup | |
| use_humo_alignment | BOOLEAN | false | — |
| List_of_Scene_durations | FLOAT | 0.00 | — |
| manual_total_sets | INT | 0 | — |
Outputs (15)
| Name | Type | Description |
|---|---|---|
| meta | DICT | — |
| total_duration | FLOAT | — |
| index | INT | — |
| frames_for_ltx | INT | — |
| start_time | STRING | — |
| end_time | STRING | — |
| instructions | STRING | — |
| total_sets | INT | — |
| frames_per_scene | INT | — |
| preroll_frames | INT | — |
| audio_meta | DICT | — |
| output_folder | STRING | — |
| overwrite_mode | STRING | — |
| audio | AUDIO | — |
| signal_out | * | — |