> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rewatch.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Cole seu roteiro

> O formato exato de um diálogo que o Rewatch interpreta palavra por palavra, e as armadilhas que fazem o app ignorá-lo.

Quando as suas falas já estão escritas, escolha “Cole seu roteiro” na ferramenta “História” (ou “Vídeo longo”). O app reconhece o diálogo, interpreta **palavra por palavra** e transforma cada personagem que fala em um membro do elenco. Ele não acrescenta papéis e não reescreve as suas linhas.

> [!NOTE]
>
> O mesmo formato funciona em “Descreva sua ideia”: assim que o app encontra ali pelo menos quatro falas, ele as mantém como estão. O modo “Cole seu roteiro” serve sobretudo para dizer isso com clareza.

## O formato de uma linha

Uma fala por linha: o nome, uma indicação de atuação facultativa entre colchetes, dois-pontos, a fala.

```text theme={null}
Bia [preocupada]: Ela se mexeu de novo.
Caio [de saco cheio]: É o assoalho.
```

| Elemento | Regra |
| - | - |
| **Nome** | No máximo quatro palavras. “Maria Clara” funciona. Um nome em maiúsculas (`KEVIN`) vira `Kevin` na história. |
| **\[Atuação]** | Facultativa. Emoção, ritmo, gesto: repassada como está para a voz e para a encenação. |
| **Separador** | Dois-pontos (recomendado). Um travessão também funciona. |
| **Fala** | O texto exato que será dito. |

O colchete é o lugar para tudo o que uma simples lista de ritmos não sabe dizer: `[sussurra, quase chorando]`, `[muito rápido, sem respirar]`, `[mastigando]`.

## Os planos sem fala

Duas formas de escrever um momento mudo:

```text theme={null}
Kevin [sem fala, engole em seco]
[SILÊNCIO dois segundos, plano fixo na porta]
```

* `Nome [ação]` sem dois-pontos: um plano nesse personagem, que não diz nada.
* `[SILÊNCIO …]` sozinho na linha: um plano mudo que não é atribuído a ninguém. Descreva o que se vê.

## A narração

Uma linha atribuída a **Narrator**, **VO** ou **Voice over** é dita fora de quadro. Não é um personagem: nunca é desenhado.

```text theme={null}
Narrator: Não existia casamento nenhum.
```

> [!WARNING]
>
> Escreva `Narrator` ou `VO`, em inglês. Palavras como “Narrador” ou “Narradora” **não** são reconhecidas como narração: o app as tomaria por um personagem e desenharia alguém.

## Um exemplo completo

```text theme={null}
Plano fixo no caixa, luz de néon piscando.

Kevin [educado, meio tenso]: Bom dia, eu gostaria de sacar seis mil reais.
Atendente [sem levantar os olhos]: Em dinheiro?
Kevin: Em dinheiro.
[SILÊNCIO dois segundos, ela finalmente olha para ele]
Atendente [lenta]: O senhor tem algum comprovante?
Kevin [sorriso forçado]: É para um casamento.
Atendente: O seu?
Kevin [sem fala, engole em seco]
Narrator: Não existia casamento nenhum.
```

O app lê aqui dois personagens (Kevin e a atendente), sete falas ditas, dois planos mudos e cerca de 12 segundos de vídeo. A primeira linha, em prosa, não é interpretada: ela é repassada à divisão em planos como instrução de encenação.

## As duas regras que delimitam o seu diálogo

O app precisa separar o seu diálogo de tudo o que o cerca (títulos, notas, instruções). Ele se apoia em duas regras, e conhecê-las evita surpresas.

**1. Um personagem de verdade fala pelo menos duas vezes**

Uma linha como `HISTÓRIA: Kevin quer sacar dinheiro` tem a forma de uma fala. O que a denuncia é que “HISTÓRIA” aparece só uma vez. Os nomes que voltam são os personagens.

**2. O diálogo é um bloco**

O bloco vai da primeira até a última fala de um personagem que volta. Lá dentro, tudo é mantido, até um personagem que fala uma única vez. **Fora dele, nada é interpretado.**

