Save 4 hours! We auto-setup your workflow! Free!

Drop your workflow.json — we handle every dependency, custom node, and model. Just open the link and run.

Auto-Setup Workflow Json (Free) Now!
ComfyUI > Nodes > OpenKatana > OpenKatana · Preview timeline

ComfyUI Node: OpenKatana · Preview timeline

Class Name

OpenKatana_preview_timeline

Category
OpenKatana/Tools
Author
rk0neki (Account age: 235days)
Extension
OpenKatana
Latest Updated
2026-11-05
Github Stars
0.05K

How to Install OpenKatana

Install this extension via the ComfyUI Manager by searching for OpenKatana
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter OpenKatana in the search bar
After installation, click the Restart button to restart ComfyUI. Then, manually refresh your browser to clear the cache and access the updated list of nodes.

Visit ComfyUI Online for ready-to-use ComfyUI environment

  • Free trial available
  • 16GB VRAM to 80GB VRAM GPU machines
  • 400+ preloaded models/nodes
  • Freedom to upload custom models/nodes
  • 200+ ready-to-run workflows
  • 100% private workspace with up to 200GB storage
  • Dedicated Support

Run ComfyUI Online

OpenKatana · Preview timeline Description

Preview composed frames from saved OpenKatana timelines without rendering the full video.

OpenKatana · Preview timeline:

OpenKatana_preview_timeline lets you visually inspect selected moments of a saved OpenKatana edit without rendering the entire video. It renders actual timeline frames through OpenKatana’s browser-based rendering engine, including text, masks, camera adjustments, and effects, so you can check the composed image rather than just the original source footage. This makes it useful for reviewing titles, checking effect timing, and comparing important moments before committing to a full render. Each preview request is limited to a small set of frames, keeping the review focused. The operation also checks the timeline for warnings and flags unexpectedly flat-colour images that may indicate a problem with an effect. These previews are silent still images, so you need a full render to review audio and continuous motion.

OpenKatana · Preview timeline Input Parameters:

project_id

A required STRING identifying the OpenKatana project whose saved timeline you want to preview. The operation retrieves that project’s current saved timeline, so the project must exist and already contain a saved edit; an unsaved timeline is not sufficient. Use the same project identifier throughout your editing and preview workflow to ensure you inspect the intended project. The provided node class does not expose a default value, permitted options, or minimum and maximum string lengths for this parameter.

arguments

A required STRING containing the tool arguments as JSON. For this operation, provide the frame numbers to inspect using the frames property, for example {"frames":[0,24,48]}. Frame numbers are positions on the saved timeline, not timestamps in seconds, and use zero-based indexing: frame 0 is the first frame. Each request must contain between 1 and 12 frame entries, and every entry must be an integer from 0 through the timeline’s total frame count minus 1. At 24 frames per second, for example, frame 24 corresponds to one second into the timeline. These selections determine which moments are rendered and saved as preview images. The provided node class does not show a default JSON value or a string-length limit; the frame-count and frame-index restrictions come from the preview implementation.

after

An optional STRING connection that can be used to sequence this node after an upstream operation, such as saving an edit. In the supplied execution method, its value is accepted but is not read or forwarded as a preview argument, so it does not select frames or change the rendered appearance. Its practical role is to provide a workflow dependency when connected to an earlier node’s string output. The execution method defaults this parameter to None when omitted; no allowed text options or minimum and maximum lengths are shown.

OpenKatana · Preview timeline Output Parameters:

result_json

A STRING containing the tool response in JSON form rather than a ComfyUI image output. The preview operation’s result includes frames, which identifies the requested timeline positions; preview_images, which contains absolute file paths to the generated PNG images in request order; audio, which explains that the previews are silent; and warnings, which contains timeline warnings and any detected unexpected flat-colour frames. Each image is named using its frame number padded to at least five digits, such as 00024.png for frame 24. Use the image paths to locate and inspect the rendered stills, and review the warnings for issues that may need attention before the final render. A flat-frame warning includes the affected frame number and its detected RGB colour; it is a diagnostic finding, not necessarily a failed preview. The supplied node wrapper converts the tool response into this string, but its exact outer response structure is not shown.

