Directora visual
Un gran reel de cabeza parlante muestra lo que el orador dice, latido a latido: una lista se convierte en chips que aparecen mientras se dice cada elemento; un número cuenta hacia arriba; "escribí un prompt" se convierte en una ventana de chat escribiéndolo. Las piezas son pequeñas, se colocan alrededor de la cabeza (nunca sobre la cara) y aparecen exactamente cuando se pronuncia la palabra.
Esto se planifica en build.json → "visuals": [...]. El motor se encarga de la colocación, la apariencia del kit, la animación y un sonido por pop-up.
1. Lee el reel como latidos
Revisa las líneas bloqueadas (edl.json) con los índices de palabras:
python3 -c "import json;w=json.load(open('projects/<name>/transcript.json'))['words'];c=json.load(open('projects/<name>/cut.json'));[print(' '.join(f\"{x['i']}:{x['w']}\" for x in w[a:b+1])) for a,b in (l['words'] for l in c['lines'])]"
Marca cada latido que tenga algo mostrable:
- una lista de cosas
- un número
- una herramienta o aplicación
- una acción (escribir, enviar, reservar)
- un antes/después o un esto-vs-aquello
- un proceso o pasos
- un sistema
- una persona o historia
- un lapso de tiempo
- una idea rechazada
- una palabra clave digna de destacar
Los rellenos, transiciones y sentimientos sin un objeto no obtienen nada.
2. Elige la pieza para cada latido
| Ellos dicen… | Pieza | Ejemplo |
|---|---|---|
| una lista ("marketing, facturas, correos") | chips, un elemento por palabra mientras se dice | elementos con word cada uno |
| cosas que se sueltan o cierran ("todas esas pestañas en mi cabeza") | chips con "close": true | |
| una cifra ("100+ clientes", "15:00", "un equipo de 2") | number | "value": "100+", "label": "clientes" |
| la palabra clave o remate de una línea | word ("style": "type" para un pensamiento o pregunta) | "text": "apoyo *real*" |
| algo que rechazan ("no 50 pasos", "no otra aplicación") | strike | "pre": "No", "text": "50 pasos", "strike_word": i |
| escribir un prompt, preguntar a la IA, enviar un DM | chat | "prompt": "...", "reply": "..." (opcional) |
| una venta, un mensaje, una reserva, una notificación | notify | "app": "Stripe", "title": "Nuevo pago: 497 €" |
| pasos realizados, una lista de tareas, logros | checklist | elementos con word cada uno |
| "paso 1 / lo primero / parte dos" | step | "n": 1, "text": "*entrenarlo*" |
| un cambio o proceso (A → B → C) | flow | elementos con icon y text |
| un sistema, herramientas conectadas, "todo en un solo lugar" | hub | center más nodes con iconos |
| un lapso de tiempo o rango ("en un mes… en 3 años") | scale | marks, from, to, move_word |
| un cliente, una persona, una historia sobre alguien | person | "name": "Ana", "note": "coach", "meter": 3 |
| esto vs aquello, forma antigua vs nueva | versus | left (el ✗) / right (el ✓), right_word |
| un meme o GIF, solo cuando el usuario lo solicite | gif | "file": "projects/<name>/memes/3.mp4", "caption": "yo leyendo mis *subtítulos* antiguos" |
| su perfil, una captura de pantalla, una aplicación | phone | "image": "assets/profile.png" (solo imágenes que el usuario proporcionó) |
Texto en las piezas:
- 1–3 palabras por chip, nodo o etiqueta
- usa sus palabras
- mayúscula inicial está bien, pero sin oraciones completas excepto en
chatynotify
Iconos: busca nombres reales con uv run tools/icons.py calendar money email y nunca adivines un nombre. La compilación se detiene ante un icono desconocido.
Piezas distintivas (necesitan material propio del usuario)
- Sus reels orbitando alrededor de ellos:
{"type": "orbit", "word": i, "until_word": j}enevents(no en visuals).- Úsalo en una línea sobre su contenido o trabajo ("He hecho 300 de estos").
- Necesita
brand/reels/. Complétalo conuv run tools/reels.py add <sus archivos de reel o una carpeta>: sus propios reels exportados, o descargados de su perfil con Apify si está conectado. - Sus reels pasan detrás y delante de ellos. Como máximo una vez por reel.
- Seguimiento de perfil de Instagram para una llamada a la acción ("sígueme", "comenta CEREBRO"):
{"kind": "profile", "word": i, "until_word": j, "keyword": "CEREBRO"};keywordes opcional y escribe en una hoja de comentarios.- Los números provienen solo de
brand/instagram.json(name, handle, posts, followers, following, bio, avatar). Si falta, pídeles los números reales (o extráelos de su propio perfil con Apify). Nunca estimes ni inventes. - La cuadrícula usa
brand/reels/. Obtiene un sonido de toque en Seguir (y en Publicar).
- El reel de otro creador como una tarjeta: un
gifcon"handle": "nombrecreador". El @handle se muestra debajo.- Siempre da crédito, y solo usa clips que el usuario señale.
- Inserción personalizada (cuando ninguna pieza encaja, p. ej., una recreación de una aplicación que usan, o un archivo desplazándose): constrúyela con un subagente. Consulta "Inserciones personalizadas" más abajo.
Movimiento
El visuals.motion del kit: gentle / snappy / bouncy / blur (un pop borroso que se enfoca en su lugar) / rise (editorial tranquilo).
"style": "rise"en un pop dewordhace que cada letra se eleve desde su línea, una tras otra. Es excelente para palabras de impacto con serifa. Un kit puede convertirlo en el valor predeterminado convisuals.word_style: "rise".- Los subtítulos pueden aparecer con efecto blur con
captions.pop: "blur".
Inserciones personalizadas (subagentes paralelos)
- Primero bloquea la sincronización: los tiempos de palabra que debe alcanzar, convertidos al reloj propio de la inserción (t = 0 cuando aparece).
- Genera un subagente por inserción, en segundo plano y en paralelo (herramienta Agent), mientras tú continúas construyendo. Instrúyelo con:
- Qué muestra, y la línea sobre la que se reproduce. Usa solo datos reales del usuario; cualquier otra cosa es un marcador de posición genérico. Sin personas reales ni logotipos copiados.
- Dónde trabajar:
projects/<name>/inserts/<insert-name>/index.html. No toques nada más. - Tamaño y duración: por ejemplo 900×700 px y 2.6 s. El fondo permanece transparente fuera de la tarjeta o ventana que dibuje.
- El contrato:
window.renderAt(t)dibuja el estado exacto en t segundos. Sin temporizadores, transiciones CSS ni animaciones, porque los fotogramas se capturan uno por uno.- Solo fuentes locales (copia de
fonts/free/). - Texto de al menos 24 px, usando los colores del kit del usuario.
- Texto escrito: un carácter por paso de t.
- Solo fuentes locales (copia de
- Latidos, con tiempos bloqueados a la voz.
- Renderiza con
uv run tools/insert.py <index.html> --dur <s> --w <w> --h <h>→insert.mov, con canal alfa. Revisa algunos fotogramas antes de informar. - Informa: la ruta, la duración exacta y los tiempos de los latidos (para los sonidos). Marca cualquier cosa que parezca incorrecta.
- Colócala con
{"kind": "insert", "file": "…/insert.mov", "word": i, "width": 640}. Añadesfx_extraclics en sus latidos.
Memes y GIFs (solo cuando se soliciten)
-
Nunca añadas un meme sin que te lo pidan. Los memes son una cuestión de gusto. Puedes sugerir uno en tu informe ("un 'ew' de David Rose encajaría en la línea 5"), y añadirlo solo si dicen que sí.
-
Búsqueda:
uv run tools/memes.py search "<serie> <personaje> <emoción o palabras>" --project projects/<name>. Por ejemplo "schitts creek david ew" o "the office michael no god please no".- Descarga hasta 6 clips e imprime
SHEET=…/memes/sheet.png. Lee la hoja y elige la viñeta que coincida con lo que describieron (el personaje correcto, la expresión correcta), no solo la primera. - Las viñetas están numeradas del 1 al 6, de izquierda a derecha, de arriba abajo.
- Descarga hasta 6 clips e imprime
-
Su propio archivo ("usa este GIF"):
uv run tools/memes.py add "<archivo>" --project projects/<name>damemes/own-1.mp4. Las imágenes también funcionan. -
Colócalo:
{"kind": "gif", "file": "projects/<name>/memes/<n>.mp4", "word": i, "caption": "<su texto>"}- El pie de foto es opcional, en sus palabras, con un
*énfasis*. La duración predeterminada es de aproximadamente 2.6 s, o establece"until_word". - Los clips anchos se colocan sobre la cabeza; los altos, debajo de la barbilla.
"at": "full"hace un corte a pantalla completa de 1.6 s con el pie de foto superpuesto.
-
En el informe: di cuál usaste y abre la hoja (
open …/sheet.png) para que puedan decir "meme 3". Los otros clips ya están descargados, así que intercambiarlos solo requiere cambiarfiley reconstruir. -
Sin clave (
MEMES=no-key): ofrece la configuración gratuita de 3 minutos:- Van a developers.giphy.com, se registran, crean una aplicación API (no SDK) y copian la clave.
- Pegan la clave en el chat.
- La guardas en
brand/keys.jsoncomo{"giphy": "<clave>"}.
Nunca les pidas que editen archivos ellos mismos. Hasta entonces, sus propios archivos GIF siguen funcionando.
-
Menciona una vez, la primera vez que usen un meme de TV o película: esos clips pertenecen a los estudios. Los GIF de reacción cortos y silenciosos se usan en todas partes en Instagram, pero existe un riesgo pequeño. Sus propios clips no tienen ninguno.
3. Sincronización (índices de palabras de la transcripción)
"word": ihace que la pieza aparezca cuando se pronuncia la palabra i. Usa la primera palabra del latido, no el inicio de la línea.- Los elementos toman su propio
"word", por lo que cada chip, marca o nodo aparece cuando se dice. Esto es lo que hace que se sienta editado. - Finalizar una pieza:
"until_word": jla termina después de la palabra j- de lo contrario, se mantiene aproximadamente 2–3 s, o hasta 1.4 s después de su último elemento
"dur": 2.5establece la longitud directamente
- Otros momentos también se pueden sincronizar con palabras:
strike_word,reply_word(chat),right_word(versus),move_word/move_end_word(scale),meter_word(person),close_word(chips de cierre).
4. Densidad del kit (kit.json → visuals.density)
| densidad | frecuencia | sensación |
|---|---|---|
calm | una pieza cada 8–10 s | un explicador limpio de experto |
steady | cada 4–6 s | la mayoría de los reels |
busy | cada 2–4 s, casi continuo | el estilo rápido de "explicador" |
Reglas en cada densidad:
- Una pieza a la vez. Dos pueden superponerse solo si están en diferentes zonas y pertenecen al mismo latido.
- Nunca durante el gancho (primeros ~3 s) o una declaración. Las piezas pueden reemplazar declaraciones: en
busy, usa como máximo 1 declaración. - No uses el mismo tipo dos veces seguidas, a menos que sea la misma lista que continúa.
- Un pop de
worddebe condensar o reformular, no reflejar el subtítulo. Cuando muestra las mismas palabras, el motor oculta el subtítulo mientras está arriba. Eso funciona, pero un pop como "todo el negocio" sobre "visión general completa de tu negocio" agrega más que repetir "no negociables". - No pongas un resaltado (
highlight_words) en una palabra que también tiene un pop-up. chatreproduce una pequeña historia completa por sí solo: escribe el prompt (con clics de teclas), lo envía (sonido de deslizar), luego muestra la IA "pensando", luego elreplysi se proporciona. Dale aproximadamente 1.5 s después de que termine la escritura, para que pueda enviar. Unreplycorto en sus palabras (el resultado que describen) hace que aterrice.- Deja breves espacios de respiración (≥0.4 s) entre piezas.
"at"anula la zona (top,left,right,chest) solo cuando la predeterminada choca con algo.
5. Construye y verifica
uv run tools/build.py projects/<name>. La compilación imprime CHECK=…/check.png: un fotograma por cada momento y pop-up. Léelo y corrige cualquier cosa que sea:
- ilegible
- fuera de la pantalla
- cubriendo la cara
- chocando con un subtítulo
- ilustrando la palabra incorrecta
- listada en una línea de
ZONA SEGURA:(se encuentra debajo del nombre de usuario de Instagram, el pie de foto o los botones de Me gusta / Comentar / Compartir). Corrige cada uno: mueve la pieza ("at"), acorta su texto, o termínala antes, luego reconstruye hasta que no haya ninguna.
Lo que aparece en pantalla:
- Sin guiones largos en el texto de pop-ups, ganchos o declaraciones. Usa una coma, un punto o un salto de línea.
- Solo números reales cuando son del propio usuario y él los dijo. Las ventanas de chat, los comentarios y los DMs usan marcadores de posición genéricos, nunca el nombre de una persona real ni un resultado inventado que se muestre como prueba.
- La publicación o el reel de otro creador en pantalla lleva su @handle.
Luego entrega como en la habilidad de nuevo reel, añadiendo una línea como: "12 pop-ups: chips para tus 4 tareas, una ventana de chat en 'prompt', un hub para tu sistema de IA…".
Cuando el usuario pregunte
-
"¿Qué gráficos puedes añadir?" / "muéstrame las opciones": abre el vídeo de catálogo si existe para su kit (
projects/*/catalog-<kit>.mp4). De lo contrario, renderiza uno en su último reel:uv run tools/build.py projects/<name> --catalog. Muestra cada pieza una vez, con su aspecto, etiquetada. Nunca describas las piezas extensamente en su lugar. -
"Más / menos pop-ups": cambia la densidad para este reel; guárdala en
visuals.densitydel kit si dicen "siempre". -
"Una lista de verificación aquí" / "muestra mi perfil cuando diga seguir": añade exactamente esa pieza en esa palabra.
-
Estilo ("tarjetas delineadas", "animaciones más tranquilas", "iconos más gruesos"): el bloque
"visuals"del kit:card:solid/outline/glassmotion:gentle/snappy/bouncyicon_stroke: 1.5–2.5radius- colores:
accent,strong,alert,word,card_color; nombres de color del kit o valores hexadecimales
Cambia su kit, nunca un valor preestablecido.