OpenKatana · Render to video:
OpenKatanaRenderVideo turns a saved OpenKatana project timeline into a complete rendered video, including its soundtrack, while also preparing a small selection of still frames for visual inspection in ComfyUI. It renders the existing edit rather than creating a new one, so your timeline must already be saved before rendering begins. The node waits for the rendering job to finish, then makes the finished movie available without loading every video frame into an image batch. For quick review, it separately samples frames across the rendered sequence and limits their number according to the requested preview size and a memory-based safeguard. This separation lets you inspect the overall look of your edit without confusing a lightweight preview with the complete movie.
OpenKatana · Render to video Input Parameters:
project_id
A required STRING identifying the OpenKatana project whose saved timeline you want to render. The default is my-film; no minimum length, maximum length, or list of allowed values is specified in this node. Use the same project identifier that you used when opening your workspace and saving your edit. This value determines which project's timeline is rendered; it does not create a timeline or select an individual source clip. The chosen project must be accessible in the active OpenKatana workspace and must already contain a saved timeline.
preview_frames
A required INT controlling the requested maximum number of still images in the preview batch. The default is 16, the minimum is 1, and the maximum is 256. The node selects frames at evenly spaced positions across the rendered frame sequence, making the preview useful for checking different parts of your edit rather than only its beginning. The actual batch can contain fewer images if the video has fewer frames or if the memory-based limit reduces the count. That limit estimates how many full-resolution, three-channel, 32-bit floating-point frames fit within approximately 256 MiB, with at least one frame selected. This is not a guarantee of total memory usage, because preparing and stacking the images also requires memory. Changing this setting affects only the preview batch, not the finished video's duration, frame rate, image quality, or soundtrack.
after
An optional STRING connection input with no explicit default value or defined length limits. This input is intended to receive a preceding operation's result, such as the result_json from OpenKatanaMakeEdit, so rendering can follow that operation in your graph. It does not supply the timeline itself or override project_id; the node still renders the saved project timeline. If a nonempty value begins with an opening brace after leading whitespace is removed, the node parses it as JSON and checks its state field. When that field is skipped, rendering is skipped with the message No edit was made, so nothing was rendered. Otherwise, rendering proceeds normally. Because JSON-looking text is parsed directly, malformed JSON in this connection can stop execution.
OpenKatana · Render to video Output Parameters:
video
A VIDEO object backed by the completed rendered video file. It contains the full movie and soundtrack, rather than only the frames chosen for preview, and can be passed to compatible ComfyUI video nodes. The node creates this object from the render result's video_path after the rendering job succeeds. Its completeness is independent of the preview frame count: requesting a single preview image still leaves the full rendered movie available here. If rendering is intentionally skipped through after, this output is None rather than a video.
preview_frames
An IMAGE batch containing selected still frames from the completed render. The images are converted to RGB, represented as floating-point values from 0 to 1, and arranged as a batch with dimensions corresponding to frame count, height, width, and three color channels. Frames are sampled across the sequence, subject to the requested count, the number of available frames, and the memory-based limit. These images help you review composition, colors, and changes across the edit without loading the entire movie as images. They do not contain audio and should not be treated as a complete frame-by-frame representation of the movie. If rendering is intentionally skipped through after, this output is None.
result_json
A STRING containing JSON-formatted information about the render and its preview selection. During normal successful execution, it includes the render job's returned details together with values used or added by the media rendering process, including video_path, frames_directory, the timeline's canvas fps, and preview_frame_indices. The preview indices are zero-based positions in the sorted rendered PNG sequence, so an index of 0 refers to its first frame. This information is useful for checking which frames were sampled, locating generated media, and passing execution results to other compatible nodes. When the node takes the skip path, it returns a skip response instead of the normal successful-render metadata.
OpenKatana · Render to video Usage Tips:
- Save your edit before rendering. A typical connection is OpenKatanaMakeEdit's
result_jsonto this node'safterinput, with both nodes using the sameproject_id. - Keep
project_idconsistent throughout your graph. Theafterconnection controls execution dependency and skip handling; it does not automatically select the preceding node's project. - Start with the default
preview_framesvalue of16for a general visual check. Reduce it to1or a small number when working with large images or when you only need to confirm that rendering succeeded. - Increase
preview_frameswhen you want broader coverage of a long or visually varied edit, but remember that the actual count may be reduced by the memory safeguard. Evenly spaced stills can miss brief transitions or visual glitches. - Use the
videooutput to review timing, motion, transitions, and audio synchronization. The preview batch is useful for still-image inspection but cannot replace watching the finished movie. - Change resolution, frame rate, timing, and soundtrack in the saved timeline before rendering. This node has no controls for those settings, and increasing the preview count does not improve the rendered video's quality.
- Check
preview_frame_indicesinresult_jsonwhen you need to know exactly which rendered frames appear in the preview batch.
OpenKatana · Render to video Common Errors and Solutions:
Save a timeline first, or connect Make edit to this node
- Explanation: The selected project has no saved timeline, so there is no edit to render.
- Solution: Create and save an edit for the same
project_id. Connect OpenKatanaMakeEdit's result toafterto ensure the edit operation runs before rendering.
Render [state]: [job details]
- Explanation: The rendering helper raises an error beginning with
Renderwhen the job does not finish in thesucceededstate. The message includes its state and serialized job details. Rendering is checked for approximately 3,500 seconds; a job that remains running beyond that waiting period also triggers this error. - Solution: Read the included job details and OpenKatana logs for the underlying problem. Check the project's media and rendering environment before retrying. If the reported state is still
running, check whether the original job is continuing before starting another render.
JSONDecodeError in after
- Explanation: A value in
afterstarts like a JSON object but is not valid JSON. The node attempts to parse that text before starting the render, so malformed text can stop execution. - Solution: Connect the preceding node's original JSON result directly rather than editing it manually. If you do not need this execution dependency, leave
afterdisconnected.
No edit was made, so nothing was rendered.
- Explanation: This is an intentional skip message, not a rendering failure. The JSON supplied through
aftercontains astatevalue ofskipped, so the node does not start a render and returns no video or preview images. - Solution: Inspect the preceding edit operation to find out why it skipped. If you deliberately want to render an already saved timeline, leave
afterdisconnected and verify thatproject_idpoints to that timeline.
IndexError: list index out of range
- Explanation: This can occur while preparing the preview if the reported frames directory contains no PNG files. The node opens the first file to determine image dimensions, so an empty file list prevents preview creation even if a render result was returned.
- Solution: Check the render's frames directory and job logs. Confirm that rendering produced PNG frames and that they were not moved or deleted before this node read them. Resolve the missing-frame issue and render again.
FileNotFoundError, PermissionError, or an image-opening error
- Explanation: The node needs access to the rendered PNG files and the finished video file. Missing files, inaccessible folders, or damaged PNG images can cause failures when it reads the preview or opens the movie.
- Solution: Verify that the output files still exist and that ComfyUI can read their folders. Avoid moving or cleaning render outputs during execution. If an image file is incomplete or damaged, regenerate the render.
MemoryError or an out-of-memory error during preview creation
- Explanation: Preview frames are loaded as full-resolution floating-point images and then stacked into one batch. The approximately 256 MiB selection safeguard does not account for every temporary allocation or memory already used elsewhere in your workflow.
- Solution: Reduce
preview_framesto1or a small value and free memory used by other workflow stages. If even one frame is too large, reduce the saved timeline's resolution before rendering, noting that this also changes the finished video's resolution.