> [!WARNING]
>
> Uma fala isolada bem no começo ou bem no fim, dita por alguém que só fala uma vez, cai fora do bloco e não é interpretada. Um `[SILÊNCIO …]` depois da última fala também não. Aqui, “Diretor” e “Policial” são descartados:
>
> ```text theme={null}
> Diretor: Próximo!
> Kevin: Bom dia.
> Atendente: Bom dia.
> Kevin: Eu queria sacar um dinheiro.
> Atendente: Quanto?
> Kevin: Tudo.
> Policial: Senhor, venha conosco.
> ```
>
> Para mantê-los, faça com que falem uma segunda vez, ou faça o diálogo começar e terminar por um personagem que volta. A narração, essa, sempre conta: uma narração na primeira ou na última linha é mantida.

Outras regras úteis:

* **Quatro falas no mínimo.** Abaixo disso, o texto é lido como uma ideia, e a IA escreve as suas próprias falas.
* **Os campos de storyboard não são personagens.** `Dialogue:`, `SFX:`, `Prompt:`, `Camera:`, `Scene:`, `Shot:` e semelhantes (escritos em inglês) são reconhecidos como cabeçalhos, nunca como pessoas que falam.
* **Os títulos markdown são ignorados.** Uma linha que começa com `#` nunca é uma fala.
* **O negrito é removido dos nomes.** `**Paulo**: …` dá o personagem Paulo.

## A duração vem do roteiro

Um roteiro não é esticado nem comprimido: é ele que determina a duração, não o ajuste. O app a estima assim:

```text theme={null}
duração ≈ número de palavras ditas ÷ 3,5  +  2,5 s por plano mudo
```

Para um vídeo de 30 segundos sem plano mudo, mire em cerca de 100 palavras de falas. O resumo do assistente mostra “Duração do roteiro” assim que o texto é colado.

> [!TIP]
>
> Para um gancho forte, a primeira fala deve carregar o conflito. Nada de “Oi” nem de apresentação: entre na cena no momento em que tudo vira. Veja [As regras de um bom prompt](https://docs.rewatch.studio/pt/rules.md).

## O que você pode escrever em volta do diálogo

O que está escrito **antes da primeira fala ou depois da última** é repassado à divisão em planos como nota: o lugar, o clima, o enquadramento, o ritmo. Escreva em frases simples.

```text theme={null}
Plano e contraplano cada vez mais fechados. Noite, cozinha iluminada pela geladeira aberta.
```

> [!WARNING]
>
> Uma linha de prosa colocada **entre duas falas** não é interpretada nem repassada. Para uma instrução sobre um momento preciso, coloque-a no colchete da fala (`Marcos [levanta, de costas para a janela]: …`) ou faça dela um plano mudo (`[SILÊNCIO, a luz do corredor se apaga]`).

Para exibir texto na tela, use um **marcador** em uma linha própria (`[CARD]`, `[COUNTER]`, `[BANNER]`…), para cartelas, contadores e etiquetas animadas. Veja [Os elementos na tela](https://docs.rewatch.studio/pt/video/overlays.md). A sintaxe “texto na tela:” dentro do colchete só é reconhecida em francês: em português, use sempre um marcador.

## Os erros mais comuns

> [accordion] Colocar a descrição do personagem na fala
>
> `Bia (loira, 30 anos, casaco vermelho): …` mistura aparência e atuação. A aparência vai em “Personagens” das [referências](https://docs.rewatch.studio/pt/video/references.md), a atuação vai nos colchetes.

> [accordion] Mudar a grafia de um nome no meio do caminho
>
> `José` e depois `Jose` dão dois personagens diferentes: as maiúsculas e minúsculas são ignoradas, os acentos não. Mantenha exatamente o mesmo nome.

> [accordion] Falas longas demais
>
> Mire em 8 palavras por frase, no máximo. Uma tirada longa vira um plano congelado em que nada se mexe.

> [accordion] Colar um storyboard cena por cena
>
> As falas escritas `Nome: fala` são reconhecidas mesmo no meio de um storyboard. Mas uma fala guardada dentro de um campo (`Dialogue: José: Você ouviu?`) não é, e as linhas “Image:”, “SFX:” colocadas entre duas falas são perdidas. Mantenha uma fala por linha e passe as indicações de plano para os colchetes.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.