> ## 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.

# Pega tu guion

> El formato exacto de un diálogo que Rewatch interpreta palabra por palabra, y las trampas que hacen que se ignore.

Cuando tus réplicas ya están escritas, elige «Pega tu guion» en la herramienta «Historia» (o «Vídeo largo»). La app reconoce el diálogo, lo interpreta **palabra por palabra** y convierte a cada personaje que habla en un miembro del reparto. No añade papeles ni reescribe tus líneas.

> [!NOTE]
>
> El mismo formato funciona en «Describe tu idea»: en cuanto la app encuentra al menos cuatro réplicas, las conserva tal cual. El modo «Pega tu guion» sirve sobre todo para decirlo con claridad.

## El formato de una línea

Una réplica por línea: el nombre, una indicación de interpretación opcional entre corchetes, dos puntos y la réplica.

```text theme={null}
Lucía [preocupada]: Se ha vuelto a mover.
Sami [con desgana]: Es el suelo.
```

| Elemento | Regla |
| - | - |
| **Nombre** | Cuatro palabras como máximo. «José Luis» funciona. Un nombre en mayúsculas (`KEVIN`) se convierte en `Kevin` en la historia. |
| **\[Interpretación]** | Opcional. Emoción, ritmo, gesto: se transmite tal cual a la voz y a la puesta en escena. |
| **Separador** | Dos puntos (recomendado). Una raya larga o una raya seguida de un espacio también funcionan. |
| **Réplica** | El texto exacto que se dirá. |

El corchete es el lugar para todo lo que una simple lista de ritmos no sabe decir: `[susurra, al borde de las lágrimas]`, `[muy deprisa, sin respirar]`, `[masticando]`.

## Los planos sin palabras

Dos formas de escribir un momento mudo:

```text theme={null}
Kevin [sin réplica, traga saliva]
[SILENCIO dos segundos, plano fijo sobre la puerta]
```

* `Nombre [acción]` sin dos puntos: un plano sobre ese personaje, que no dice nada.
* `[SILENCIO …]` solo en su línea: un plano mudo que no se atribuye a nadie. Describe lo que se ve.

## La voz en off

Una línea atribuida a **Narrator**, **VO**, **Voice over** (o «Voice-over») se dice fuera de campo. No es un personaje: nunca se dibuja.

```text theme={null}
Narrator: No había ninguna boda.
```

> [!WARNING]
>
> En español, «Narrador» y «Narradora» **no** se reconocen como narración: se tomarían por un personaje y se dibujaría. Escribe siempre `Narrator` o `VO`, aunque el resto de tu guion esté en español.

## Un ejemplo completo

```text theme={null}
Plano fijo sobre la caja, luz de neón que chisporrotea.

Kevin [educado, algo tenso]: Buenos días, quería retirar seis mil euros.
Cajera [sin levantar la vista]: ¿En efectivo?
Kevin: En efectivo.
[SILENCIO dos segundos, ella por fin lo mira]
Cajera [lenta]: ¿Tiene algún justificante?
Kevin [sonrisa forzada]: Es para una boda.
Cajera: ¿La suya?
Kevin [sin réplica, traga saliva]
Narrator: No había ninguna boda.
```

La app lee aquí dos personajes (Kevin y la cajera), siete réplicas dichas, dos planos mudos y unos 12 segundos de vídeo. La primera línea, en prosa, no se interpreta: se transmite al desglose en planos como indicación de puesta en escena.

## Las dos reglas que delimitan tu diálogo

La app tiene que separar tu diálogo de todo lo que lo rodea (títulos, notas, indicaciones). Se apoya en dos reglas, y conocerlas evita sorpresas.

**1. Un personaje de verdad habla al menos dos veces**

Una línea como `HISTORIA: Kevin quiere retirar dinero` tiene forma de réplica. Lo que la delata es que «HISTORIA» aparece una sola vez. Los nombres que se repiten son los personajes.

**2. El diálogo es un bloque**

El bloque va de la primera a la última réplica de un personaje que se repite. Dentro, todo se conserva, incluso un personaje que habla una sola vez. **Fuera, no se interpreta nada.**