OpenKatana · Preview timeline Usage Tips:

  • Save your timeline before previewing it. This operation reads the project’s saved edit, so save again after making changes if you want those changes to appear.

  • Start with a small selection of important frames, such as {"frames":[0,48,96]}, provided those positions exist in your timeline. Add further requests when you need broader coverage; each request supports at most 12 frames.

  • Convert seconds to frame numbers using your timeline’s frame rate. For a 24 fps timeline, two seconds corresponds to frame 48. Keep every requested frame within 0 through the total frame count minus 1.

  • To inspect a transition or effect boundary, request nearby frames together, such as {"frames":[47,48,49]}. This helps you compare the image immediately before, at, and after the change, although it does not replace motion playback.

  • Connect an upstream save operation’s string output to after when you need an explicit execution dependency. Keep the frame-selection JSON in arguments; the text passed through after is not used as preview settings.

  • Inspect preview_images and warnings together. A successfully created PNG can still reveal an unwanted blank-looking image or an effect setting that needs adjustment.

  • Use a full video render to judge music, sound synchronization, and continuous motion. The preview explicitly produces silent still frames, not an audio-enabled video.

OpenKatana · Preview timeline Common Errors and Solutions:

Save a timeline first

  • Explanation: The selected project does not currently have a saved timeline. Importing media or preparing an edit without saving it does not provide the timeline this operation needs.
  • Solution: Create and save an edit in the project, then run the preview again with the same project_id.

Request 1..12 timeline frames per preview

  • Explanation: The frame list is empty or contains more than 12 entries. The preview implementation limits each request to between 1 and 12 frames.
  • Solution: Provide at least one frame, and split larger selections into separate requests containing no more than 12 entries each.

Invalid frame value: expected an integer within the timeline range

  • Explanation: This is a descriptive error category rather than a quoted message; the exact validation wording is not shown. Each frame must be an integer between 0 and the timeline’s total frame count minus 1. Negative numbers, fractional values, and positions beyond the last frame do not meet the preview contract.
  • Solution: Use whole-number timeline positions. For a timeline containing 120 frames, valid positions are 0 through 119. Convert timestamps into frame numbers using the timeline frame rate before submitting them.

Invalid or incomplete arguments JSON

  • Explanation: This is a descriptive error category; the supplied code does not show the JSON parser’s exact message. The preview API requires a frames list, so malformed JSON or missing frame selections cannot supply the required request.
  • Solution: Use valid JSON with double-quoted property names, such as {"frames":[0,24,48]}, and make sure all selected positions exist in the saved timeline.

unexpected inputs: ...

  • Explanation: The node wrapper explicitly raises this error if it receives extra named fields outside those supported by its input definition. The unsupported field names are appended to the message.
  • Solution: Use only project_id, arguments, and the optional after input. Put the frames list inside the arguments JSON rather than adding a separate node input.

frame N rendered as one flat colour rgb(...) with no flat special scheduled; check the effect values that reach it

  • Explanation: This is a warning returned in the result, not necessarily an execution error. The rendered frame contains one flat colour even though no flat special is scheduled there, which may indicate an unintended effect result.
  • Solution: Open the affected PNG and confirm whether the flat image is intentional. If not, inspect the effects and their values at that frame, revise and save the timeline, then preview that frame and its neighbours again.

Browser launch or preview rendering failure

  • Explanation: This is a descriptive error category; no exact failure message is provided. Timeline previews depend on Playwright and a headless Chromium browser. If the required browser components are unavailable or cannot launch, the preview cannot render its images.
  • Solution: Check the detailed error in the ComfyUI log, verify that the OpenKatana browser-rendering dependencies are installed and configured, and rerun the preview after resolving the reported setup issue.

Timeline validation failure

  • Explanation: This is a descriptive error category; the exact messages depend on the validation problem. The saved timeline is validated before rendering, so an invalid edit or a project-reference problem can stop the preview before any images are produced.
  • Solution: Read the specific validation details in the tool response or ComfyUI log, correct the reported timeline or project issue, save the corrected edit, and try again.

OpenKatana · Preview timeline Related Nodes

Go back to the extension to check out more related nodes.
OpenKatana
RunComfy
Copyright 2025 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.

OpenKatana · Preview timeline