DEPRECATED - VRGDG Overlap Meta Batch Manager

If you've loaded an older VRGameDevGirl video-enhance workflow and seen a node called "DEPRECATED – VRGDG Overlap Meta Batch Manager" staring back at you, this is the article that tells you what it was and what to replace it with. The short version: it was the pack's early attempt at a batch manager for overlap-aware long-video processing, and it stopped working the moment VideoHelperSuite (VHS) changed how it requeues batches. The author kept it in the pack so old canvases still load and display a migration story instead of vanishing, but you should not put it in a new workflow.

Why it broke (this is the actual reason, not a vague "outdated")

The overlap rig needs the ability to run the same workflow repeatedly, each time feeding the next chunk of a long video - that's the "meta batch" concept. VHS does this by requeueing its own manager node. The catch, which the node's own description states bluntly: VHS only requeues its native VHS_BatchManager class. This node shipped its own duck-compatible imitation of a BatchManager - it had the same fields and looked right on the wire, but it wasn't the class VHS recognized, so VHS would never requeue it. The pipeline would process one batch and stop, or behave unpredictably across runs.

Rather than trying to keep a private clone of VHS's internals in sync forever, the author refactored: use VHS's real manager for the requeue machinery, and let VRGDG nodes decorate it with overlap state instead of pretending to be it. That refactor is why you now have three clean nodes (Preset / Window / Blend) instead of this one all-in-one.

What it used to do

For context, it took the same inputs the new VRGDG Overlap Preset takes - preset (H3 Near 41, H3 Balanced, H3 Trained, Custom H3), custom_window, custom_overlap, blend_mode - and output a VHS_BatchManager plus window, overlap, stride INTs. It tried to be both the config node and the manager. That combination is exactly what turned out to be unsustainable.

What to use instead

The replacement is two nodes doing one job each, and they're the current state of the pack's overlap tooling:

1. VRGDG Overlap Preset - validates your H3 window settings (window must follow 17n+5, overlap under half the window) and outputs stride, which you wire into the standard VHS Batch Manager's frames_per_batch. It also emits overlap_config for the Window node.
2. VRGDG Build Overlap Window - takes the real VHS manager plus that config and builds each model input window with overlap context.
3. VRGDG Blend Overlap Output - on the output side, crossfades the duplicated regions and emits every source frame once.

So an old workflow containing this node needs a small rewrite: delete it, add the standard VHS Batch Manager (VideoHelperSuite), wire VRGDG Overlap Preset into it as described, then route through Build Overlap Window → your model → Blend Overlap Output. The preset article walks through the full wiring.

Install

In case you're starting fresh and only saw this node inside a downloaded workflow:

cd ComfyUI/custom_nodes
git clone https://github.com/vrgamegirl19/comfyui-vrgamedevgirl.git

or ComfyUI Manager → search "VRGameDevGirl" → install → restart → hard-refresh the browser. You'll also want VideoHelperSuite installed (search it in Manager) since the standard VHS Batch Manager is now the backbone of these workflows. Standard pack caveats: the requirements list is heavy (kornia, librosa, transformers, voxcpm, llama-cpp-python, …); on Windows portable, pip install Cython scikit-build-core first and prefer Python 3.12.

One honest note

Keeping a visibly deprecated node in the pack is actually the good pattern - some packs just delete the node and leave everyone with workflows that error on load. Here the old canvas loads, shows you a clear warning, and points at the migration path. If you're building fresh, reach for the current trio and don't look back. If you're fixing an old workflow, the swap is mechanical and takes about two minutes.