> [!WARNING]
>
> Una réplica aislada al principio del todo o al final del todo, dicha por alguien que habla una sola vez, queda fuera del bloque y no se interpreta. Un `[SILENCIO …]` después de la última réplica tampoco. Aquí, «Director» y «Policía» se saltan:
>
> ```text theme={null}
> Director: ¡El siguiente!
> Kevin: Buenos días.
> Cajera: Buenos días.
> Kevin: Quisiera retirar dinero.
> Cajera: ¿Cuánto?
> Kevin: Todo.
> Policía: Señor, acompáñenos.
> ```
>
> Para conservarlos, haz que hablen una segunda vez, o haz que el diálogo empiece y acabe con un personaje que se repite. La voz en off, en cambio, siempre cuenta: una narración en la primera o en la última línea se conserva.

Otras reglas útiles:

* **Cuatro réplicas como mínimo.** Por debajo, el texto se lee como una idea y la IA escribe sus propias réplicas.
* **Los campos de storyboard no son personajes.** `Dialogue:`, `Shot:`, `SFX:`, `Prompt:`, `Camera:`, `Scene:` y sus semejantes (por ejemplo Image, Video, Action, Note, Style, Transition, Description, Hook, Props, Costume) se reconocen como encabezados, nunca como gente que habla. Solo valen estos nombres en inglés: sus traducciones al español no se reconocen.
* **Los títulos markdown se ignoran.** Una línea que empieza por `#` nunca es una réplica.
* **La negrita se quita de los nombres.** `**Pablo**: …` da el personaje Pablo.

## La duración sale del guion

Un guion ni se estira ni se comprime: él marca la duración, no el ajuste. La app la estima así:

```text theme={null}
duración ≈ número de palabras dichas ÷ 3,5  +  2,5 s por plano mudo
```

Para un vídeo de 30 segundos sin planos mudos, apunta a unas 100 palabras de réplicas. El resumen del asistente muestra «Duración del guion» una vez pegado el texto.

> [!TIP]
>
> Para un gancho fuerte, la primera réplica debe cargar con lo que está en juego. Nada de «Hola» ni de presentaciones: se entra en la escena en el momento en que todo se tuerce. Consulta [Las reglas de un buen prompt](https://docs.rewatch.studio/es/rules.md).

## Lo que puedes escribir alrededor del diálogo

Lo que se escribe **antes de la primera réplica o después de la última** se transmite al desglose en planos como nota: el lugar, el ambiente, el encuadre, el ritmo. Escríbelo en frases sencillas.

```text theme={null}
Plano y contraplano cada vez más cerrado. Noche, cocina iluminada por la nevera abierta.
```

> [!WARNING]
>
> Una línea de prosa colada **entre dos réplicas** ni se interpreta ni se transmite. Para una indicación que afecta a un momento concreto, ponla en el corchete de la réplica (`Malik [se levanta, de espaldas a la ventana]: …`) o conviértela en un plano mudo (`[SILENCIO, la luz del pasillo se apaga]`).

Para mostrar texto en pantalla, usa un **marcador** en su propia línea (`[CARD]`, `[COUNTER]`, `[BANNER]`…), para los cartones, contadores y etiquetas animados. Consulta [Los textos en pantalla](https://docs.rewatch.studio/es/video/overlays.md). No escribas «texto en pantalla:» dentro del corchete de una réplica: en español esa fórmula no se reconoce.

## Los errores frecuentes

> [accordion] Poner la descripción del personaje en la réplica
>
> `Lucía (rubia, 30 años, abrigo rojo): …` mezcla aspecto e interpretación. El aspecto va en «Personajes» de las [referencias](https://docs.rewatch.studio/es/video/references.md), la interpretación en los corchetes.

> [accordion] Cambiar la ortografía de un nombre sobre la marcha
>
> `José` y luego `Jose` dan dos personajes distintos: se ignoran las mayúsculas, no los acentos. Mantén exactamente el mismo nombre.

> [accordion] Réplicas demasiado largas
>
> Apunta a 8 palabras por frase como máximo. Una tirada larga se convierte en un plano congelado donde nada se mueve.

> [accordion] Pegar un storyboard escena por escena
>
> Las réplicas escritas `Nombre: réplica` se reconocen incluso en medio de un storyboard. Pero una réplica guardada dentro de un campo (`Dialogue: Lola: ¿Has oído eso?`) no, y las líneas «Image:», «SFX:» colocadas entre dos réplicas se pierden. Mantén una réplica por línea y pasa las indicaciones de plano a los corchetes.


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