---
title: "Align Shots to Audio"
description: "Re-computes each scene start_time and duration from whisper word_timestamps so shots stay in sync with whatever voiceover is actually playing. Fixes drift when the audio is regenerated at runtime."
updated: 2026-09-10
---

# Align Shots to Audio

**Badge:** Direct  
**Node type:** `utility:align_shots_to_audio`  
**Category:** `process`

## Description

Re-computes each scene start_time and duration from whisper word_timestamps so shots stay in sync with whatever voiceover is actually playing. Fixes drift when the audio is regenerated at runtime.

## Pricing

- **Cost:** this node itself costs no credits

## Canvas ports

These appear as port handles on the left side of the node.

| ID               | Label               | Details                                                                                                                                                   |
| ---------------- | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `scenes`         | **Scenes (JSON)**   | `JSON` — Array of scene definitions with narration text. Can come from an upstream JSON source or from this node's Scenes JSON config field.              |
| `wordTimestamps` | **Word Timestamps** | `JSON` _(required)_ — Array of {word, start, end} timestamps from a Whisper STT node. Required — without this, alignment falls back to a linear estimate. |

## Sidebar config

These render as form fields in the right-side config panel when the node is selected.

| ID                | Label                      | Details                                                                                                                                                                    |
| ----------------- | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `hookDurationSec` | **Hook Duration (sec)**    | `NUMBER` · `0…60` — Fixed offset for any pre-made hook scene with baked audio. Non-hook scenes are offset by this amount so the voiceover plays after the hook video ends. |
| `matchWindow`     | **Fuzzy Match Window**     | `NUMBER` · `1…100` — How far forward (in words) to search for each scene's first narration word. Higher = more forgiving when transcription differs from script.           |
| `scenes_json`     | **Scenes JSON (fallback)** | `TEXT` — Paste scene definitions JSON here if not wired via the scenes port. Parsed as the fallback scenes array.                                                          |

## Outputs

| ID      | Label             | Type   |
| ------- | ----------------- | ------ |
| `shots` | **Aligned Shots** | `JSON` |

---

_Auto-generated from the Wireflow node registry._

---

Documentation index: fetch https://www.wireflow.ai/llms.txt for the full list of Wireflow docs.