---
title: "Script To Subtitles"
description: "Local-first visual environment for building and running AI workflows. Build agents visually, deploy anywhere, privacy by design."
canonical: https://docs.nodetool.ai/nodes/nodetool/script/scripttosubtitles
markdown: https://docs.nodetool.ai/nodes/nodetool/script/scripttosubtitles.md
product: NodeTool
source: https://github.com/nodetool-ai/nodetool/blob/main/docs/nodes/nodetool/script/scripttosubtitles.md
---

# Script To Subtitles

**Type:** `nodetool.script.ScriptToSubtitles`

**Namespace:** `nodetool.script`

## Description

Export a voiced script as SRT or WebVTT subtitles, straight from each current take's word timings — one cue per line (or per word), laid out end to end with the authored pauses. Voice the script first; unvoiced lines are skipped.
    script, subtitles, srt, vtt, captions, export

    Use cases:
    - Produce a subtitle sidecar for a voiced narration
    - Generate word-timed captions from take timings
    - Feed subtitles into a burn-in or upload step

## Properties

| Property | Type | Description | Default |
|----------|------|-------------|---------|
| script | `script` | The voiced script to export subtitles from. | - |
| format | `enum` | Subtitle format: SubRip (.srt) or WebVTT (.vtt). | `srt` |
| granularity | `enum` | One cue per line (whole line text) or per word (using take word timings). | `line` |

## Outputs

| Output | Type | Description |
|--------|------|-------------|
| subtitles | `str` |  |
| cue_count | `int` |  |

## Related Nodes

Browse other nodes in the [nodetool.script](./) namespace.