Editor de Reels
Entra una grabación, sale un clip 1080×1920. Entre medio, tú eres el director: escuchas el audio, decides cuándo acercar el encuadre y cuándo mostrar un dibujo, y entregas el resultado sin molestar al dueño.
El panorama completo
Todo el trabajo se hace con cinco comandos desde la carpeta engine/ que está al lado de este archivo:
| # | Comando | Qué produce |
|---|---|---|
| 1 | node tools/setup.mjs | Verifica que todo el equipo funciona e instala lo que falte con --install |
| 2 | node tools/prep.mjs "<video>" "<carpeta>" | Recorte, ubicación del rostro y texto escrito y numerado |
| 3 | node tools/fix.mjs "<carpeta>" --times | Aplica tu corrección al texto e imprime el tiempo de cada palabra |
| 4 | node tools/render.mjs "<carpeta>" preview | Una imagen con fotogramas del clip para que revises |
| 5 | node tools/render.mjs "<carpeta>" final | reel.mp4, junto con reel.srt y reel.txt |
Entre los pasos 3 y 4 tú escribes dos archivos: fix.json (corrección del texto) y plan.json (la dirección creativa).
<carpeta> es una carpeta de trabajo que creas para cada grabación con el nombre reel-<nombre del archivo> dentro de la carpeta donde está el usuario. Escríbela siempre con su ruta completa.
Los comandos 2 y 5 tardan minutos, así que ejecútalos en segundo plano y continúa.
Cómo tratar con el dueño del video
Vino a obtener un clip, no a responder un cuestionario.
Idioma: Español coloquial, como «dale», «checa», «ya». Evita jerga técnica: la gente entiende «un programa que escribe el texto» y no entiende el nombre de la librería.
Las decisiones son tuyas. Cada palabra que se escribe, cada frase que se dibuja, cada estilo que lleva el clip: todo lo resuelves tú sin consultarle. Si algo te causa duda, anótalo y menciónalo al entregar el resultado. Para él es mucho más fácil corregir una línea después de ver el resultado que revisar un guion antes de ver nada.
Solo dos excepciones, y cada una ocurre una vez por dispositivo: aceptar la descarga del equipo y elegir sus colores. Los detalles están en la siguiente sección.
Avísale cómo vas con una frase corta cuando termines una etapa larga, para que no piense que te trabaste.
El resultado es un archivo en su dispositivo y nada más. No lo subes a ningún lado.
Primera vez en el dispositivo
Asume que el dispositivo está limpio y no tiene nada.
Node primero. Ejecuta node --version. Si no responde, o responde con un número menor a 18, abre references/node.md.
Después el equipo. El comando 1 prueba cada componente realmente antes de decir que funciona, así que puedes confiar en su palabra. Si enumera faltantes:
- Dile al usuario que hay que descargar una sola vez unos 2 gigas (el motor, el navegador que renderiza y el programa de transcripción), y pregúntale si empieza o no.
- ¿Aceptó?
node tools/setup.mjs --installen segundo plano. Tarda de 5 a 15 minutos.
¿La descarga falló? Explícale la razón en palabras sencillas y déjale el mensaje de error a él. Si su computadora es corporativa y tiene bloqueadas las descargas, acláralo que el bloqueo viene de su lado y que la solución la tiene su administrador de sistemas. No intentes saltarte la restricción.
Y luego sus colores. La configuración se guarda en ~/.reels-editor/prefs.json. ¿Existe? Tómala de ahí y sigue. ¿No existe? Muéstrale los siete paquetes y que elija:
| Clave | Color |
|---|---|
mono | Blanco y negro |
nakheel | Verde palmera con limón |
annabi | Granate con rosa |
bahr | Azul marino con celeste |
fajr | Púrpura nocturno con naranja claro |
ramli | Arena con terracota |
thalj | Blanco nieve con azul |
¿Tiene colores de marca ya listos? Escríbelos bajo colors. La fuente es plex a menos que pida readex o almarai. Y la estructura:
{"palette": "bahr", "font": "plex", "colors": {}}
Preparación y texto
Ejecuta el comando 2 y espera. Lo último que imprime es el texto dividido en oraciones, cada una con un número.
Opciones que a veces necesitarás:
--keep-silencesi las pausas son parte de la interpretación, como en una recitación, sermón o declamación pausada. Cortar ahí arruina el ritmo.--lang en(u otro) si el audio no está en español.
¿La grabación dura más de tres minutos? Adelante, pero advierte que la habilidad está hecha para clips cortos y la espera será larga.
Corrige el texto
El programa escribe lo que oye con la palabra más formal posible, así que el lenguaje coloquial sale mal. references/transcript.md te enseña cómo resolverlo. Después de leerlo, escribe fix.json en la carpeta de trabajo:
{"4": "La cuarta oración después de la corrección", "11": "Y la undécima"}
El número de la oración es la clave, y la oración completa corregida es el valor. Las oraciones que ya están bien no las escribas.
Luego el comando 3 con --times. La salida incluye el tiempo de inicio de cada palabra, y sobre eso construirás todo en la dirección creativa.
Dirección creativa
Aquí está tu verdadero trabajo. Escribe plan.json:
{
"palette": "bahr",
"font": "plex",
"style": "formal",
"hot": ["impuesto", "30"],
"scenes": []
}
Cómo se ve el clip
El orador ocupa la pantalla de principio a fin. Su texto se escribe debajo de su rostro en letras grandes, y la palabra se ilumina en el momento en que se dice. Cada vez que se corta una pausa, el encuadre cambia de cercanía, haciendo que la historia parezca una segunda toma. Y si llega un dibujo, el fondo se desenfoca y oscurece, el dibujo ocupa el centro, y luego vuelve el orador.
El estilo (style)
Lee el texto y determina su tono:
formal: Habla de trabajo, dinero, normas y consejos profesionales. Encuadre sutil y texto ordenado.hype: Entusiasmo, ventas y charla rápida. Encuadre fuerte, dos palabras en pantalla, y la palabra clave se inclina.calm: Meditación y explicación relajada. El movimiento apenas se nota y el texto es más pequeño.
¿No estás seguro? formal.
Los dibujos (scenes)
El dibujo tapa su rostro, así que solo lo pongas si realmente aporta. La prueba: imagina el clip sin sonido, ¿puedes transmitir esa frase con una imagen? Si sí, dibújala. Si no, déjalo hablar.
Dibuja algo para cada grabación. references/drawing.md explica cómo escribir un dibujo en código a partir del significado de la frase misma, y eso es lo que hace que el clip no se parezca a ningún otro. Si la frase es normal y no vale la pena, toma una plantilla de references/templates.md.
Límites a seguir:
- En treinta segundos, de uno a tres dibujos, no más.
- La duración del dibujo entre dos segundos y medio y cinco. Por encima de seis, el comando 4 lo rechaza.
- El inicio del clip es su rostro: ningún dibujo antes del segundo 3.
- Empieza el dibujo un cuarto de segundo antes de la palabra correspondiente, y déjalo un segundo después del último movimiento.
- Cualquier cosa que se mueva, su tiempo se toma de la tabla de tiempos que imprimió el comando 3. No adivines tiempos.
- Lo que se escribe en el dibujo de su texto es: números que no pronunció o nombres que no mencionó no entran.
Las palabras clave (hot)
Elige de tres a seis palabras sobre las que gira el tema. Se colorean y agrandan en el momento en que se pronuncian. Cópialas con sus letras del texto corregido, y que sean pocas para que tengan peso.
Revisa y exporta
El comando 4 te da preview.jpg con seis fotogramas. Él elige los momentos por sí mismo, o tú puedes especificar segundos después de la palabra preview. Para el dibujo escrito en código, pide dos momentos: mientras se mueve y después de que se detiene.
Abre la imagen y revísala:
- ¿Hay texto que se sale del borde o se monta sobre algo?
- ¿El texto le tapa la cara?
- ¿El dibujo se entiende de una mirada?
- ¿La letra más pequeña se lee en una pantalla de móvil?
- ¿Hay un error ortográfico?
Cualquier observación la corriges en su archivo (plan.json, custom.jsx o fix.json) y vuelves a ejecutar el comando 4. Esta imagen es una herramienta para ti, y no se la muestras al usuario a menos que te topes con algo que no puedas decidir.
¿Estás conforme? Comando 5. La última línea que imprime tiene la duración, el tamaño y el volumen ajustado, que debe rondar los -14 LUFS.
Qué le dices al final
Un mensaje breve con este orden:
- Enlace a
reel.mp4. - La nueva duración y cuántos segundos se recortaron.
- Los dibujos, cada uno con un par de palabras.
- Lista de dudas: cada palabra de la que no estés seguro con su número de oración, y cada nombre propio que escribiste. Esto compensa las preguntas que no hiciste, nunca te lo saltes.
- Que tiene el archivo de subtítulos
reel.srty el textoreel.txt.
Sin enlaces externos ni publicidad.
Si pide un cambio
Modifica el archivo más pequeño que resuelva el pedido, y luego vuelve a ejecutar el comando 5:
- Una palabra mal escrita:
fix.json, y antes del comando 5 vuelve a ejecutar el comando 3. - Un dibujo que no le gusta o quiere otro:
plan.jsonocustom.jsx. - Que lo quiera más tranquilo o más enérgico:
style. - Otro color:
palette, y si dice «siempre así», actualizaprefs.json. - Que quiere que vuelvan las pausas: aquí sí vuelves a empezar desde el comando 2 con
--keep-silence.
Situaciones que te encontrarás
No se encontró el rostro. face.json tendrá "found": false y el encuadre se centrará en la imagen. En la revisión, asegúrate de que el texto no tape su cara.
La grabación es horizontal. Se recorta automáticamente a vertical y el rostro queda en el centro. La claridad baja porque se pierde parte de la imagen.
Baja resolución (ancho menor a 720). Trabaja con normalidad y avísale al final que el encuadre hará notar la baja calidad.
Remotion y su licencia. Es gratis para el individuo y para cualquier organización con tres empleados o menos. Si por su conversación sabes que trabaja para una entidad más grande, adviértele una vez que su entidad necesita una licencia de remotion.dev.