aliensmn commited on
Commit
1c6a2c9
Β·
verified Β·
1 Parent(s): 96fb74a

Add YAML metadata to fix model card warning

Browse files
Files changed (1) hide show
  1. README.md +40 -99
README.md CHANGED
@@ -1,110 +1,51 @@
 
 
 
 
 
 
 
 
 
 
1
  # ComfyUI-VideoHelperSuite
2
- Nodes related to video workflows
3
 
4
- ## I/O Nodes
5
- ### Load Video
6
- Converts a video file into a series of images
7
- - video: The video file to be loaded
8
- - force_rate: Discards or duplicates frames as needed to hit a target frame rate. Disabled by setting to 0. This can be used to quickly match a suggested frame rate like the 8 fps of AnimateDiff.
9
- - force_size: Allows for quick resizing to a number of suggested sizes. Several options allow you to set only width or height and determine the other from aspect ratio.
10
- - frame_load_cap: The maximum number of frames which will be returned. This could also be thought of as the maximum batch size.
11
- - skip_first_frames: How many frames to skip from the start of the video after adjusting for a forced frame rate. By incrementing this number by the frame_load_cap, you can easily process a longer input video in parts.
12
- - select_every_nth: Allows for skipping a number of frames without considering the base frame rate or risking frame duplication. Often useful when working with animated gifs
13
- A path variant of the Load Video node exists that allows loading videos from external paths
14
- ![step](https://github.com/Kosinkadink/ComfyUI-VideoHelperSuite/assets/4284322/b5fc993c-5c9b-4608-afa4-48ae2e1380ef)
15
- ![resize](https://github.com/Kosinkadink/ComfyUI-VideoHelperSuite/assets/4284322/98d2e78e-1c44-443c-a8fe-0dab0b5947f3)
16
- If [Advanced Previews](#advanced-previews) is enabled in the options menu of the web ui, the preview will reflect the current settings on the node.
17
- ### Load Image Sequence
18
- Loads all image files from a subfolder. Options are similar to Load Video.
19
- - image_load_cap: The maximum number of images which will be returned. This could also be thought of as the maximum batch size.
20
- - skip_first_images: How many images to skip. By incrementing this number by image_load_cap, you can easily divide a long sequence of images into multiple batches.
21
- - select_every_nth: Allows for skipping a number of images between every returned frame.
22
 
23
- A path variant of Load Image sequence also exists.
24
- ### Video Combine
25
- Combines a series of images into an output video
26
- If the optional audio input is provided, it will also be combined into the output video
27
- - frame_rate: How many of the input frames are displayed per second. A higher frame rate means that the output video plays faster and has less duration. This should usually be kept to 8 for AnimateDiff, or matched to the force_rate of a Load Video node.
28
- - loop_count: How many additional times the video should repeat
29
- - filename_prefix: The base file name used for output.
30
- - You can save output to a subfolder: `subfolder/video`
31
- - Like the builtin Save Image node, you can add timestamps. `%date:yyyy-MM-ddThh:mm:ss%` might become 2023-10-31T6:45:25
32
- - format: The file format to use. Advanced information on configuring or adding additional video formats can be found in the [Video Formats](#video-formats) section.
33
- - pingpong: Causes the input to be played back in the reverse to create a clean loop.
34
- - save_output: Whether the image should be put into the output directory or the temp directory.
35
- Returns: a `VHS_FILENAMES` which consists of a boolean indicating if save_output is enabled and a list of the full filepaths of all generated outputs in the order created. Accordingly `output[1][-1]` will be the most complete output.
36
-
37
- Depending on the format chosen, additional options may become available, including
38
- - crf: Describes the quality of the output video. A lower number gives a higher quality video and a larger file size, while a higher number gives a lower quality video with a smaller size. Scaling varies by codec, but visually lossless output generally occurs around 20.
39
- - save_metadata: Includes a copy of the workflow in the output video which can be loaded by dragging and dropping the video, just like with images.
40
- - pix_fmt: Changes how the pixel data is stored. `yuv420p10le` has higher color quality, but won't work on all devices
41
- ### Load Audio
42
- Provides a way to load standalone audio files.
43
- - seek_seconds: An optional start time for the audio file in seconds.
44
 
45
- ## Latent/Image Nodes
46
- A number of utility nodes exist for managing latents. For each, there is an equivalent node which works on images.
47
- ### Split Batch
48
- Divides the latents into two sets. The first `split_index` latents go to output A and the remainder to output B. If less then `split_index` latents are provided as input, all are passed to output A and output B is empty.
49
- ### Merge Batch
50
- Combines two groups of latents into a single output. The order of the output is the latents in A followed by the latents in B.
51
- If the input groups are not the same size, the node provides options for rescaling the latents before merging.
52
- ### Select Every Nth
53
- The first of every `select_every_nth` input is passed and the remainder are discarded
54
- ### Get Count
55
- ### Duplicate Batch
56
 
57
- ## Video Previews
58
- Load Video (Upload), Load Video (Path), Load Images (Upload), Load Images (Path) and Video Combine provide animated previews.
59
- Nodes with previews provide additional functionality when right clicked
60
- - Open preview
61
- - Save preview
62
- - Pause preview: Can improve performance with very large videos
63
- - Hide preview: Can improve performance, save space
64
- - Sync preview: Restarts all previews for side-by-side comparisons
65
 
66
- ### Advanced Previews
67
- Advanced Previews must be manually enabled by clicking the settings gear next to Queue Prompt and checking the box for VHS Advanced Previews.
68
- If enabled, videos which are displayed in the ui will be converted with ffmpeg on request. This has several benefits
69
- - Previews for Load Video nodes will reflect the settings on the node such as skip_first_frames and frame_load_cap
70
- - This makes it easy to select an exact portion of an input video and sync it with outputs
71
- - It can use substantially less bandwidth if running the server remotely
72
- - It can greatly improve the browser performance by downsizing videos to the in ui resolution, particularly useful with animated gifs
73
- - It allows for previews of videos that would not normally be playable in browser.
74
- - Can be limited to subdirectories of ComyUI if `VHS_STRICT_PATHS` is set as an environment variable.
75
 
76
- This fucntionality is disabled since it comes with several downsides
77
- - There is a delay before videos show in the browser. This delay can become quite large if the input video is long
78
- - The preview videos are lower quality (The original can always be viewed with Right Click -> Open preview)
79
 
80
- ## Video Formats
81
- Those familiar with ffmpeg are able to add json files to the video_formats folders to add new output types to Video Combine.
82
- Consider the following example for av1-webm
83
- ```json
84
- {
85
- "main_pass":
86
- [
87
- "-n", "-c:v", "libsvtav1",
88
- "-pix_fmt", "yuv420p10le",
89
- "-crf", ["crf","INT", {"default": 23, "min": 0, "max": 100, "step": 1}]
90
- ],
91
- "audio_pass": ["-c:a", "libopus"],
92
- "extension": "webm",
93
- "environment": {"SVT_LOG": "1"}
94
- }
95
- ```
96
- Most configuration takes place in `main_pass`, which is a list of arguments that are passed to ffmpeg.
97
- - `"-n"` designates that the command should fail if a file of the same name already exists. This should never happen, but if some bug were to occur, it would ensure other files aren't overwritten.
98
- - `"-c:v", "libsvtav1"` designates that the video should be encoded with an av1 codec using the new SVT-AV1 encoder. SVT-AV1 is much faster than libaom-av1, but may not exist in older versions of ffmpeg. Alternatively, av1_nvenc could be used for gpu encoding with newer nvidia cards.
99
- - `"-pix_fmt", "yuv420p10le"` designates the standard pixel format with 10-bit color. It's important that some pixel format be specified to ensure a nonconfigurable input pix_fmt isn't used.
100
 
101
- `audio pass` contains a list of arguments which are passed to ffmpeg when audio is passed into Video Combine
102
 
103
- `extension` designates both the file extension and the container format that is used. If some of the above options are omitted from `main_pass` it can affect what default options are chosen.
104
- `environment` can optionally be provided to set environment variables during execution. For av1 it's used to reduce the verbosity of logging so that only major errors are displayed.
105
- `input_color_depth` effects the format in which pixels are passed to the ffmpeg subprocess. Current valid options are `8bit` and `16bit`. The later will produce higher quality output, but is experimental.
106
 
107
- Fields can be exposed in the webui as a widget using a format similar to what is used in the creation of custom nodes. In the above example, the argument for `-crf` will be exposed as a format widget in the webui. Format widgets are a list of up to 3 terms
108
- - The name of the widget that will be displayed in the web ui
109
- - Either a primitive such as "INT" or "BOOLEAN", or a list of string options
110
- - A dictionary of options
 
1
+ ---
2
+ license: mit
3
+ tags:
4
+ - comfyui
5
+ - comfyui-custom-nodes
6
+ - mirror
7
+ - github-mirror
8
+ library_name: comfyui
9
+ ---
10
+
11
  # ComfyUI-VideoHelperSuite
 
12
 
13
+ πŸ”„ **Mirror of GitHub Repository**
14
+
15
+ This is a personal mirror of the original GitHub repository for easy access and backup.
16
+
17
+ ## πŸ“¦ Original Source
18
+
19
+ **GitHub:** [https://github.com/Kosinkadink/ComfyUI-VideoHelperSuite](https://github.com/Kosinkadink/ComfyUI-VideoHelperSuite)
20
+
21
+ ## 🎯 Purpose
 
 
 
 
 
 
 
 
 
22
 
23
+ This mirror is maintained for:
24
+ - βœ… Easy access and backup
25
+ - βœ… Integration with Hugging Face workflows
26
+ - βœ… Personal development and testing
27
+ - βœ… Offline availability
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
28
 
29
+ ## πŸ“– Usage
 
 
 
 
 
 
 
 
 
 
30
 
31
+ Please refer to the original GitHub repository for:
32
+ - Latest updates and releases
33
+ - Installation instructions
34
+ - Documentation
35
+ - Issues and support
36
+ - Contributing guidelines
 
 
37
 
38
+ ## πŸ™ Attribution
 
 
 
 
 
 
 
 
39
 
40
+ All code and content in this repository belongs to the original authors and contributors.
41
+ This is purely a mirror for personal convenience.
 
42
 
43
+ **Please support the original project:** https://github.com/Kosinkadink/ComfyUI-VideoHelperSuite
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
44
 
45
+ ---
46
 
47
+ **Mirrored by:** aliensmn
48
+ **Mirror Type:** ComfyUI Custom Node
49
+ **Original Repository:** https://github.com/Kosinkadink/ComfyUI-VideoHelperSuite
50
 
51
+ *If you are the original author and would like this mirror removed, please contact me.*