Sincronización de subtítulos
El clip del talento se coloca en la ranura inferior derecha; su voz impulsa los subtítulos y los cortes de escena. Nada cambia en el episodio hasta que el usuario aprueba la revisión.
Todos los comandos se ejecutan desde la raíz del espacio de trabajo.
1. ¿Whisper listo?
npm run reelkit -- whisper check --model=<modelo> # el modelo que usarás; por defecto large-v3-turbo
Si el modelo no está descargado, sync prepare lo descarga (1.6 GB para large-v3-turbo) — informa al usuario primero, u ofrece --model=small (586 MB, menos preciso). Si WebGPU no está disponible, sync aún adjunta el clip pero los subtítulos se mantienen temporizados desde el guion ("provisional").
2. Preparar (solo escribe propuestas)
npm run reelkit -- sync prepare episodes/<carpeta> <ruta/al/clip> [--model=large-v3-turbo]
Copia el clip como talent.proposed.<ext>, lo transcribe, alinea las palabras con el guion y escribe:
sync-report.md— la revisión (español): detalles del clip, silencio recortado al inicio, cortes de escena antes → después, cada palabra que difiere (corregida a la ortografía del guion,⚠ Revisarsustituciones lejanas que muestran lo que se escuchó,⚠ No se escuchópalabras omitidas, ad-libs mantenidos tal como se escucharon), advertencias, y si la voz se extiende más allá del final.captions.proposed.json— los subtítulos que usará el vídeo (editables: cambia el"text"de una palabra para corregirla).sync-proposal.json— recorte, inicios de escena, archivos.
Cómo decide la alineación: la ortografía del guion con la temporización de Whisper para palabras que coinciden o casi coinciden (los números coinciden con su forma hablada: "12" ↔ "doce"); una sustitución lejana muestra lo que se escuchó y se marca; las palabras que Whisper no escuchó se omiten de los subtítulos; las palabras adicionales que dijo el talento se mantienen.
3. Revisar con el usuario
Lee sync-report.md y muestra al usuario una tabla breve: cortes de escena (antes → después), cada palabra marcada (escena, guion, escuchado, estado, tiempo), y la línea de desbordamiento si la hay. Pídele que apruebe, o que indique qué palabras cambiar (edita captions.proposed.json, luego muestra el cambio).
- La voz se extiende más allá del final (
⚠ La voz sigue … s): las últimas palabras se cortarían. Recomienda regrabar más corto. Solo con el acuerdo explícito del usuario, aplica con--accept-overrun. - Una escena completa no se escuchó: los visuales pueden no coincidir con lo dicho — pregunta si regrabar o continuar.
- Baja coincidencia ("¿Es el clip correcto?"): confirma que es el clip y episodio correctos.
4. Aplicar (después de la aprobación)
npm run reelkit -- sync apply episodes/<carpeta> [--accept-overrun]
Renombra el clip preparado a talent.<ext>, escribe captions.json, guarda clip, sceneStarts, captionsSrc y stage: "synced" en episode.json, y elimina el clip anterior que reemplazó.
5. Verificar
npm run check -- episodes/<carpeta>
npx remotion still Episode out/<carpeta>-sync.png --public-dir episodes/<carpeta> --frame=<N>
Visualiza un fotograma en medio de una frase: el clip llena la ranura y el subtítulo muestra la palabra que se está diciendo. Ofrece Studio: npm run studio -- episodes/<carpeta>. Siguiente: /reelkit:export.