Files
DumasNodes/README.md
T

57 lines
2.0 KiB
Markdown

# DumasNodes
Generic ComfyUI utility nodes under the Dumas brand. The repository contains
image, JSON and video utilities and intentionally has no model-specific video
sampler dependency.
## Sequential video assembly
### Dumas Standalone Video
`DumasStandaloneVideo` saves both the complete generated clip and a full copy.
For a continuation clip, set `reference_frames` to the number of frames taken
from the previous clip for continuity. The value is returned as the final
`reference_frames` output so it can be wired directly into
`DumasJoinVideoClips`.
### Dumas Join Video Clips (No Re-encode)
`DumasJoinVideoClips` accepts one reference-frame input for each clip. It trims
that many frames from the beginning of any clip whose value is greater than
zero, then concatenates the resulting files with FFmpeg stream copy. This
avoids a full re-encode of the assembled video. Clip 1 normally remains at
zero; continuation clips receive the reference-frame output from their
standalone nodes.
Stream-copy trimming is codec/keyframe-aware: the requested boundary is
converted using the clip's frame rate, but a codec may choose the nearest safe
packet boundary. For exact frame cuts, use the existing `complete_clip` output
or accept a re-encoded workflow.
### Dumas Prepare Continuation
Give this node the raw output of a continuation generation and its reference
frame count. It produces a clean presentation clip and a `next_reference`
tail clip. Only the tail is intended to feed the next generation; the entire
previous clip is never passed forward as the continuity input.
## Other nodes
- Dumas Image Compare
- Save Image Dumas
- Load Images from Folder Dumas
- Dumas JSON helpers
## Installation
Copy or clone this repository into `ComfyUI/custom_nodes/DumasNodes` and restart
ComfyUI. FFmpeg and FFprobe must be available on `PATH` for the video nodes.
## Development
Run the fast unit tests from the repository root:
```bash
python -m unittest discover -s tests -p 'test_*.py'
```