diff --git a/calliope-backend/scripts/audit_reference_conversion.py b/calliope-backend/scripts/audit_reference_conversion.py
index 9f5c2a72..c0e5169e 100644
--- a/calliope-backend/scripts/audit_reference_conversion.py
+++ b/calliope-backend/scripts/audit_reference_conversion.py
@@ -33,6 +33,7 @@ from calliope.comfyui.serialization_reference import (
PROFILE,
REEL_PROFILE,
SEPARATION_PROFILE,
+ VHS_PROFILES,
resolve_reference_link,
serialize_case04_node,
serialize_promoted_node,
@@ -291,6 +292,7 @@ REFERENCE_PROFILES = (
*MEDIA_PROFILES,
SEPARATION_PROFILE,
*CROP_SPLIT_PROFILES,
+ *VHS_PROFILES,
)
@@ -455,10 +457,45 @@ def media_field_evidence(source, prompt, profile):
return fields
+def vhs_field_evidence(source, prompt):
+ """Re-read every final field from named source bytes or original links."""
+ fields = []
+ for i, node in enumerate(source["nodes"]):
+ nid = str(node["id"])
+ assert prompt[nid]["class_type"] == node["type"]
+ assert prompt[nid]["_meta"] == {"title": node.get("title") or node["type"]}
+ for name, value in prompt[nid]["inputs"].items():
+ socket = next(s for s in node["inputs"] if s["name"] == name)
+ if socket.get("link") is not None:
+ li, link = next(
+ (j, edge) for j, edge in enumerate(source["links"]) if edge[0] == socket["link"]
+ )
+ expected = [str(link[1]), link[2]]
+ pointer = f"/links/{li}"
+ else:
+ expected = node["widgets_values"][name]
+ pointer = f"/nodes/{i}/widgets_values/{name}"
+ assert type(value) is type(expected) and value == expected
+ fields.append(
+ {
+ "node_id": nid,
+ "class_type": node["type"],
+ "field": name,
+ "value": value,
+ "json_type": type(value).__name__,
+ "source_pointer": pointer,
+ }
+ )
+ return fields
+
+
def profile_attempt(source, profile):
- expected = {**STRUCTURE_PROFILES, **PROMOTED_PROFILES, CASE04_PROFILE: "1.53.6"}.get(
- profile, "1.37.11"
- )
+ expected = {
+ **STRUCTURE_PROFILES,
+ **PROMOTED_PROFILES,
+ CASE04_PROFILE: "1.53.6",
+ **VHS_PROFILES,
+ }.get(profile, "1.37.11")
assumptions = {
"frontend": expected,
"unmodified_frontend_and_widgets": True,
@@ -522,8 +559,20 @@ def profile_attempt(source, profile):
"separation-reference/sources.json",
*assumptions["reference_sources"],
]
+ if profile in VHS_PROFILES:
+ assumptions["vhs_reference"] = {
+ "contracts": "vhs-reference/contract.json",
+ "unmodified_pinned_plugin_and_format_files": True,
+ "extension_overrides_and_target_installation": "unknown",
+ "named_mirror": "if present, assumed inert and required equal to VHS map",
+ "array_migration": "unsupported; never fill missing fields from defaults",
+ }
+ assumptions["reference_sources"] = [
+ "vhs-reference/sources.json",
+ "serialization-evidence/sources.json",
+ ]
base = {"profile": profile, "assumptions": assumptions}
- if profile in CROP_SPLIT_PROFILES:
+ if profile in (*CROP_SPLIT_PROFILES, *VHS_PROFILES):
base["source_declarations"] = [
{
"pointer": f"/nodes/{i}",
@@ -531,32 +580,48 @@ def profile_attempt(source, profile):
}
for i, n in enumerate(source.get("nodes", []))
]
- base["verified_reference_facts"] = "crop-split-reference/verified-facts.json"
+ base["verified_reference_facts"] = (
+ "vhs-reference/contract.json"
+ if profile in VHS_PROFILES
+ else "crop-split-reference/verified-facts.json"
+ )
declared_frontend = (source.get("extra") or {}).get("frontendVersion")
assumptions["source_frontend_declaration"] = declared_frontend
+ if profile in VHS_PROFILES:
+ assumptions["vhs_reference"]["missing_frontend_policy"] = (
+ "explicit_1.37.11_reference_assumption"
+ if expected == "1.37.11"
+ else "requires_explicit_1.48.6"
+ )
assumptions["missing_frontend_policy"] = (
"explicit_media_reference_assumption"
- if profile in (*MEDIA_PROFILES, SEPARATION_PROFILE, *CROP_SPLIT_PROFILES)
+ if profile in (*MEDIA_PROFILES, SEPARATION_PROFILE, *CROP_SPLIT_PROFILES, *VHS_PROFILES)
else "explicit_legacy_reference_assumption"
if profile in (PROFILE, AUX_PROFILE, PRIMITIVE_PROFILE)
else "requires_explicit_declaration"
)
+ if profile in VHS_PROFILES and expected == "1.48.6":
+ assumptions["missing_frontend_policy"] = "requires_explicit_1.48.6"
assumptions["missing_node_declarations"] = [
n["pointer"]
for n in node_inventory(source, include_aux=profile in CROP_SPLIT_PROFILES)
if n["type"] not in ("Note", "MarkdownNote", "Reroute", "PrimitiveNode")
and (n["provider"] is None or n["version"] is None)
]
- if declared_frontend != expected and not (
- declared_frontend is None
- and profile
- in (
- PROFILE,
- AUX_PROFILE,
- PRIMITIVE_PROFILE,
- *MEDIA_PROFILES,
- SEPARATION_PROFILE,
- *CROP_SPLIT_PROFILES,
+ if (profile in VHS_PROFILES and expected == "1.48.6" and declared_frontend is None) or (
+ declared_frontend != expected
+ and not (
+ declared_frontend is None
+ and profile
+ in (
+ PROFILE,
+ AUX_PROFILE,
+ PRIMITIVE_PROFILE,
+ *MEDIA_PROFILES,
+ SEPARATION_PROFILE,
+ *CROP_SPLIT_PROFILES,
+ *VHS_PROFILES,
+ )
)
):
return {
@@ -593,8 +658,10 @@ def profile_attempt(source, profile):
**(
{"field_evidence": asr_field_evidence(source, result.prompt)}
if profile == ASR_PROFILE
+ else {"field_evidence": vhs_field_evidence(source, result.prompt)}
+ if profile in VHS_PROFILES
else {"field_evidence": media_field_evidence(source, result.prompt, profile)}
- if profile in (*MEDIA_PROFILES, SEPARATION_PROFILE, *CROP_SPLIT_PROFILES)
+ if profile in (*MEDIA_PROFILES, SEPARATION_PROFILE, *CROP_SPLIT_PROFILES, *VHS_PROFILES)
else {}
),
}
@@ -698,7 +765,10 @@ def audit_library(repo: Path, profiles=REFERENCE_PROFILES, *, baseline_profiles=
for cohort in ("without_companion", "with_companion")
}
if baseline_profiles is None:
- baseline_profiles = tuple(p for p in profiles if p not in CROP_SPLIT_PROFILES)
+ excluded_profiles = (
+ VHS_PROFILES if any(p in VHS_PROFILES for p in profiles) else CROP_SPLIT_PROFILES
+ )
+ baseline_profiles = tuple(p for p in profiles if p not in excluded_profiles)
old_complete = {
row["source_path"]
for row in rows
@@ -754,6 +824,7 @@ def main():
*MEDIA_PROFILES,
SEPARATION_PROFILE,
*CROP_SPLIT_PROFILES,
+ *VHS_PROFILES,
PROFILE,
AUX_PROFILE,
PRIMITIVE_PROFILE,
diff --git a/calliope-backend/src/calliope/comfyui/serialization_reference.py b/calliope-backend/src/calliope/comfyui/serialization_reference.py
index afd2ea52..b79a15d4 100644
--- a/calliope-backend/src/calliope/comfyui/serialization_reference.py
+++ b/calliope-backend/src/calliope/comfyui/serialization_reference.py
@@ -10,6 +10,7 @@ installation is inferred.
from __future__ import annotations
+import json
import math
from typing import Any
@@ -22,6 +23,13 @@ CROP_PROFILE = "comfy-frontend-1.37.11-audio-crop-1.4.0-core-0.3.68-reference"
SPLIT_PROFILE = "comfy-frontend-1.37.11-guhai-885cac3d-core-0.21.1-reference"
CROP_SPLIT_PROFILES = (CROP_PROFILE, SPLIT_PROFILE)
+VHS_COMBINE_COMMIT = "4ee72c065db22c9d96c2427954dc69e7b908444b"
+VHS_LOAD_COMMIT = "8550981384301e9bc5bfea83e5c2c75258102593"
+VHS_PROFILES = {
+ "comfy-frontend-1.37.11-vhs-pinned-reference": "1.37.11",
+ "comfy-frontend-1.48.6-vhs-pinned-reference": "1.48.6",
+}
+
ASR_PROFILE = "comfy-frontend-1.37.11-asr-b037d7be-reference"
PROFILE = "comfy-frontend-1.37.11-core-reference"
AUX_PROFILE = "comfy-frontend-1.37.11-controlnet-aux-e8b689a-reference"
@@ -92,6 +100,8 @@ def reference_definitions(profile: str = PROFILE) -> dict[str, Any]:
"output": outputs,
}
+ if profile in VHS_PROFILES:
+ return vhs_definitions()
if profile in (*MEDIA_PROFILES, SEPARATION_PROFILE, *CROP_SPLIT_PROFILES):
return media_definitions(profile)
if profile == ASR_PROFILE:
@@ -166,6 +176,8 @@ def reference_definitions(profile: str = PROFILE) -> dict[str, Any]:
def serialize_reference_widgets(node: dict[str, Any], profile: str = PROFILE) -> dict[str, Any]:
"""Apply only the pinned identity serializers; reject any extra/missing value."""
+ if profile in VHS_PROFILES:
+ return serialize_vhs_node(node)
if profile in (*MEDIA_PROFILES, SEPARATION_PROFILE, *CROP_SPLIT_PROFILES):
return serialize_media_node(node, profile)
if profile == ASR_PROFILE:
@@ -1316,3 +1328,186 @@ def serialize_media_node(node, profile):
if ct in ("LoadAudio", "SaveAudioMP3", "PreviewAudio"):
result["audioUI"] = ""
return result
+
+
+# Only named-map state with every execution field present is covered. VHS's
+# legacy six-value arrays run migrations/default fallbacks and are rejected.
+# Sources: docs/hel-892/vhs-reference/{4ee72c06,85509813}/ and sources.json.
+_VHS_COMBINE = {
+ "frame_rate": "FLOAT",
+ "loop_count": "INT",
+ "filename_prefix": "STRING",
+ "format": "COMBO",
+ "pingpong": "BOOLEAN",
+ "save_output": "BOOLEAN",
+ "pix_fmt": "COMBO",
+ "crf": "INT",
+ "save_metadata": "BOOLEAN",
+ "trim_to_audio": "BOOLEAN",
+}
+_VHS_LOAD = {
+ "video": "COMBO",
+ "force_rate": "FLOAT",
+ "custom_width": "INT",
+ "custom_height": "INT",
+ "frame_load_cap": "INT",
+ "skip_first_frames": "INT",
+ "select_every_nth": "INT",
+ "format": "COMBO",
+}
+
+
+def vhs_definitions():
+ """Two fixed classes, h264-mp4/AnimateDiff, IMAGE without VAE only."""
+
+ def spec(required, optional, output):
+ return {
+ "input": {
+ "required": {k: [v] for k, v in required.items()},
+ "optional": {k: [v] for k, v in optional.items()},
+ },
+ "output": output,
+ }
+
+ return {
+ "VHS_VideoCombine": spec(
+ {"images": "IMAGE", **_VHS_COMBINE},
+ {"audio": "AUDIO", "meta_batch": "VHS_BatchManager", "vae": "VAE"},
+ ["VHS_FILENAMES"],
+ ),
+ "VHS_LoadVideo": spec(
+ {k: v for k, v in _VHS_LOAD.items() if k != "format"},
+ {"meta_batch": "VHS_BatchManager", "vae": "VAE", "format": "COMBO"},
+ ["IMAGE", "INT", "AUDIO", "VHS_VIDEOINFO"],
+ ),
+ }
+
+
+def serialize_vhs_node(node):
+ """Bounded restored state, before queue hooks; never run preview callbacks.
+
+ VHS useKVState calls callbacks during restore (unlike plain core restore).
+ Accept only values that are fixed points of the pinned callbacks. UI state
+ is persisted by onSerialize despite options.serialize=false, but excluded
+ from graphToPrompt. This does not assert target extensions or file access.
+ """
+ ct, props = node.get("type"), node.get("properties") or {}
+ if ct not in vhs_definitions():
+ raise ValueError("VHS固定参考未覆盖此类")
+ expected = VHS_COMBINE_COMMIT if ct == "VHS_VideoCombine" else VHS_LOAD_COMMIT
+ if (
+ props.get("cnr_id") != "comfyui-videohelpersuite"
+ or props.get("ver") != expected
+ or props.get("aux_id") is not None
+ or type(node.get("mode", 0)) is not int
+ or node.get("mode", 0) != 0
+ ):
+ raise ValueError("VHS提供方/完整提交/模式冲突;不使用发布号替代")
+ for container in (node, props):
+ if any(k in container for k in ("widgets", "serializeValue", "comfyDynamic")):
+ raise ValueError("VHS自定义控件或serializer覆盖未知")
+ ue = props.get("ue_properties") or {}
+ if "widgets_values_named" in props or any(
+ ue.get(k) for k in ("widget_ue_connectable", "input_ue_unconnectable")
+ ):
+ raise ValueError("VHS不覆盖UE控件改写")
+ layout = _VHS_COMBINE if ct == "VHS_VideoCombine" else _VHS_LOAD
+ values = node.get("widgets_values")
+ # Upload button is skipped on restore and options.serialize=false in prompt.
+ allowed = set(layout) | {"videopreview"}
+ if ct == "VHS_LoadVideo":
+ allowed.add("choose video to upload")
+ if not isinstance(values, dict) or not set(layout) <= set(values) <= allowed:
+ raise ValueError("VHS仅覆盖完整具名对象;数组迁移/缺项/额外动态项不补默认")
+ named = node.get("widgets_values_named")
+ if named is not None and (
+ type(named) is not dict
+ or json.dumps(named, sort_keys=True, allow_nan=False)
+ != json.dumps(values, sort_keys=True, allow_nan=False)
+ ):
+ raise ValueError("VHS额外具名镜像冲突")
+ if "choose video to upload" in values and values["choose video to upload"] != "image":
+ raise ValueError("VHS上传按钮占位未知")
+ preview = values.get("videopreview")
+ if preview is not None and (
+ type(preview) is not dict
+ or set(preview) - {"hidden", "paused", "params", "muted"}
+ or any(type(preview[k]) is not bool for k in ("hidden", "paused", "muted") if k in preview)
+ or ("params" in preview and type(preview["params"]) is not dict)
+ ):
+ raise ValueError("VHS持久化预览状态形状未知")
+ result = {}
+ for name, kind in layout.items():
+ value = values[name]
+ valid = (
+ type(value) in (int, float) and math.isfinite(value)
+ if kind == "FLOAT"
+ else type(value) is int
+ if kind == "INT"
+ else type(value) is bool
+ if kind == "BOOLEAN"
+ else type(value) is str
+ )
+ if not valid or (type(value) is int and abs(value) > 2**53 - 1):
+ raise ValueError(f"VHS字段{name}类型或JavaScript精确整数范围不符")
+ if type(value) is str and any(t in value for t in ("%", "{", "}")):
+ raise ValueError("VHS动态表达式不在字面量参考内")
+ result[name] = value
+ bounds = (
+ {"frame_rate": (1, float("inf")), "loop_count": (0, 100), "crf": (0, 100)}
+ if ct == "VHS_VideoCombine"
+ else {
+ "force_rate": (0, 60),
+ "custom_width": (0, 8192),
+ "custom_height": (0, 8192),
+ "frame_load_cap": (0, 2**53 - 1),
+ "skip_first_frames": (0, 2**53 - 1),
+ "select_every_nth": (1, 2**53 - 1),
+ }
+ )
+ for name, (low, high) in bounds.items():
+ if not low <= result[name] <= high:
+ raise ValueError(f"VHS字段{name}超出固定参考边界")
+ if ct == "VHS_VideoCombine":
+ if result["format"] != "video/h264-mp4" or result["pix_fmt"] not in (
+ "yuv420p",
+ "yuv420p10le",
+ ):
+ raise ValueError("VHS仅证明固定h264-mp4及其四项动态控件")
+ elif result["format"] != "AnimateDiff" or any(
+ result[k] % 8 for k in ("custom_width", "custom_height")
+ ):
+ raise ValueError("VHS仅证明AnimateDiff;尺寸必须是恢复回调的不变点(8倍数或0)")
+ spec = vhs_definitions()[ct]["input"]
+ slots = {k: v[0] for k, v in {**spec["required"], **spec["optional"]}.items()}
+ sockets = node.get("inputs", [])
+ names = [s.get("name") for s in sockets]
+ if len(names) != len(set(names)) or set(names) != set(slots):
+ raise ValueError("VHS输入槽缺失/额外/重复")
+ for socket in sockets:
+ name = socket["name"]
+ expected_type = ["yuv420p", "yuv420p10le"] if name == "pix_fmt" else slots[name]
+ # Some original workflow exports store the dynamic combo as COMBO;
+ # both are the pinned config's exact two-option combo representation.
+ valid_type = (
+ socket.get("type") in (expected_type, "COMBO")
+ if name == "pix_fmt"
+ else socket.get("type") == expected_type
+ )
+ if not valid_type:
+ raise ValueError("VHS输入槽类型与固定schema不符")
+ if socket.get("widget") != ({"name": name} if name in layout else None):
+ raise ValueError("VHS具名控件绑定不符")
+ if socket.get("link") is not None and (
+ name in ("vae", "meta_batch") or (name in layout and name != "frame_rate")
+ ):
+ raise ValueError("VHS控件转连线/VAE/批次模式未覆盖")
+ outputs = node.get("outputs", [])
+ if [s.get("type") for s in outputs] != vhs_definitions()[ct]["output"]:
+ raise ValueError("VHS返回类型/槽不符")
+ for i, socket in enumerate(outputs):
+ if "slot_index" in socket and (
+ type(socket["slot_index"]) is not int or socket["slot_index"] != i
+ ):
+ raise ValueError("VHS原输出槽索引冲突")
+ return result
diff --git a/calliope-backend/src/calliope/comfyui/ui2api.py b/calliope-backend/src/calliope/comfyui/ui2api.py
index af4228ad..5dd00ffe 100644
--- a/calliope-backend/src/calliope/comfyui/ui2api.py
+++ b/calliope-backend/src/calliope/comfyui/ui2api.py
@@ -23,6 +23,7 @@ from .serialization_reference import (
PRIMITIVE_PROFILE,
PROFILE,
SEPARATION_PROFILE,
+ VHS_PROFILES,
case04_definitions,
fold_reference_primitives,
promoted_definitions,
@@ -65,6 +66,7 @@ def convert_reference(source: Any, profile: str = PROFILE) -> Conversion:
*MEDIA_PROFILES,
SEPARATION_PROFILE,
*CROP_SPLIT_PROFILES,
+ *VHS_PROFILES,
AUX_PROFILE,
PRIMITIVE_PROFILE,
PREVIEW_PROFILE,
@@ -81,6 +83,12 @@ def convert_reference(source: Any, profile: str = PROFILE) -> Conversion:
True,
)
try:
+ if (
+ profile in VHS_PROFILES
+ and VHS_PROFILES[profile] == "1.48.6"
+ and (source.get("extra") or {}).get("frontendVersion") != "1.48.6"
+ ):
+ raise ValueError("VHS 1.48.6参考要求显式前端声明;缺失仅选择1.37.11")
if profile in (*STRUCTURE_PROFILES, *PROMOTED_PROFILES, CASE04_PROFILE):
case04 = profile == CASE04_PROFILE
promoted = profile in PROMOTED_PROFILES or case04
@@ -128,11 +136,14 @@ def convert_reference(source: Any, profile: str = PROFILE) -> Conversion:
and (source.get("extra") or {}).get("frontendVersion") != "1.37.11"
):
raise ValueError("PreviewAny 需要显式1.37.11前端声明")
- if profile in (*MEDIA_PROFILES, SEPARATION_PROFILE, *CROP_SPLIT_PROFILES) and any(
- node.get("type") == "Reroute" for node in source.get("nodes", [])
- ):
+ if profile in (
+ *MEDIA_PROFILES,
+ SEPARATION_PROFILE,
+ *CROP_SPLIT_PROFILES,
+ *VHS_PROFILES,
+ ) and any(node.get("type") == "Reroute" for node in source.get("nodes", [])):
raise ValueError("媒体最小参考仅覆盖直接连线,不扩展虚拟节点")
- if profile in (SEPARATION_PROFILE, *CROP_SPLIT_PROFILES) and any(
+ if profile in (SEPARATION_PROFILE, *CROP_SPLIT_PROFILES, *VHS_PROFILES) and any(
(source.get("extra") or {}).get(k) for k in ("ue_links", "links_added_by_ue")
):
raise ValueError("音频分离参考不覆盖UE附加连线")
@@ -147,7 +158,13 @@ def convert_reference(source: Any, profile: str = PROFILE) -> Conversion:
except (ValueError, TypeError, KeyError, AttributeError, IndexError) as exc:
return Conversion(None, [{"code": "invalid_reference_contract", "message": str(exc)}], True)
result.reference_only = True
- if profile in (ASR_PROFILE, *MEDIA_PROFILES, SEPARATION_PROFILE, *CROP_SPLIT_PROFILES):
+ if profile in (
+ ASR_PROFILE,
+ *MEDIA_PROFILES,
+ SEPARATION_PROFILE,
+ *CROP_SPLIT_PROFILES,
+ *VHS_PROFILES,
+ ):
result.serialization_stage = "restored_saved_state_before_queue_hooks"
return result
@@ -208,6 +225,7 @@ def _convert(
**STRUCTURE_PROFILES,
**PROMOTED_PROFILES,
CASE04_PROFILE: "1.53.6",
+ **VHS_PROFILES,
}.get(reference_profile, "1.37.11")
if frontend_version is not None and frontend_version != expected_version:
fail("reference_frontend_mismatch", "源图声明的前端版本与固定参考不一致")
@@ -228,7 +246,12 @@ def _convert(
for lid in links:
try:
resolve_reference_link(nodes, links, lid)
- if reference_profile in (*MEDIA_PROFILES, SEPARATION_PROFILE, *CROP_SPLIT_PROFILES):
+ if reference_profile in (
+ *MEDIA_PROFILES,
+ SEPARATION_PROFILE,
+ *CROP_SPLIT_PROFILES,
+ *VHS_PROFILES,
+ ):
link = links[lid]
upstream = nodes[str(link[1])]["outputs"][link[2]]
downstream = nodes[str(link[3])]["inputs"][link[4]]
diff --git a/calliope-backend/tests/test_audio_separation_reference.py b/calliope-backend/tests/test_audio_separation_reference.py
index 99879b21..c8d5a9e1 100644
--- a/calliope-backend/tests/test_audio_separation_reference.py
+++ b/calliope-backend/tests/test_audio_separation_reference.py
@@ -359,7 +359,11 @@ def test_old_mp3_profile_rejects_real_graph_and_new_profile_rejects_old_core():
def test_library_actual_delta_keeps_every_old_attempt_and_all_six_golden_comparisons():
previous = json.loads((REPO / "docs/hel-892/media-evidence/library.json").read_bytes())
- profiles = tuple(p for p in audit.REFERENCE_PROFILES if p not in audit.CROP_SPLIT_PROFILES)
+ profiles = tuple(
+ p
+ for p in audit.REFERENCE_PROFILES
+ if p not in (*audit.CROP_SPLIT_PROFILES, *audit.VHS_PROFILES)
+ )
baseline = tuple(p for p in profiles if p != SEPARATION_PROFILE)
old = audit.audit_library(REPO, baseline)
current = audit.audit_library(REPO, profiles, baseline_profiles=baseline)
diff --git a/calliope-backend/tests/test_crop_split_reference.py b/calliope-backend/tests/test_crop_split_reference.py
index ef9fa0f5..dd9f46a9 100644
--- a/calliope-backend/tests/test_crop_split_reference.py
+++ b/calliope-backend/tests/test_crop_split_reference.py
@@ -16,6 +16,7 @@ from calliope.comfyui.serialization_reference import (
CROP_SPLIT_PROFILES,
SEPARATION_PROFILE,
SPLIT_PROFILE,
+ VHS_PROFILES,
serialize_reference_widgets,
)
from calliope.comfyui.ui2api import convert, convert_reference
@@ -350,12 +351,13 @@ def test_two_disjoint_instances_preserve_nodes_links_and_values(profile):
def test_all_old_fourteen_profiles_attempts_gaps_and_six_differences_unchanged():
- profiles = tuple(p for p in audit.REFERENCE_PROFILES if p not in CROP_SPLIT_PROFILES)
+ historical_profiles = tuple(p for p in audit.REFERENCE_PROFILES if p not in VHS_PROFILES)
+ profiles = tuple(p for p in historical_profiles if p not in CROP_SPLIT_PROFILES)
historical = json.loads((REPO / "docs/hel-892/separation-evidence/library.json").read_bytes())
baseline = audit.audit_library(REPO, profiles)
- current = audit.audit_library(REPO)
+ current = audit.audit_library(REPO, historical_profiles)
assert baseline["gap_groups"] == historical["gap_groups"]
- assert len(profiles) == 14 and len(audit.REFERENCE_PROFILES) == 16
+ assert len(profiles) == 14 and len(historical_profiles) == 16
assert current["coverage_delta"]["baseline_profiles"] == list(profiles)
assert current["coverage_delta"]["new_complete_paths"] == [CROP]
assert len(current["coverage_delta"]["current_complete_paths"]) == 8
diff --git a/calliope-backend/tests/test_vhs_reference.py b/calliope-backend/tests/test_vhs_reference.py
new file mode 100644
index 00000000..20d016da
--- /dev/null
+++ b/calliope-backend/tests/test_vhs_reference.py
@@ -0,0 +1,375 @@
+"""Pinned source bytes and synthetic graphs only; no plugins/media are executed."""
+
+from __future__ import annotations
+
+import ast
+import copy
+import hashlib
+import json
+from pathlib import Path
+
+import pytest
+from scripts import audit_reference_conversion as audit
+from scripts.verify_frontend_sources import verify
+
+from calliope.comfyui.serialization_reference import (
+ VHS_COMBINE_COMMIT,
+ VHS_LOAD_COMMIT,
+ VHS_PROFILES,
+ serialize_vhs_node,
+)
+from calliope.comfyui.ui2api import convert, convert_reference
+
+REPO = Path(__file__).resolve().parents[2]
+ROOT = REPO / "docs/hel-892/vhs-reference"
+PREFIX = "example_ComfyUI_workflows/0-基础处理:图像合并-音频分离-视频截取合并-图像视频放大/"
+LOAD = PREFIX + "多视频合成分屏展示.json"
+COMBINE = (
+ "example_ComfyUI_workflows/4-视频生成/Minimax-h3/"
+ "Minimax_H3_T8双时钟采样_参考生视频-8步高质量极速版.json"
+)
+
+
+def real_node(path, nid):
+ return next(n for n in json.loads((REPO / path).read_bytes())["nodes"] if n["id"] == nid)
+
+
+def synthetic():
+ # This pair is not a source workflow, target export or encoding/history test.
+ load, combine = real_node(LOAD, 17), real_node(COMBINE, 12)
+ for n in (load, combine):
+ n.pop("widgets_values_named", None)
+ for s in n["inputs"]:
+ s["link"] = None
+ for s in n["outputs"]:
+ s["links"] = []
+ load["outputs"][0]["links"] = [1]
+ load["outputs"][2]["links"] = [2]
+ combine["inputs"][0]["link"] = 1
+ combine["inputs"][1]["link"] = 2
+ return {
+ "nodes": [load, combine],
+ "links": [[1, 17, 0, 12, 0, "IMAGE"], [2, 17, 2, 12, 1, "AUDIO"]],
+ }
+
+
+def test_pinned_bytes_registration_schema_and_js_boundaries():
+ assert len(verify(ROOT)["sources_verified"]) == len(
+ json.loads((ROOT / "sources.json").read_bytes())["sources"]
+ )
+ for commit, ct, clsname, filename in (
+ (VHS_COMBINE_COMMIT, "VHS_VideoCombine", "VideoCombine", "nodes.py"),
+ (VHS_LOAD_COMMIT, "VHS_LoadVideo", "LoadVideoUpload", "load_video_nodes.py"),
+ ):
+ base = ROOT / commit[:8]
+ tree = ast.parse((base / "videohelpersuite" / filename).read_bytes())
+ cls = next(n for n in tree.body if isinstance(n, ast.ClassDef) and n.name == clsname)
+ schema = next(
+ n for n in cls.body if isinstance(n, ast.FunctionDef) and n.name == "INPUT_TYPES"
+ )
+ assert schema.lineno > 0
+ mappings = (base / "videohelpersuite/nodes.py").read_text()
+ assert f'"{ct}": {clsname},' in mappings
+ js = (base / "web/js/VHS.core.js").read_text()
+ assert "w.value = widgetDict[w.name];" in js
+ assert "w.callback?.(w.value)" in js
+ assert "info.widgets_values[w.name] = w.value;" in js
+ assert "uploadWidget.options.serialize = false;" in js
+ assert 'this.addDOMWidget("videopreview", "preview", element, {' in js
+ assert "serialize: false," in js
+ assert (
+ 'VHS_VideoCombine : ["frame_rate", "loop_count", "filename_prefix", '
+ '"format", "pingpong", "save_image"]' in js
+ )
+ fmt = json.loads((ROOT / "4ee72c06/video_formats/h264-mp4.json").read_bytes())
+ assert fmt["main_pass"][4] == ["pix_fmt", ["yuv420p", "yuv420p10le"]]
+ assert fmt["main_pass"][6] == ["crf", "INT", {"default": 19, "min": 0, "max": 100, "step": 1}]
+ assert fmt["save_metadata"] == ["save_metadata", "BOOLEAN", {"default": True}]
+ assert fmt["trim_to_audio"] == ["trim_to_audio", "BOOLEAN", {"default": False}]
+ exe = (ROOT / "frontend-1.48.6/src/utils/executionUtil.ts").read_text()
+ assert "widget.options?.serialize === false" in exe
+ assert "await widget.serializeValue(node, i)" in exe
+ wrapper = (ROOT / "frontend-1.48.6/src/scripts/utils.ts").read_text()
+ assert "return _applyTextReplacements(app.rootGraph, value)" in wrapper
+
+
+@pytest.mark.parametrize("profile", VHS_PROFILES)
+def test_synthetic_complete_typed_fields_nonzero_audio_slot_and_ui_omission(profile):
+ source = synthetic()
+ if VHS_PROFILES[profile] == "1.48.6":
+ assert convert_reference(source, profile).prompt is None
+ assert audit.profile_attempt(source, profile)["status"] == "not_applicable"
+ source["extra"] = {"frontendVersion": VHS_PROFILES[profile]}
+ result = convert_reference(source, profile)
+ assert result.prompt is not None and result.reference_only
+ assert result.prompt["12"]["inputs"]["audio"] == ["17", 2]
+ assert result.prompt["12"]["inputs"]["images"] == ["17", 0]
+ assert len(audit.vhs_field_evidence(source, result.prompt)) == 20
+ assert not any("videopreview" in n["inputs"] for n in result.prompt.values())
+ assert not convert(source).prompt
+ before = copy.deepcopy(result.prompt)
+ source["nodes"][0]["widgets_values"]["videopreview"]["params"]["filename"] = "other.mp4"
+ source["nodes"][0]["widgets_values"]["choose video to upload"] = "image"
+ assert convert_reference(source, profile).prompt == before
+ source["nodes"][0]["widgets_values"]["video"] = "第二个.mp4"
+ source["nodes"][0]["widgets_values"]["skip_first_frames"] = 41
+ source["nodes"][1]["widgets_values"]["crf"] = 37
+ source["nodes"][1]["widgets_values"]["pix_fmt"] = "yuv420p10le"
+ prompt = convert_reference(source, profile).prompt
+ assert prompt["17"]["inputs"]["video"] == "第二个.mp4"
+ assert prompt["17"]["inputs"]["skip_first_frames"] == 41
+ assert prompt["12"]["inputs"]["crf"] == 37
+ assert prompt["12"]["inputs"]["pix_fmt"] == "yuv420p10le"
+
+
+@pytest.mark.parametrize(
+ "index,field,value",
+ [
+ (0, "force_rate", True),
+ (0, "force_rate", None),
+ (0, "force_rate", float("inf")),
+ (0, "force_rate", -1),
+ (0, "force_rate", 61),
+ (0, "video", 12),
+ (0, "custom_width", 513),
+ (0, "custom_height", 8193),
+ (0, "custom_width", True),
+ (0, "frame_load_cap", 1.2),
+ (0, "frame_load_cap", 2**53),
+ (0, "skip_first_frames", -1),
+ (0, "select_every_nth", 0),
+ (0, "format", "Wan"),
+ (0, "format", "custom"),
+ (1, "format", "image/webp"),
+ (1, "format", "video/custom"),
+ (1, "pix_fmt", "rgb24"),
+ (1, "crf", 101),
+ (1, "crf", True),
+ (1, "frame_rate", float("nan")),
+ (1, "frame_rate", 0),
+ (1, "loop_count", -1),
+ (1, "loop_count", 1.0),
+ (1, "pingpong", 1),
+ (1, "save_output", None),
+ (1, "trim_to_audio", "false"),
+ (1, "filename_prefix", "%date:yyyy%"),
+ (1, "filename_prefix", "{unknown}"),
+ ],
+)
+def test_invalid_fields_fail_whole_graph_without_partial_prompt(index, field, value):
+ source = synthetic()
+ source["nodes"][index]["widgets_values"][field] = value
+ result = convert_reference(source, next(iter(VHS_PROFILES)))
+ assert result.prompt is None and result.issues
+
+
+@pytest.mark.parametrize(
+ "change",
+ [
+ "provider",
+ "release",
+ "other_commit",
+ "aux",
+ "array",
+ "extra_value",
+ "missing_value",
+ "mirror_type",
+ "mirror_value",
+ "binding",
+ "socket_type",
+ "extra_socket",
+ "missing_socket",
+ "mode",
+ "bool_mode",
+ "ue",
+ "override",
+ "prop_override",
+ "vae",
+ "batch",
+ "extra_output",
+ "output_type",
+ "output_index",
+ "bool_index",
+ "bad_source_slot",
+ "bad_target_slot",
+ "bad_link_type",
+ "missing_reciprocal",
+ "wrong_frontend",
+ "unknown_node",
+ "preview_shape",
+ ],
+)
+def test_contract_mutations_reject(change):
+ source = synthetic()
+ n = source["nodes"][0]
+ if change == "provider":
+ n["properties"]["cnr_id"] = "same-name-plugin"
+ elif change == "release":
+ n["properties"]["ver"] = "1.7.7"
+ elif change == "other_commit":
+ n["properties"]["ver"] = VHS_COMBINE_COMMIT
+ elif change == "aux":
+ n["properties"]["aux_id"] = "other"
+ elif change == "array":
+ n["widgets_values"] = list(n["widgets_values"].values())
+ elif change == "extra_value":
+ n["widgets_values"]["custom"] = 1
+ elif change == "missing_value":
+ del n["widgets_values"]["format"]
+ elif change.startswith("mirror"):
+ n["widgets_values_named"] = copy.deepcopy(n["widgets_values"])
+ n["widgets_values_named"]["force_rate"] = 16.0 if change == "mirror_type" else 20
+ elif change == "binding":
+ n["inputs"][2]["widget"] = {"name": "wrong"}
+ elif change == "socket_type":
+ n["inputs"][2]["type"] = "STRING"
+ elif change == "extra_socket":
+ n["inputs"].append(copy.deepcopy(n["inputs"][0]))
+ elif change == "missing_socket":
+ n["inputs"].pop()
+ elif change == "mode":
+ n["mode"] = 4
+ elif change == "bool_mode":
+ n["mode"] = False
+ elif change == "ue":
+ n["properties"]["ue_properties"]["widget_ue_connectable"] = {"video": True}
+ elif change == "override":
+ n["serializeValue"] = "custom"
+ elif change == "prop_override":
+ n["properties"]["widgets"] = []
+ elif change == "vae":
+ n["inputs"][1]["link"] = 1
+ elif change == "batch":
+ n["inputs"][0]["link"] = 1
+ elif change == "extra_output":
+ n["outputs"].append({"type": "IMAGE", "links": []})
+ elif change == "output_type":
+ n["outputs"][0]["type"] = "LATENT"
+ elif change == "output_index":
+ n["outputs"][2]["slot_index"] = 0
+ elif change == "bool_index":
+ n["outputs"][0]["slot_index"] = False
+ elif change == "bad_source_slot":
+ source["links"][0][2] = 1
+ elif change == "bad_target_slot":
+ source["links"][0][4] = 2
+ elif change == "bad_link_type":
+ source["links"][0][5] = "LATENT"
+ elif change == "missing_reciprocal":
+ n["outputs"][0]["links"] = []
+ elif change == "wrong_frontend":
+ source["extra"] = {"frontendVersion": "1.7.9"}
+ elif change == "unknown_node":
+ source["nodes"].append({"id": 100, "type": "Unknown", "inputs": [], "outputs": []})
+ elif change == "preview_shape":
+ n["widgets_values"]["videopreview"] = "server/path.mp4"
+ assert convert_reference(source, next(iter(VHS_PROFILES))).prompt is None
+
+
+def test_real_five_load_instances_are_distinct_and_modes_not_dropped():
+ source = json.loads((REPO / LOAD).read_bytes())
+ nodes = [n for n in source["nodes"] if n["type"] == "VHS_LoadVideo"]
+ assert len(nodes) == 5
+ for n in nodes:
+ if n["mode"] == 4:
+ with pytest.raises(ValueError):
+ serialize_vhs_node(n)
+ else:
+ values = serialize_vhs_node(n)
+ assert all(
+ type(v) is type(n["widgets_values"][k]) and v == n["widgets_values"][k]
+ for k, v in values.items()
+ )
+ assert convert_reference(source, next(iter(VHS_PROFILES))).prompt is None
+
+
+def test_old_sixteen_attempts_gaps_candidates_and_six_comparisons_protected():
+ old = json.loads((REPO / "docs/hel-892/crop-split-evidence/library.json").read_bytes())
+ profiles = tuple(p for p in audit.REFERENCE_PROFILES if p not in VHS_PROFILES)
+ baseline = audit.audit_library(REPO, profiles)
+ now = audit.audit_library(REPO, baseline_profiles=profiles)
+ assert len(profiles) == 16 and len(now["profiles"]) == 18
+ assert old["gap_groups"] == baseline["gap_groups"]
+ for previous, before, after in zip(old["cases"], baseline["cases"], now["cases"]):
+ assert previous["attempts"] == before["attempts"] == after["attempts"][:-2]
+ assert previous.get("comparisons") == after.get("comparisons")
+ assert previous["status"] == after["status"]
+ assert previous["candidate_hashes"] == after["candidate_hashes"]
+ assert previous["comparison_status"] == after["comparison_status"]
+ assert len(now["coverage_delta"]["current_complete_paths"]) == 8
+ assert now["coverage_delta"]["new_complete_paths"] == []
+ assert now["coverage_delta"]["baseline_profiles"] == list(profiles)
+
+ def unavailable(r):
+ return {
+ c["source_path"]
+ for c in r["cases"]
+ if all(a["status"] == "not_applicable" for a in c["attempts"])
+ }
+
+ assert unavailable(old) == unavailable(now) and len(unavailable(now)) == 98
+ for raw in json.loads((ROOT / "sources.json").read_bytes())["sources"]:
+ assert hashlib.sha256((ROOT / raw["local_file"]).read_bytes()).hexdigest() == raw["sha256"]
+
+
+def test_disjoint_instances_values_ids_links_not_shared():
+ first, second = synthetic(), synthetic()
+ for n in second["nodes"]:
+ n["id"] += 100
+ for socket in n["inputs"]:
+ if socket.get("link") is not None:
+ socket["link"] += 100
+ for socket in n["outputs"]:
+ socket["links"] = [lid + 100 for lid in socket.get("links", [])]
+ for link in second["links"]:
+ for i in (0, 1, 3):
+ link[i] += 100
+ second["nodes"][0]["widgets_values"]["video"] = "other-file.mp4"
+ second["nodes"][0]["widgets_values"]["force_rate"] = 29.97
+ second["nodes"][1]["widgets_values"]["frame_rate"] = 29.97
+ source = {"nodes": first["nodes"] + second["nodes"], "links": first["links"] + second["links"]}
+ prompt = convert_reference(source, next(iter(VHS_PROFILES))).prompt
+ assert set(prompt) == {"17", "12", "117", "112"}
+ assert prompt["112"]["inputs"]["audio"] == ["117", 2]
+ assert prompt["12"]["inputs"]["audio"] == ["17", 2]
+ assert prompt["117"]["inputs"]["video"] == "other-file.mp4"
+ assert prompt["17"]["inputs"]["video"] != "other-file.mp4"
+ assert prompt["112"]["inputs"]["frame_rate"] == 29.97
+ assert len(audit.vhs_field_evidence(source, prompt)) == 40
+
+
+def test_all_five_real_combines_have_node_contract_even_when_other_nodes_close_graph():
+ seen = []
+ for path in (REPO / "example_ComfyUI_workflows").rglob("*"):
+ if not path.is_file():
+ continue
+ source = json.loads(path.read_bytes())
+ for n in source.get("nodes", []):
+ if n["type"] == "VHS_VideoCombine" and n["properties"].get("ver") == VHS_COMBINE_COMMIT:
+ frontend = source.get("extra", {}).get("frontendVersion") or "1.37.11"
+ if frontend not in VHS_PROFILES.values():
+ assert all(
+ audit.profile_attempt(source, p)["status"] == "not_applicable"
+ for p in VHS_PROFILES
+ )
+ continue
+ values = serialize_vhs_node(n)
+ assert values["crf"] == n["widgets_values"]["crf"]
+ assert values["frame_rate"] == n["widgets_values"]["frame_rate"]
+ seen.append((path, n["id"]))
+ profile = next(
+ p
+ for p, v in VHS_PROFILES.items()
+ if v == (source.get("extra", {}).get("frontendVersion") or "1.37.11")
+ )
+ result = convert_reference(source, profile)
+ assert result.prompt is None
+ node_issues = [i for i in result.issues if i.get("node_id") == str(n["id"])]
+ # The source upstream classes still have no schema in this
+ # minimal profile; preserve those edge errors, not a partial prompt.
+ assert node_issues
+ assert {i["code"] for i in node_issues} <= {
+ "invalid_output_slot",
+ "missing_required_input",
+ }
+ assert len(seen) == 5
diff --git a/docs/hel-892/vhs-reference/4ee72c06-tree.json b/docs/hel-892/vhs-reference/4ee72c06-tree.json
new file mode 100644
index 00000000..30caccb8
--- /dev/null
+++ b/docs/hel-892/vhs-reference/4ee72c06-tree.json
@@ -0,0 +1,437 @@
+{
+ "sha": "4ee72c065db22c9d96c2427954dc69e7b908444b",
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/trees/4ee72c065db22c9d96c2427954dc69e7b908444b",
+ "tree": [
+ {
+ "path": ".github",
+ "mode": "040000",
+ "type": "tree",
+ "sha": "7a7002793ebbe7911dded77df496f4b141a46661",
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/trees/7a7002793ebbe7911dded77df496f4b141a46661"
+ },
+ {
+ "path": ".github/workflows",
+ "mode": "040000",
+ "type": "tree",
+ "sha": "a0920d307e4ff5f6199f39cf7cd22e853ed9c139",
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/trees/a0920d307e4ff5f6199f39cf7cd22e853ed9c139"
+ },
+ {
+ "path": ".github/workflows/publish.yml",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "27bcdb11695ea19286da34cd5f36cf75155a4dbb",
+ "size": 640,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/27bcdb11695ea19286da34cd5f36cf75155a4dbb"
+ },
+ {
+ "path": ".gitignore",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "9b5379e8f93da3909706b0a7d37f5c8ab5e2a2a5",
+ "size": 3101,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/9b5379e8f93da3909706b0a7d37f5c8ab5e2a2a5"
+ },
+ {
+ "path": "LICENSE",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "f288702d2fa16d3cdf0035b15a9fcbc552cd88e7",
+ "size": 35149,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/f288702d2fa16d3cdf0035b15a9fcbc552cd88e7"
+ },
+ {
+ "path": "README.md",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "753fcecf9979b40b2427869c6ad5bed1b61df482",
+ "size": 8877,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/753fcecf9979b40b2427869c6ad5bed1b61df482"
+ },
+ {
+ "path": "__init__.py",
+ "mode": "100755",
+ "type": "blob",
+ "sha": "9fa995f0ac7e296a62bcba9df68b5250a0f7d041",
+ "size": 398,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/9fa995f0ac7e296a62bcba9df68b5250a0f7d041"
+ },
+ {
+ "path": "pyproject.toml",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "39793ee53bd813c5188a2f65836a72bf541b4d9c",
+ "size": 425,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/39793ee53bd813c5188a2f65836a72bf541b4d9c"
+ },
+ {
+ "path": "requirements.txt",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "4fa34aa21b85c4b974e2a2b6891eae5fd6dd4164",
+ "size": 29,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/4fa34aa21b85c4b974e2a2b6891eae5fd6dd4164"
+ },
+ {
+ "path": "testframework",
+ "mode": "040000",
+ "type": "tree",
+ "sha": "cb29518c671c9b91a4c2799b026d19260d5dfc33",
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/trees/cb29518c671c9b91a4c2799b026d19260d5dfc33"
+ },
+ {
+ "path": "testframework/README.md",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "93cd503563080c9c7d785d419bef7dddc4c11cd8",
+ "size": 466,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/93cd503563080c9c7d785d419bef7dddc4c11cd8"
+ },
+ {
+ "path": "testframework/__init__.py",
+ "mode": "100755",
+ "type": "blob",
+ "sha": "c75b11c164596ef873898dd843700c7164cc0932",
+ "size": 184,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/c75b11c164596ef873898dd843700c7164cc0932"
+ },
+ {
+ "path": "testframework/server.py",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "a9c20ea3eab31bab288d6089a89410ff409d43ad",
+ "size": 2836,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/a9c20ea3eab31bab288d6089a89410ff409d43ad"
+ },
+ {
+ "path": "testframework/web",
+ "mode": "040000",
+ "type": "tree",
+ "sha": "5beb5445842a7c69a29942eadbd100ec0458556f",
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/trees/5beb5445842a7c69a29942eadbd100ec0458556f"
+ },
+ {
+ "path": "testframework/web/js",
+ "mode": "040000",
+ "type": "tree",
+ "sha": "a351c437f1cccb93448fb0140d8e0fc17ffab368",
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/trees/a351c437f1cccb93448fb0140d8e0fc17ffab368"
+ },
+ {
+ "path": "testframework/web/js/testRunner.js",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "521a2204b9a2a3202441818461231872ea8a15c8",
+ "size": 3132,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/521a2204b9a2a3202441818461231872ea8a15c8"
+ },
+ {
+ "path": "tests",
+ "mode": "040000",
+ "type": "tree",
+ "sha": "6341d1c56315d281322b2d4dd4a9abd4ef3cb345",
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/trees/6341d1c56315d281322b2d4dd4a9abd4ef3cb345"
+ },
+ {
+ "path": "tests/README.md",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "ec025a7d169c7783f34523c63a0a6ae9a2e00fdb",
+ "size": 140,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/ec025a7d169c7783f34523c63a0a6ae9a2e00fdb"
+ },
+ {
+ "path": "tests/audio.json",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "cae3d766731f7fe3ae4866f6fa8c0cc86a2ca46d",
+ "size": 6092,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/cae3d766731f7fe3ae4866f6fa8c0cc86a2ca46d"
+ },
+ {
+ "path": "tests/batch4x4.json",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "34b9647329642a9e5ca233a60b8bbf2ca8f72aca",
+ "size": 10236,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/34b9647329642a9e5ca233a60b8bbf2ca8f72aca"
+ },
+ {
+ "path": "tests/converted-format-input.json",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "e9722580df540b89a4b9185260a8de180ddd63aa",
+ "size": 4514,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/e9722580df540b89a4b9185260a8de180ddd63aa"
+ },
+ {
+ "path": "tests/converted-input.json",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "41a93a049ea95ea9ddda92ed3a5152b55581938f",
+ "size": 5917,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/41a93a049ea95ea9ddda92ed3a5152b55581938f"
+ },
+ {
+ "path": "tests/loop.json",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "aa5dd4ecdaac29d04b71dbf3bbc8349f2d1210af",
+ "size": 3643,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/aa5dd4ecdaac29d04b71dbf3bbc8349f2d1210af"
+ },
+ {
+ "path": "tests/old-prores.json",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "17e77c1547663d39b5356ac15d74f807c69dc671",
+ "size": 8694,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/17e77c1547663d39b5356ac15d74f807c69dc671"
+ },
+ {
+ "path": "tests/old-vae-conversion.json",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "e751918b6473cae2f38536d8433bc40b2283a3f6",
+ "size": 4430,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/e751918b6473cae2f38536d8433bc40b2283a3f6"
+ },
+ {
+ "path": "tests/simple.json",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "4d7f8ddd68a24cc90519ecd127daae9d8ab81b85",
+ "size": 2820,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/4d7f8ddd68a24cc90519ecd127daae9d8ab81b85"
+ },
+ {
+ "path": "video_formats",
+ "mode": "040000",
+ "type": "tree",
+ "sha": "71ef56a606010f67ad85ab3e27e04ea0a3af5a7e",
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/trees/71ef56a606010f67ad85ab3e27e04ea0a3af5a7e"
+ },
+ {
+ "path": "video_formats/16bit-png.json",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "b768bdbcfe8950cb7bde37d02444f0191ad29f51",
+ "size": 139,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/b768bdbcfe8950cb7bde37d02444f0191ad29f51"
+ },
+ {
+ "path": "video_formats/8bit-png.json",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "88b27a75f9c979f18979ec46da8c8843a82e0759",
+ "size": 75,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/88b27a75f9c979f18979ec46da8c8843a82e0759"
+ },
+ {
+ "path": "video_formats/ProRes.json",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "eddd3acf931c5ab3486197c18ba88a3959d3e1d6",
+ "size": 943,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/eddd3acf931c5ab3486197c18ba88a3959d3e1d6"
+ },
+ {
+ "path": "video_formats/av1-webm.json",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "659ea166fb140e18109f09f3d5710363af9c2294",
+ "size": 625,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/659ea166fb140e18109f09f3d5710363af9c2294"
+ },
+ {
+ "path": "video_formats/ffmpeg-gif.json",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "3ca0865033c7dabc06176c737652f375e7badb27",
+ "size": 366,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/3ca0865033c7dabc06176c737652f375e7badb27"
+ },
+ {
+ "path": "video_formats/ffv1-mkv.json",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "3248e5fc6425feeb1d55ccdb8bd8d49cb0e3401c",
+ "size": 1111,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/3248e5fc6425feeb1d55ccdb8bd8d49cb0e3401c"
+ },
+ {
+ "path": "video_formats/gifski.json",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "c96b358ab0ae59dbd97c52a699c8ee9825c5d351",
+ "size": 287,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/c96b358ab0ae59dbd97c52a699c8ee9825c5d351"
+ },
+ {
+ "path": "video_formats/h264-mp4.json",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "4aa0bd57c6a4cc65334d82e5cdaa7aadb8372321",
+ "size": 619,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/4aa0bd57c6a4cc65334d82e5cdaa7aadb8372321"
+ },
+ {
+ "path": "video_formats/h265-mp4.json",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "559c35073edf9ed74baec0eeffc56fde2b0438c5",
+ "size": 645,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/559c35073edf9ed74baec0eeffc56fde2b0438c5"
+ },
+ {
+ "path": "video_formats/nvenc_av1-mp4.json",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "ed8294fcf0c9cc1a4780dc6e2454913a969f533b",
+ "size": 606,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/ed8294fcf0c9cc1a4780dc6e2454913a969f533b"
+ },
+ {
+ "path": "video_formats/nvenc_h264-mp4.json",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "f8676304effd31fb41ae13dd972d92736b122009",
+ "size": 607,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/f8676304effd31fb41ae13dd972d92736b122009"
+ },
+ {
+ "path": "video_formats/nvenc_hevc-mp4.json",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "a374ecde4d0e0c2a2f0042c282f8b1915e307aca",
+ "size": 632,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/a374ecde4d0e0c2a2f0042c282f8b1915e307aca"
+ },
+ {
+ "path": "video_formats/webm.json",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "6323f619ad2850ba60cd5e31b32cdfc060e030c9",
+ "size": 589,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/6323f619ad2850ba60cd5e31b32cdfc060e030c9"
+ },
+ {
+ "path": "videohelpersuite",
+ "mode": "040000",
+ "type": "tree",
+ "sha": "7fa5fea7a3a28e78b03a369d1656de9230174e8c",
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/trees/7fa5fea7a3a28e78b03a369d1656de9230174e8c"
+ },
+ {
+ "path": "videohelpersuite/batched_nodes.py",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "624bb84f73cce1d8e51abf4fef0b80367ad4b9a3",
+ "size": 1790,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/624bb84f73cce1d8e51abf4fef0b80367ad4b9a3"
+ },
+ {
+ "path": "videohelpersuite/documentation.py",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "857de6c6a5b4a3917f49d0b1c5c142f274203f22",
+ "size": 43805,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/857de6c6a5b4a3917f49d0b1c5c142f274203f22"
+ },
+ {
+ "path": "videohelpersuite/image_latent_nodes.py",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "62b4e3e6452b51b42e3e49852d27a1bb9921edc2",
+ "size": 19039,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/62b4e3e6452b51b42e3e49852d27a1bb9921edc2"
+ },
+ {
+ "path": "videohelpersuite/latent_preview.py",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "a0a22b8ad028fb9de25cb9818b857a6e4aa0f3e1",
+ "size": 5500,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/a0a22b8ad028fb9de25cb9818b857a6e4aa0f3e1"
+ },
+ {
+ "path": "videohelpersuite/load_images_nodes.py",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "43f3387c4f907d7372c207f7f1aeb626c27b836b",
+ "size": 8120,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/43f3387c4f907d7372c207f7f1aeb626c27b836b"
+ },
+ {
+ "path": "videohelpersuite/load_video_nodes.py",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "b23e40f535c8166ae05fa6a541d159cdadb368f7",
+ "size": 29032,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/b23e40f535c8166ae05fa6a541d159cdadb368f7"
+ },
+ {
+ "path": "videohelpersuite/logger.py",
+ "mode": "100755",
+ "type": "blob",
+ "sha": "6e7b8d64bda275608ba6bf8ee28d2a2112e3e2be",
+ "size": 1057,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/6e7b8d64bda275608ba6bf8ee28d2a2112e3e2be"
+ },
+ {
+ "path": "videohelpersuite/nodes.py",
+ "mode": "100755",
+ "type": "blob",
+ "sha": "4389f5de534d0fdc66fdc922257166125e26e444",
+ "size": 48222,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/4389f5de534d0fdc66fdc922257166125e26e444"
+ },
+ {
+ "path": "videohelpersuite/server.py",
+ "mode": "100755",
+ "type": "blob",
+ "sha": "f67e342400eb250b731245554bbd495864719f8f",
+ "size": 12178,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/f67e342400eb250b731245554bbd495864719f8f"
+ },
+ {
+ "path": "videohelpersuite/utils.py",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "5b35ad47fa3d1412773ab561598031ba6a3b38bc",
+ "size": 17044,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/5b35ad47fa3d1412773ab561598031ba6a3b38bc"
+ },
+ {
+ "path": "web",
+ "mode": "040000",
+ "type": "tree",
+ "sha": "780545bc455811920531b200a1940657ae25aebd",
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/trees/780545bc455811920531b200a1940657ae25aebd"
+ },
+ {
+ "path": "web/js",
+ "mode": "040000",
+ "type": "tree",
+ "sha": "0dea6ab5e00f897006aecd295ce034630d13f79c",
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/trees/0dea6ab5e00f897006aecd295ce034630d13f79c"
+ },
+ {
+ "path": "web/js/VHS.core.js",
+ "mode": "100755",
+ "type": "blob",
+ "sha": "fcbf03ffc7eb517e8a0a7b5ce045aa9bee5d8e43",
+ "size": 106686,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/fcbf03ffc7eb517e8a0a7b5ce045aa9bee5d8e43"
+ },
+ {
+ "path": "web/js/videoinfo.js",
+ "mode": "100644",
+ "type": "blob",
+ "sha": "b1a9871067e07dc09b37a8dd666ce531c2c5f56b",
+ "size": 4313,
+ "url": "https://api.github.com/repos/Kosinkadink/ComfyUI-VideoHelperSuite/git/blobs/b1a9871067e07dc09b37a8dd666ce531c2c5f56b"
+ }
+ ],
+ "truncated": false
+}
\ No newline at end of file
diff --git a/docs/hel-892/vhs-reference/4ee72c06/LICENSE b/docs/hel-892/vhs-reference/4ee72c06/LICENSE
new file mode 100644
index 00000000..f288702d
--- /dev/null
+++ b/docs/hel-892/vhs-reference/4ee72c06/LICENSE
@@ -0,0 +1,674 @@
+ GNU GENERAL PUBLIC LICENSE
+ Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc.
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+ Preamble
+
+ The GNU General Public License is a free, copyleft license for
+software and other kinds of works.
+
+ The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works. By contrast,
+the GNU General Public License is intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users. We, the Free Software Foundation, use the
+GNU General Public License for most of our software; it applies also to
+any other work released this way by its authors. You can apply it to
+your programs, too.
+
+ When we speak of free software, we are referring to freedom, not
+price. Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+ To protect your rights, we need to prevent others from denying you
+these rights or asking you to surrender the rights. Therefore, you have
+certain responsibilities if you distribute copies of the software, or if
+you modify it: responsibilities to respect the freedom of others.
+
+ For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must pass on to the recipients the same
+freedoms that you received. You must make sure that they, too, receive
+or can get the source code. And you must show them these terms so they
+know their rights.
+
+ Developers that use the GNU GPL protect your rights with two steps:
+(1) assert copyright on the software, and (2) offer you this License
+giving you legal permission to copy, distribute and/or modify it.
+
+ For the developers' and authors' protection, the GPL clearly explains
+that there is no warranty for this free software. For both users' and
+authors' sake, the GPL requires that modified versions be marked as
+changed, so that their problems will not be attributed erroneously to
+authors of previous versions.
+
+ Some devices are designed to deny users access to install or run
+modified versions of the software inside them, although the manufacturer
+can do so. This is fundamentally incompatible with the aim of
+protecting users' freedom to change the software. The systematic
+pattern of such abuse occurs in the area of products for individuals to
+use, which is precisely where it is most unacceptable. Therefore, we
+have designed this version of the GPL to prohibit the practice for those
+products. If such problems arise substantially in other domains, we
+stand ready to extend this provision to those domains in future versions
+of the GPL, as needed to protect the freedom of users.
+
+ Finally, every program is threatened constantly by software patents.
+States should not allow patents to restrict development and use of
+software on general-purpose computers, but in those that do, we wish to
+avoid the special danger that patents applied to a free program could
+make it effectively proprietary. To prevent this, the GPL assures that
+patents cannot be used to render the program non-free.
+
+ The precise terms and conditions for copying, distribution and
+modification follow.
+
+ TERMS AND CONDITIONS
+
+ 0. Definitions.
+
+ "This License" refers to version 3 of the GNU General Public License.
+
+ "Copyright" also means copyright-like laws that apply to other kinds of
+works, such as semiconductor masks.
+
+ "The Program" refers to any copyrightable work licensed under this
+License. Each licensee is addressed as "you". "Licensees" and
+"recipients" may be individuals or organizations.
+
+ To "modify" a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of an
+exact copy. The resulting work is called a "modified version" of the
+earlier work or a work "based on" the earlier work.
+
+ A "covered work" means either the unmodified Program or a work based
+on the Program.
+
+ To "propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy. Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
+
+ To "convey" a work means any kind of propagation that enables other
+parties to make or receive copies. Mere interaction with a user through
+a computer network, with no transfer of a copy, is not conveying.
+
+ An interactive user interface displays "Appropriate Legal Notices"
+to the extent that it includes a convenient and prominently visible
+feature that (1) displays an appropriate copyright notice, and (2)
+tells the user that there is no warranty for the work (except to the
+extent that warranties are provided), that licensees may convey the
+work under this License, and how to view a copy of this License. If
+the interface presents a list of user commands or options, such as a
+menu, a prominent item in the list meets this criterion.
+
+ 1. Source Code.
+
+ The "source code" for a work means the preferred form of the work
+for making modifications to it. "Object code" means any non-source
+form of a work.
+
+ A "Standard Interface" means an interface that either is an official
+standard defined by a recognized standards body, or, in the case of
+interfaces specified for a particular programming language, one that
+is widely used among developers working in that language.
+
+ The "System Libraries" of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that
+Major Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form. A
+"Major Component", in this context, means a major essential component
+(kernel, window system, and so on) of the specific operating system
+(if any) on which the executable work runs, or a compiler used to
+produce the work, or an object code interpreter used to run it.
+
+ The "Corresponding Source" for a work in object code form means all
+the source code needed to generate, install, and (for an executable
+work) run the object code and to modify the work, including scripts to
+control those activities. However, it does not include the work's
+System Libraries, or general-purpose tools or generally available free
+programs which are used unmodified in performing those activities but
+which are not part of the work. For example, Corresponding Source
+includes interface definition files associated with source files for
+the work, and the source code for shared libraries and dynamically
+linked subprograms that the work is specifically designed to require,
+such as by intimate data communication or control flow between those
+subprograms and other parts of the work.
+
+ The Corresponding Source need not include anything that users
+can regenerate automatically from other parts of the Corresponding
+Source.
+
+ The Corresponding Source for a work in source code form is that
+same work.
+
+ 2. Basic Permissions.
+
+ All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met. This License explicitly affirms your unlimited
+permission to run the unmodified Program. The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work. This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
+
+ You may make, run and propagate covered works that you do not
+convey, without conditions so long as your license otherwise remains
+in force. You may convey covered works to others for the sole purpose
+of having them make modifications exclusively for you, or provide you
+with facilities for running those works, provided that you comply with
+the terms of this License in conveying all material for which you do
+not control copyright. Those thus making or running the covered works
+for you must do so exclusively on your behalf, under your direction
+and control, on terms that prohibit them from making any copies of
+your copyrighted material outside their relationship with you.
+
+ Conveying under any other circumstances is permitted solely under
+the conditions stated below. Sublicensing is not allowed; section 10
+makes it unnecessary.
+
+ 3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+ No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
+similar laws prohibiting or restricting circumvention of such
+measures.
+
+ When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such circumvention
+is effected by exercising rights under this License with respect to
+the covered work, and you disclaim any intention to limit operation or
+modification of the work as a means of enforcing, against the work's
+users, your or third parties' legal rights to forbid circumvention of
+technological measures.
+
+ 4. Conveying Verbatim Copies.
+
+ You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice;
+keep intact all notices stating that this License and any
+non-permissive terms added in accord with section 7 apply to the code;
+keep intact all notices of the absence of any warranty; and give all
+recipients a copy of this License along with the Program.
+
+ You may charge any price or no price for each copy that you convey,
+and you may offer support or warranty protection for a fee.
+
+ 5. Conveying Modified Source Versions.
+
+ You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the
+terms of section 4, provided that you also meet all of these conditions:
+
+ a) The work must carry prominent notices stating that you modified
+ it, and giving a relevant date.
+
+ b) The work must carry prominent notices stating that it is
+ released under this License and any conditions added under section
+ 7. This requirement modifies the requirement in section 4 to
+ "keep intact all notices".
+
+ c) You must license the entire work, as a whole, under this
+ License to anyone who comes into possession of a copy. This
+ License will therefore apply, along with any applicable section 7
+ additional terms, to the whole of the work, and all its parts,
+ regardless of how they are packaged. This License gives no
+ permission to license the work in any other way, but it does not
+ invalidate such permission if you have separately received it.
+
+ d) If the work has interactive user interfaces, each must display
+ Appropriate Legal Notices; however, if the Program has interactive
+ interfaces that do not display Appropriate Legal Notices, your
+ work need not make them do so.
+
+ A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work,
+and which are not combined with it such as to form a larger program,
+in or on a volume of a storage or distribution medium, is called an
+"aggregate" if the compilation and its resulting copyright are not
+used to limit the access or legal rights of the compilation's users
+beyond what the individual works permit. Inclusion of a covered work
+in an aggregate does not cause this License to apply to the other
+parts of the aggregate.
+
+ 6. Conveying Non-Source Forms.
+
+ You may convey a covered work in object code form under the terms
+of sections 4 and 5, provided that you also convey the
+machine-readable Corresponding Source under the terms of this License,
+in one of these ways:
+
+ a) Convey the object code in, or embodied in, a physical product
+ (including a physical distribution medium), accompanied by the
+ Corresponding Source fixed on a durable physical medium
+ customarily used for software interchange.
+
+ b) Convey the object code in, or embodied in, a physical product
+ (including a physical distribution medium), accompanied by a
+ written offer, valid for at least three years and valid for as
+ long as you offer spare parts or customer support for that product
+ model, to give anyone who possesses the object code either (1) a
+ copy of the Corresponding Source for all the software in the
+ product that is covered by this License, on a durable physical
+ medium customarily used for software interchange, for a price no
+ more than your reasonable cost of physically performing this
+ conveying of source, or (2) access to copy the
+ Corresponding Source from a network server at no charge.
+
+ c) Convey individual copies of the object code with a copy of the
+ written offer to provide the Corresponding Source. This
+ alternative is allowed only occasionally and noncommercially, and
+ only if you received the object code with such an offer, in accord
+ with subsection 6b.
+
+ d) Convey the object code by offering access from a designated
+ place (gratis or for a charge), and offer equivalent access to the
+ Corresponding Source in the same way through the same place at no
+ further charge. You need not require recipients to copy the
+ Corresponding Source along with the object code. If the place to
+ copy the object code is a network server, the Corresponding Source
+ may be on a different server (operated by you or a third party)
+ that supports equivalent copying facilities, provided you maintain
+ clear directions next to the object code saying where to find the
+ Corresponding Source. Regardless of what server hosts the
+ Corresponding Source, you remain obligated to ensure that it is
+ available for as long as needed to satisfy these requirements.
+
+ e) Convey the object code using peer-to-peer transmission, provided
+ you inform other peers where the object code and Corresponding
+ Source of the work are being offered to the general public at no
+ charge under subsection 6d.
+
+ A separable portion of the object code, whose source code is excluded
+from the Corresponding Source as a System Library, need not be
+included in conveying the object code work.
+
+ A "User Product" is either (1) a "consumer product", which means any
+tangible personal property which is normally used for personal, family,
+or household purposes, or (2) anything designed or sold for incorporation
+into a dwelling. In determining whether a product is a consumer product,
+doubtful cases shall be resolved in favor of coverage. For a particular
+product received by a particular user, "normally used" refers to a
+typical or common use of that class of product, regardless of the status
+of the particular user or of the way in which the particular user
+actually uses, or expects or is expected to use, the product. A product
+is a consumer product regardless of whether the product has substantial
+commercial, industrial or non-consumer uses, unless such uses represent
+the only significant mode of use of the product.
+
+ "Installation Information" for a User Product means any methods,
+procedures, authorization keys, or other information required to install
+and execute modified versions of a covered work in that User Product from
+a modified version of its Corresponding Source. The information must
+suffice to ensure that the continued functioning of the modified object
+code is in no case prevented or interfered with solely because
+modification has been made.
+
+ If you convey an object code work under this section in, or with, or
+specifically for use in, a User Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+User Product is transferred to the recipient in perpetuity or for a
+fixed term (regardless of how the transaction is characterized), the
+Corresponding Source conveyed under this section must be accompanied
+by the Installation Information. But this requirement does not apply
+if neither you nor any third party retains the ability to install
+modified object code on the User Product (for example, the work has
+been installed in ROM).
+
+ The requirement to provide Installation Information does not include a
+requirement to continue to provide support service, warranty, or updates
+for a work that has been modified or installed by the recipient, or for
+the User Product in which it has been modified or installed. Access to a
+network may be denied when the modification itself materially and
+adversely affects the operation of the network or violates the rules and
+protocols for communication across the network.
+
+ Corresponding Source conveyed, and Installation Information provided,
+in accord with this section must be in a format that is publicly
+documented (and with an implementation available to the public in
+source code form), and must require no special password or key for
+unpacking, reading or copying.
+
+ 7. Additional Terms.
+
+ "Additional permissions" are terms that supplement the terms of this
+License by making exceptions from one or more of its conditions.
+Additional permissions that are applicable to the entire Program shall
+be treated as though they were included in this License, to the extent
+that they are valid under applicable law. If additional permissions
+apply only to part of the Program, that part may be used separately
+under those permissions, but the entire Program remains governed by
+this License without regard to the additional permissions.
+
+ When you convey a copy of a covered work, you may at your option
+remove any additional permissions from that copy, or from any part of
+it. (Additional permissions may be written to require their own
+removal in certain cases when you modify the work.) You may place
+additional permissions on material, added by you to a covered work,
+for which you have or can give appropriate copyright permission.
+
+ Notwithstanding any other provision of this License, for material you
+add to a covered work, you may (if authorized by the copyright holders of
+that material) supplement the terms of this License with terms:
+
+ a) Disclaiming warranty or limiting liability differently from the
+ terms of sections 15 and 16 of this License; or
+
+ b) Requiring preservation of specified reasonable legal notices or
+ author attributions in that material or in the Appropriate Legal
+ Notices displayed by works containing it; or
+
+ c) Prohibiting misrepresentation of the origin of that material, or
+ requiring that modified versions of such material be marked in
+ reasonable ways as different from the original version; or
+
+ d) Limiting the use for publicity purposes of names of licensors or
+ authors of the material; or
+
+ e) Declining to grant rights under trademark law for use of some
+ trade names, trademarks, or service marks; or
+
+ f) Requiring indemnification of licensors and authors of that
+ material by anyone who conveys the material (or modified versions of
+ it) with contractual assumptions of liability to the recipient, for
+ any liability that these contractual assumptions directly impose on
+ those licensors and authors.
+
+ All other non-permissive additional terms are considered "further
+restrictions" within the meaning of section 10. If the Program as you
+received it, or any part of it, contains a notice stating that it is
+governed by this License along with a term that is a further
+restriction, you may remove that term. If a license document contains
+a further restriction but permits relicensing or conveying under this
+License, you may add to a covered work material governed by the terms
+of that license document, provided that the further restriction does
+not survive such relicensing or conveying.
+
+ If you add terms to a covered work in accord with this section, you
+must place, in the relevant source files, a statement of the
+additional terms that apply to those files, or a notice indicating
+where to find the applicable terms.
+
+ Additional terms, permissive or non-permissive, may be stated in the
+form of a separately written license, or stated as exceptions;
+the above requirements apply either way.
+
+ 8. Termination.
+
+ You may not propagate or modify a covered work except as expressly
+provided under this License. Any attempt otherwise to propagate or
+modify it is void, and will automatically terminate your rights under
+this License (including any patent licenses granted under the third
+paragraph of section 11).
+
+ However, if you cease all violation of this License, then your
+license from a particular copyright holder is reinstated (a)
+provisionally, unless and until the copyright holder explicitly and
+finally terminates your license, and (b) permanently, if the copyright
+holder fails to notify you of the violation by some reasonable means
+prior to 60 days after the cessation.
+
+ Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+ Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License. If your rights have been terminated and not permanently
+reinstated, you do not qualify to receive new licenses for the same
+material under section 10.
+
+ 9. Acceptance Not Required for Having Copies.
+
+ You are not required to accept this License in order to receive or
+run a copy of the Program. Ancillary propagation of a covered work
+occurring solely as a consequence of using peer-to-peer transmission
+to receive a copy likewise does not require acceptance. However,
+nothing other than this License grants you permission to propagate or
+modify any covered work. These actions infringe copyright if you do
+not accept this License. Therefore, by modifying or propagating a
+covered work, you indicate your acceptance of this License to do so.
+
+ 10. Automatic Licensing of Downstream Recipients.
+
+ Each time you convey a covered work, the recipient automatically
+receives a license from the original licensors, to run, modify and
+propagate that work, subject to this License. You are not responsible
+for enforcing compliance by third parties with this License.
+
+ An "entity transaction" is a transaction transferring control of an
+organization, or substantially all assets of one, or subdividing an
+organization, or merging organizations. If propagation of a covered
+work results from an entity transaction, each party to that
+transaction who receives a copy of the work also receives whatever
+licenses to the work the party's predecessor in interest had or could
+give under the previous paragraph, plus a right to possession of the
+Corresponding Source of the work from the predecessor in interest, if
+the predecessor has it or can get it with reasonable efforts.
+
+ You may not impose any further restrictions on the exercise of the
+rights granted or affirmed under this License. For example, you may
+not impose a license fee, royalty, or other charge for exercise of
+rights granted under this License, and you may not initiate litigation
+(including a cross-claim or counterclaim in a lawsuit) alleging that
+any patent claim is infringed by making, using, selling, offering for
+sale, or importing the Program or any portion of it.
+
+ 11. Patents.
+
+ A "contributor" is a copyright holder who authorizes use under this
+License of the Program or a work on which the Program is based. The
+work thus licensed is called the contributor's "contributor version".
+
+ A contributor's "essential patent claims" are all patent claims
+owned or controlled by the contributor, whether already acquired or
+hereafter acquired, that would be infringed by some manner, permitted
+by this License, of making, using, or selling its contributor version,
+but do not include claims that would be infringed only as a
+consequence of further modification of the contributor version. For
+purposes of this definition, "control" includes the right to grant
+patent sublicenses in a manner consistent with the requirements of
+this License.
+
+ Each contributor grants you a non-exclusive, worldwide, royalty-free
+patent license under the contributor's essential patent claims, to
+make, use, sell, offer for sale, import and otherwise run, modify and
+propagate the contents of its contributor version.
+
+ In the following three paragraphs, a "patent license" is any express
+agreement or commitment, however denominated, not to enforce a patent
+(such as an express permission to practice a patent or covenant not to
+sue for patent infringement). To "grant" such a patent license to a
+party means to make such an agreement or commitment not to enforce a
+patent against the party.
+
+ If you convey a covered work, knowingly relying on a patent license,
+and the Corresponding Source of the work is not available for anyone
+to copy, free of charge and under the terms of this License, through a
+publicly available network server or other readily accessible means,
+then you must either (1) cause the Corresponding Source to be so
+available, or (2) arrange to deprive yourself of the benefit of the
+patent license for this particular work, or (3) arrange, in a manner
+consistent with the requirements of this License, to extend the patent
+license to downstream recipients. "Knowingly relying" means you have
+actual knowledge that, but for the patent license, your conveying the
+covered work in a country, or your recipient's use of the covered work
+in a country, would infringe one or more identifiable patents in that
+country that you have reason to believe are valid.
+
+ If, pursuant to or in connection with a single transaction or
+arrangement, you convey, or propagate by procuring conveyance of, a
+covered work, and grant a patent license to some of the parties
+receiving the covered work authorizing them to use, propagate, modify
+or convey a specific copy of the covered work, then the patent license
+you grant is automatically extended to all recipients of the covered
+work and works based on it.
+
+ A patent license is "discriminatory" if it does not include within
+the scope of its coverage, prohibits the exercise of, or is
+conditioned on the non-exercise of one or more of the rights that are
+specifically granted under this License. You may not convey a covered
+work if you are a party to an arrangement with a third party that is
+in the business of distributing software, under which you make payment
+to the third party based on the extent of your activity of conveying
+the work, and under which the third party grants, to any of the
+parties who would receive the covered work from you, a discriminatory
+patent license (a) in connection with copies of the covered work
+conveyed by you (or copies made from those copies), or (b) primarily
+for and in connection with specific products or compilations that
+contain the covered work, unless you entered into that arrangement,
+or that patent license was granted, prior to 28 March 2007.
+
+ Nothing in this License shall be construed as excluding or limiting
+any implied license or other defenses to infringement that may
+otherwise be available to you under applicable patent law.
+
+ 12. No Surrender of Others' Freedom.
+
+ If conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License. If you cannot convey a
+covered work so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you may
+not convey it at all. For example, if you agree to terms that obligate you
+to collect a royalty for further conveying from those to whom you convey
+the Program, the only way you could satisfy both those terms and this
+License would be to refrain entirely from conveying the Program.
+
+ 13. Use with the GNU Affero General Public License.
+
+ Notwithstanding any other provision of this License, you have
+permission to link or combine any covered work with a work licensed
+under version 3 of the GNU Affero General Public License into a single
+combined work, and to convey the resulting work. The terms of this
+License will continue to apply to the part which is the covered work,
+but the special requirements of the GNU Affero General Public License,
+section 13, concerning interaction through a network will apply to the
+combination as such.
+
+ 14. Revised Versions of this License.
+
+ The Free Software Foundation may publish revised and/or new versions of
+the GNU General Public License from time to time. Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+ Each version is given a distinguishing version number. If the
+Program specifies that a certain numbered version of the GNU General
+Public License "or any later version" applies to it, you have the
+option of following the terms and conditions either of that numbered
+version or of any later version published by the Free Software
+Foundation. If the Program does not specify a version number of the
+GNU General Public License, you may choose any version ever published
+by the Free Software Foundation.
+
+ If the Program specifies that a proxy can decide which future
+versions of the GNU General Public License can be used, that proxy's
+public statement of acceptance of a version permanently authorizes you
+to choose that version for the Program.
+
+ Later license versions may give you additional or different
+permissions. However, no additional obligations are imposed on any
+author or copyright holder as a result of your choosing to follow a
+later version.
+
+ 15. Disclaimer of Warranty.
+
+ THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
+OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
+IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
+ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+ 16. Limitation of Liability.
+
+ IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
+THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
+USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
+DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
+EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGES.
+
+ 17. Interpretation of Sections 15 and 16.
+
+ If the disclaimer of warranty and limitation of liability provided
+above cannot be given local legal effect according to their terms,
+reviewing courts shall apply local law that most closely approximates
+an absolute waiver of all civil liability in connection with the
+Program, unless a warranty or assumption of liability accompanies a
+copy of the Program in return for a fee.
+
+ END OF TERMS AND CONDITIONS
+
+ How to Apply These Terms to Your New Programs
+
+ If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+ To do so, attach the following notices to the program. It is safest
+to attach them to the start of each source file to most effectively
+state the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+
+ Copyright (C)
+
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program. If not, see .
+
+Also add information on how to contact you by electronic and paper mail.
+
+ If the program does terminal interaction, make it output a short
+notice like this when it starts in an interactive mode:
+
+ Copyright (C)
+ This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+ This is free software, and you are welcome to redistribute it
+ under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License. Of course, your program's commands
+might be different; for a GUI interface, you would use an "about box".
+
+ You should also get your employer (if you work as a programmer) or school,
+if any, to sign a "copyright disclaimer" for the program, if necessary.
+For more information on this, and how to apply and follow the GNU GPL, see
+.
+
+ The GNU General Public License does not permit incorporating your program
+into proprietary programs. If your program is a subroutine library, you
+may consider it more useful to permit linking proprietary applications with
+the library. If this is what you want to do, use the GNU Lesser General
+Public License instead of this License. But first, please read
+.
diff --git a/docs/hel-892/vhs-reference/4ee72c06/__init__.py b/docs/hel-892/vhs-reference/4ee72c06/__init__.py
new file mode 100644
index 00000000..9fa995f0
--- /dev/null
+++ b/docs/hel-892/vhs-reference/4ee72c06/__init__.py
@@ -0,0 +1,9 @@
+from .videohelpersuite.nodes import NODE_CLASS_MAPPINGS, NODE_DISPLAY_NAME_MAPPINGS
+import folder_paths
+from .videohelpersuite.server import server
+from .videohelpersuite import documentation
+from .videohelpersuite import latent_preview
+
+WEB_DIRECTORY = "./web"
+__all__ = ["NODE_CLASS_MAPPINGS", "NODE_DISPLAY_NAME_MAPPINGS", "WEB_DIRECTORY"]
+documentation.format_descriptions(NODE_CLASS_MAPPINGS)
diff --git a/docs/hel-892/vhs-reference/4ee72c06/pyproject.toml b/docs/hel-892/vhs-reference/4ee72c06/pyproject.toml
new file mode 100644
index 00000000..39793ee5
--- /dev/null
+++ b/docs/hel-892/vhs-reference/4ee72c06/pyproject.toml
@@ -0,0 +1,15 @@
+[project]
+name = "comfyui-videohelpersuite"
+description = "Nodes related to video workflows"
+version = "1.7.9"
+license = { file = "LICENSE" }
+dependencies = ["opencv-python", "imageio-ffmpeg"]
+
+[project.urls]
+Repository = "https://github.com/Kosinkadink/ComfyUI-VideoHelperSuite"
+
+# Used by Comfy Registry https://comfyregistry.org
+[tool.comfy]
+PublisherId = "kosinkadink"
+DisplayName = "ComfyUI-VideoHelperSuite"
+Icon = ""
diff --git a/docs/hel-892/vhs-reference/4ee72c06/video_formats/16bit-png.json b/docs/hel-892/vhs-reference/4ee72c06/video_formats/16bit-png.json
new file mode 100644
index 00000000..b768bdbc
--- /dev/null
+++ b/docs/hel-892/vhs-reference/4ee72c06/video_formats/16bit-png.json
@@ -0,0 +1,9 @@
+{
+ "main_pass":
+ [
+ "-n",
+ "-pix_fmt", "rgba64"
+ ],
+ "input_color_depth": "16bit",
+ "extension": "%03d.png"
+}
diff --git a/docs/hel-892/vhs-reference/4ee72c06/video_formats/8bit-png.json b/docs/hel-892/vhs-reference/4ee72c06/video_formats/8bit-png.json
new file mode 100644
index 00000000..88b27a75
--- /dev/null
+++ b/docs/hel-892/vhs-reference/4ee72c06/video_formats/8bit-png.json
@@ -0,0 +1,7 @@
+{
+ "main_pass":
+ [
+ "-n"
+ ],
+ "extension": "%03d.png"
+}
diff --git a/docs/hel-892/vhs-reference/4ee72c06/video_formats/ProRes.json b/docs/hel-892/vhs-reference/4ee72c06/video_formats/ProRes.json
new file mode 100644
index 00000000..eddd3acf
--- /dev/null
+++ b/docs/hel-892/vhs-reference/4ee72c06/video_formats/ProRes.json
@@ -0,0 +1,22 @@
+{
+ "main_pass":
+ [
+ "-n", "-c:v", "prores_ks",
+ "-profile:v", [["$profile"]],
+ ["profile", {
+ "lt": [[]], "1": [[]], "standard": [[]], "2": [[]], "hq": [[]], "3": [[]],
+ "4": ["has_alpha", {"True": [["-pix_fmt", "yuva444p10le"]],
+ "False": [["-pix_fmt", "yuv444p10le"]]}],
+ "4444": ["has_alpha", {"True": [["-pix_fmt", "yuva444p10le"]],
+ "False": [["-pix_fmt", "yuv444p10le"]]}],
+ "4444xq": ["has_alpha", {"True": [["-pix_fmt", "yuva444p10le"]],
+ "False": [["-pix_fmt", "yuv444p10le"]]}]
+ }],
+ "-vf", "scale=out_color_matrix=bt709",
+ "-colorspace", "bt709", "-color_primaries", "bt709", "-color_trc", "bt709"
+ ],
+ "fake_trc": "bt709",
+ "audio_pass": ["-c:a", "pcm_s16le"],
+ "extension": "mov",
+ "extra_widgets": [["profile", ["lt", "standard", "hq", "4444", "4444xq"], {"default": "hq"}]]
+}
diff --git a/docs/hel-892/vhs-reference/4ee72c06/video_formats/av1-webm.json b/docs/hel-892/vhs-reference/4ee72c06/video_formats/av1-webm.json
new file mode 100644
index 00000000..659ea166
--- /dev/null
+++ b/docs/hel-892/vhs-reference/4ee72c06/video_formats/av1-webm.json
@@ -0,0 +1,16 @@
+{
+ "main_pass":
+ [
+ "-n", "-c:v", "libsvtav1",
+ "-pix_fmt", ["pix_fmt", ["yuv420p10le", "yuv420p"]],
+ "-crf", ["crf","INT", {"default": 23, "min": 0, "max": 100, "step": 1}],
+ "-vf", "scale=out_color_matrix=bt709",
+ "-color_range", "tv", "-colorspace", "bt709", "-color_primaries", "bt709", "-color_trc", "bt709"
+ ],
+ "fake_trc": "bt709",
+ "audio_pass": ["-c:a", "libopus"],
+ "input_color_depth": ["input_color_depth", ["8bit", "16bit"]],
+ "save_metadata": ["save_metadata", "BOOLEAN", {"default": true}],
+ "extension": "webm",
+ "environment": {"SVT_LOG": "1"}
+}
diff --git a/docs/hel-892/vhs-reference/4ee72c06/video_formats/ffmpeg-gif.json b/docs/hel-892/vhs-reference/4ee72c06/video_formats/ffmpeg-gif.json
new file mode 100644
index 00000000..3ca08650
--- /dev/null
+++ b/docs/hel-892/vhs-reference/4ee72c06/video_formats/ffmpeg-gif.json
@@ -0,0 +1,8 @@
+{
+ "main_pass":
+ [
+ "-n",
+ "-filter_complex", ["dither", ["bayer", "heckbert", "floyd_steinberg", "sierra2", "sierra2_4a", "sierra3", "burkes", "atkinson", "none"], {"default": "sierra2_4a"}, "[0:v] split [a][b]; [a] palettegen=reserve_transparent=on:transparency_color=ffffff [p]; [b][p] paletteuse=dither=$val"]
+ ],
+ "extension": "gif"
+}
diff --git a/docs/hel-892/vhs-reference/4ee72c06/video_formats/ffv1-mkv.json b/docs/hel-892/vhs-reference/4ee72c06/video_formats/ffv1-mkv.json
new file mode 100644
index 00000000..3248e5fc
--- /dev/null
+++ b/docs/hel-892/vhs-reference/4ee72c06/video_formats/ffv1-mkv.json
@@ -0,0 +1,18 @@
+{
+ "main_pass": [
+ "-n",
+ "-c:v", "ffv1",
+ "-level", ["level", ["0", "1", "3"], {"default": "3"}],
+ "-coder", ["coder", ["0", "1", "2"], {"default": "1"}],
+ "-context", ["context", ["0", "1"], {"default": "1"}],
+ "-g", ["gop_size", "INT", {"default": 1, "min": 1, "max": 300, "step": 1}],
+ "-slices", ["slices", ["4", "6", "9", "12", "16", "20", "24", "30"], {"default": "16"}],
+ "-slicecrc", ["slicecrc", ["0", "1"], {"default": "1"}],
+ "-pix_fmt", ["pix_fmt", ["rgba64le", "bgra", "yuv420p", "yuv422p", "yuv444p", "yuva420p", "yuva422p", "yuva444p", "yuv420p10le", "yuv422p10le", "yuv444p10le", "yuv420p12le", "yuv422p12le", "yuv444p12le", "yuv420p14le", "yuv422p14le", "yuv444p14le", "yuv420p16le", "yuv422p16le", "yuv444p16le", "gray", "gray10le", "gray12le", "gray16le"], {"default": "rgba64le"}]
+ ],
+ "audio_pass": ["-c:a", "flac"],
+ "save_metadata": ["save_metadata", "BOOLEAN", {"default": true}],
+ "trim_to_audio": ["trim_to_audio", "BOOLEAN", {"default": false}],
+ "input_color_depth": "16bit",
+ "extension": "mkv"
+}
diff --git a/docs/hel-892/vhs-reference/4ee72c06/video_formats/gifski.json b/docs/hel-892/vhs-reference/4ee72c06/video_formats/gifski.json
new file mode 100644
index 00000000..c96b358a
--- /dev/null
+++ b/docs/hel-892/vhs-reference/4ee72c06/video_formats/gifski.json
@@ -0,0 +1,12 @@
+{
+ "main_pass":
+ [
+ "-pix_fmt", "yuv444p",
+ "-vf", "scale=out_color_matrix=bt709:out_range=pc",
+ "-color_range", "pc"
+ ],
+ "extension": "gif",
+ "gifski_pass": [
+ "-Q", ["quality","INT", {"default": 90, "min": 1, "max": 100, "step": 1}]
+ ]
+}
diff --git a/docs/hel-892/vhs-reference/4ee72c06/video_formats/h264-mp4.json b/docs/hel-892/vhs-reference/4ee72c06/video_formats/h264-mp4.json
new file mode 100644
index 00000000..4aa0bd57
--- /dev/null
+++ b/docs/hel-892/vhs-reference/4ee72c06/video_formats/h264-mp4.json
@@ -0,0 +1,15 @@
+{
+ "main_pass":
+ [
+ "-n", "-c:v", "libx264",
+ "-pix_fmt", ["pix_fmt", ["yuv420p", "yuv420p10le"]],
+ "-crf", ["crf","INT", {"default": 19, "min": 0, "max": 100, "step": 1}],
+ "-vf", "scale=out_color_matrix=bt709",
+ "-color_range", "tv", "-colorspace", "bt709", "-color_primaries", "bt709", "-color_trc", "bt709"
+ ],
+ "fake_trc": "bt709",
+ "audio_pass": ["-c:a", "aac", "-movflags", "use_metadata_tags"],
+ "save_metadata": ["save_metadata", "BOOLEAN", {"default": true}],
+ "trim_to_audio": ["trim_to_audio", "BOOLEAN", {"default": false}],
+ "extension": "mp4"
+}
diff --git a/docs/hel-892/vhs-reference/4ee72c06/video_formats/h265-mp4.json b/docs/hel-892/vhs-reference/4ee72c06/video_formats/h265-mp4.json
new file mode 100644
index 00000000..559c3507
--- /dev/null
+++ b/docs/hel-892/vhs-reference/4ee72c06/video_formats/h265-mp4.json
@@ -0,0 +1,17 @@
+{
+ "main_pass":
+ [
+ "-n", "-c:v", "libx265",
+ "-vtag", "hvc1",
+ "-pix_fmt", ["pix_fmt", ["yuv420p10le", "yuv420p"]],
+ "-crf", ["crf","INT", {"default": 22, "min": 0, "max": 100, "step": 1}],
+ "-preset", "medium",
+ "-x265-params", "log-level=quiet",
+ "-vf", "scale=out_color_matrix=bt709",
+ "-color_range", "tv", "-colorspace", "bt709", "-color_primaries", "bt709", "-color_trc", "bt709"
+ ],
+ "fake_trc": "bt709",
+ "audio_pass": ["-c:a", "aac", "-movflags", "use_metadata_tags"],
+ "save_metadata": ["save_metadata", "BOOLEAN", {"default": true}],
+ "extension": "mp4"
+}
diff --git a/docs/hel-892/vhs-reference/4ee72c06/video_formats/nvenc_av1-mp4.json b/docs/hel-892/vhs-reference/4ee72c06/video_formats/nvenc_av1-mp4.json
new file mode 100644
index 00000000..ed8294fc
--- /dev/null
+++ b/docs/hel-892/vhs-reference/4ee72c06/video_formats/nvenc_av1-mp4.json
@@ -0,0 +1,15 @@
+{
+ "main_pass":
+ [
+ "-n", "-c:v", "av1_nvenc",
+ "-pix_fmt", ["pix_fmt", ["yuv420p", "p010le"]],
+ "-vf", "scale=out_color_matrix=bt709",
+ "-color_range", "tv", "-colorspace", "bt709", "-color_primaries", "bt709", "-color_trc", "bt709"
+ ],
+ "fake_trc": "bt709",
+ "audio_pass": ["-c:a", "aac", "-movflags", "use_metadata_tags"],
+ "bitrate": ["bitrate","INT", {"default": 10, "min": 1, "max": 999, "step": 1 }],
+ "megabit": ["megabit","BOOLEAN", {"default": true}],
+ "save_metadata": ["save_metadata", "BOOLEAN", {"default": true}],
+ "extension": "mp4"
+}
diff --git a/docs/hel-892/vhs-reference/4ee72c06/video_formats/nvenc_h264-mp4.json b/docs/hel-892/vhs-reference/4ee72c06/video_formats/nvenc_h264-mp4.json
new file mode 100644
index 00000000..f8676304
--- /dev/null
+++ b/docs/hel-892/vhs-reference/4ee72c06/video_formats/nvenc_h264-mp4.json
@@ -0,0 +1,15 @@
+{
+ "main_pass":
+ [
+ "-n", "-c:v", "h264_nvenc",
+ "-pix_fmt", ["pix_fmt", ["yuv420p", "p010le"]],
+ "-vf", "scale=out_color_matrix=bt709",
+ "-color_range", "tv", "-colorspace", "bt709", "-color_primaries", "bt709", "-color_trc", "bt709"
+ ],
+ "fake_trc": "bt709",
+ "audio_pass": ["-c:a", "aac", "-movflags", "use_metadata_tags"],
+ "bitrate": ["bitrate","INT", {"default": 10, "min": 1, "max": 999, "step": 1 }],
+ "megabit": ["megabit","BOOLEAN", {"default": true}],
+ "save_metadata": ["save_metadata", "BOOLEAN", {"default": true}],
+ "extension": "mp4"
+}
diff --git a/docs/hel-892/vhs-reference/4ee72c06/video_formats/nvenc_hevc-mp4.json b/docs/hel-892/vhs-reference/4ee72c06/video_formats/nvenc_hevc-mp4.json
new file mode 100644
index 00000000..a374ecde
--- /dev/null
+++ b/docs/hel-892/vhs-reference/4ee72c06/video_formats/nvenc_hevc-mp4.json
@@ -0,0 +1,16 @@
+{
+ "main_pass":
+ [
+ "-n", "-c:v", "hevc_nvenc",
+ "-vtag", "hvc1",
+ "-pix_fmt", ["pix_fmt", ["yuv420p", "p010le"]],
+ "-vf", "scale=out_color_matrix=bt709",
+ "-color_range", "tv", "-colorspace", "bt709", "-color_primaries", "bt709", "-color_trc", "bt709"
+ ],
+ "fake_trc": "bt709",
+ "audio_pass": ["-c:a", "aac", "-movflags", "use_metadata_tags"],
+ "bitrate": ["bitrate","INT", {"default": 10, "min": 1, "max": 999, "step": 1 }],
+ "megabit": ["megabit","BOOLEAN", {"default": true}],
+ "save_metadata": ["save_metadata", "BOOLEAN", {"default": true}],
+ "extension": "mp4"
+}
diff --git a/docs/hel-892/vhs-reference/4ee72c06/video_formats/webm.json b/docs/hel-892/vhs-reference/4ee72c06/video_formats/webm.json
new file mode 100644
index 00000000..6323f619
--- /dev/null
+++ b/docs/hel-892/vhs-reference/4ee72c06/video_formats/webm.json
@@ -0,0 +1,16 @@
+{
+ "main_pass":
+ [
+ "-n",
+ "-pix_fmt", ["pix_fmt",["yuv420p","yuva420p"]],
+ "-crf", ["crf","INT", {"default": 20, "min": 0, "max": 100, "step": 1}],
+ "-b:v", "0",
+ "-vf", "scale=out_color_matrix=bt709",
+ "-color_range", "tv", "-colorspace", "bt709", "-color_primaries", "bt709", "-color_trc", "bt709"
+ ],
+ "fake_trc": "bt709",
+ "audio_pass": ["-c:a", "libvorbis"],
+ "save_metadata": ["save_metadata", "BOOLEAN", {"default": true}],
+ "trim_to_audio": ["trim_to_audio", "BOOLEAN", {"default": false}],
+ "extension": "webm"
+}
diff --git a/docs/hel-892/vhs-reference/4ee72c06/videohelpersuite/batched_nodes.py b/docs/hel-892/vhs-reference/4ee72c06/videohelpersuite/batched_nodes.py
new file mode 100644
index 00000000..624bb84f
--- /dev/null
+++ b/docs/hel-892/vhs-reference/4ee72c06/videohelpersuite/batched_nodes.py
@@ -0,0 +1,56 @@
+import torch
+from nodes import VAEEncode
+from comfy.utils import ProgressBar
+
+
+class VAEDecodeBatched:
+ @classmethod
+ def INPUT_TYPES(s):
+ return {
+ "required": {
+ "samples": ("LATENT", ),
+ "vae": ("VAE", ),
+ "per_batch": ("INT", {"default": 16, "min": 1})
+ }
+ }
+
+ CATEGORY = "Video Helper Suite 🎥🅥🅗🅢/batched nodes"
+
+ RETURN_TYPES = ("IMAGE",)
+ FUNCTION = "decode"
+
+ def decode(self, vae, samples, per_batch):
+ decoded = []
+ pbar = ProgressBar(samples["samples"].shape[0])
+ for start_idx in range(0, samples["samples"].shape[0], per_batch):
+ decoded.append(vae.decode(samples["samples"][start_idx:start_idx+per_batch]))
+ pbar.update(per_batch)
+ return (torch.cat(decoded, dim=0), )
+
+
+class VAEEncodeBatched:
+ @classmethod
+ def INPUT_TYPES(s):
+ return {
+ "required": {
+ "pixels": ("IMAGE", ), "vae": ("VAE", ),
+ "per_batch": ("INT", {"default": 16, "min": 1})
+ }
+ }
+
+ CATEGORY = "Video Helper Suite 🎥🅥🅗🅢/batched nodes"
+
+ RETURN_TYPES = ("LATENT",)
+ FUNCTION = "encode"
+
+ def encode(self, vae, pixels, per_batch):
+ t = []
+ pbar = ProgressBar(pixels.shape[0])
+ for start_idx in range(0, pixels.shape[0], per_batch):
+ try:
+ sub_pixels = vae.vae_encode_crop_pixels(pixels[start_idx:start_idx+per_batch])
+ except:
+ sub_pixels = VAEEncode.vae_encode_crop_pixels(pixels[start_idx:start_idx+per_batch])
+ t.append(vae.encode(sub_pixels[:,:,:,:3]))
+ pbar.update(per_batch)
+ return ({"samples": torch.cat(t, dim=0)}, )
diff --git a/docs/hel-892/vhs-reference/4ee72c06/videohelpersuite/documentation.py b/docs/hel-892/vhs-reference/4ee72c06/videohelpersuite/documentation.py
new file mode 100644
index 00000000..857de6c6
--- /dev/null
+++ b/docs/hel-892/vhs-reference/4ee72c06/videohelpersuite/documentation.py
@@ -0,0 +1,616 @@
+from .logger import logger
+
+def image(src):
+ return f''
+def video(src):
+ return f'