57 lines
2.0 KiB
Markdown
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'
|
|
```
|