Reel a partir de video raw
Probado en dos reels: Linux Day 2 y Linux Day 1 (con efectos de sonido). library/Reel.tsx es el reel del Day 1. Copia sus patrones. No inventes un nuevo estilo.
Funciona en macOS y en Linux / Windows WSL. Configuración: consulta README.md en el repositorio.
Reglas estrictas
- Cada superposición está sincronizada desde
work/words.txten segundos. Nunca adivines un tiempo. - Usa solo componentes en
src/(la librería). Añade un nuevo componente solo cuando ningún componente de la librería se ajuste a un ritmo (beat). - Mantén la cara visible. Zonas seguras (1080x1920):
- Etiquetas y títulos superiores: y 90 a 400.
- Cara y cuello: y aproximadamente 450 a 1350. Nada aquí excepto tarjetas de título de pantalla completa (máximo 3 s).
- Todo lo demás va debajo del cuello (el primer botón de la camisa): y 1360 a 1880.
Panelcomienza enBELOW_NECK(1360). Usafitpara escalar un panel alto de modo que termine en 1880. - Encuentra la línea del cuello para cada nuevo video: captura un fotograma con una cuadrícula y mira. Actualiza
BELOW_NECKenui.tsx.
- No renderices el video completo a menos que el usuario lo pida en el chat. Usa
scripts/stills.shpara comprobar. Un hook bloquearemotion rendersinRENDER_OK=1. - No descargues nada (modelos, fuentes, música, paquetes de sonido) sin preguntar al usuario.
- Lee
reference/known-problems.mdantes de depurar cualquier cosa. - En OpenCode, el plugin
~/.config/opencode/plugins/reel-from-rawhace el mismo trabajo que los hooks de Claude (bloqueo de render, verificación de tipos, recordatorio de stills). Abre las imágenes de las hojas con la herramienta de lectura. Si tu modelo no puede ver imágenes, pide al usuario que revise las hojas.
Reglas de alcance (síguelas exactamente)
- Haz solo lo que el usuario pidió. Cambia solo los archivos y valores que la solicitud necesita.
- Una verificación (verificación de tipos, verificación de stills, recordatorio de un hook o plugin) es solo una verificación. Arregla solo lo que rompa una regla de este archivo o de
reference/style-spec.md. Nunca reestiles, añadas un componente, añadas una escena, o cambies texto, sincronización o volumen a causa de una verificación. - Si crees que algo más debería cambiar, díselo al usuario en una línea. No lo cambies.
- Nunca edites
~/.claude/skills/reel-from-raw/(este skill) mientras trabajes en un video. Edita solo el proyecto de video. - Cualquier archivo de prueba que crees (por ejemplo,
src/__probe.ts) debe ser eliminado antes de que termines.
Flujo de trabajo (nuevo video)
Ejecuta cada paso. Cada script imprime OK: en caso de éxito. Detente y arregla cualquier ERROR.
| # | Paso | Comando / acción |
|---|---|---|
| 1 | Crear proyecto | bash ~/.claude/skills/reel-from-raw/scripts/new-project.sh <dir> <raw.mp4> (por ejemplo, ~/Coding/motion-videos/<name>). Copia la librería, los archivos de sonido y los hooks, e instala paquetes npm (o los clona desde $REEL_SEED). |
| 2 | Transcribir | bash ~/.claude/skills/reel-from-raw/scripts/transcribe.sh <dir> hi (usa en solo para inglés). Luego corrige errores de transcripción con reference/glossary.md. |
| 3 | Cortar silencios | python3 ~/.claude/skills/reel-from-raw/scripts/cuts.py <dir>. Usa --start/--end para eliminar un falso inicio o final. |
| 4 | Hoja de ritmos | Sigue reference/beat-sheet-prompt.md. Escribe work/beats.md. Muéstralo al usuario si quiere aprobar el plan. |
| 5 | Construir | src/Reel.tsx es el reel del Day 1. Reescríbelo a partir de la hoja de ritmos. En Root.tsx, establece id (por ejemplo, LinuxDay3) y el handle real. Elimina componentes de escenas que el reel no use. Mantén los ayudantes At y r(). |
| 6 | Verificación de tipos | Automática: un hook ejecuta tsc --noEmit después de cada edición. Corrige cualquier error que reporte. |
| 7 | Verificación visual | bash ~/.claude/skills/reel-from-raw/scripts/stills.sh <dir> auto, luego lee cada out/stills/sheet*.jpg. También verifica fotogramas de ritmos: stills.sh <dir> 120,450,.... Verifica contra reference/style-spec.md. Corrige y repite. |
| 8 | Verificación de sonido | Los efectos de sonido vienen con los componentes (consulta "Efectos de sonido"). Verifica que public/sfx/typing.wav y public/sfx/pop.wav existan. No añadas sonidos fuera de la tabla a menos que el usuario lo pida. |
| 9 | Vista previa | Añade una entrada launch.json que ejecute npx remotion studio --no-open --port <libre> en el proyecto. Dale al usuario la URL http://localhost:<puerto>. El usuario escucha los sonidos allí. |
| 10 | Renderizar (solo a petición) | RENDER_OK=1 npx remotion render <Id> out/<nombre>.mp4 --gl=angle (ejecutar en segundo plano, unos 3-5 min para 90 s). |
Efectos de sonido
src/sfx.tsx contiene todos los sonidos. SFX lista los sonidos. <Sfx src at volume frames name> reproduce un sonido at fotogramas dentro de la secuencia actual.
Clave en SFX | Fuente | ¿Necesita Internet? |
|---|---|---|
whoosh, ding, click, switch, whip | @remotion/sfx (archivos en remotion.media) | Sí, para Studio y render |
pop | public/sfx/pop.wav (generado por código) | No |
typing | public/sfx/typing.wav (generado por scripts/make-typing-sound.py) | No |
Los componentes de la librería ya reproducen estos sonidos. No los añades manualmente.
| Momento | Archivo (en el proyecto) | Sonido | Volumen |
|---|---|---|---|
| Título / chip secundario del gancho | scenes/Intro.tsx (Hook) | whoosh / whip | 0.54 / 0.48 |
| Tarjeta de título del día | scenes/Intro.tsx (DayTitle) | whoosh / ding | 0.6 / 0.36 |
| Chips de lista de comandos | scenes/Intro.tsx (CommandList) | pop por chip | 0.36 |
| Etiqueta de comando / nombre de comando | scenes/Commands.tsx (CommandTag) | whoosh / switch | 0.54 / 0.48 |
| Líneas de bloc de notas | scenes/Commands.tsx (NoteCard) | typing por línea | 0.6 |
| Panel inferior aparece | ui.tsx (Panel) | pop | 0.48 |
| Comando de terminal escrito | ui.tsx (Terminal) | typing por cada línea de comando | 0.6 |
| Filtro de luz | Reel.tsx | whoosh | 0.48 |
| Insignia de finalizado / clic de seguimiento | scenes/Outro.tsx (DayDone, FollowCard) | ding / click | 0.48 / 0.72 |
Cualquier <Sfx> sin volume | sfx.tsx (predeterminado) | - | 0.42 |
El volumen va de 0 (silencio) a 1 (completo). Mantén todos los sonidos por debajo de la voz.
Solicitudes comunes (receta exacta)
| El usuario pide | Haz exactamente esto |
|---|---|
| "Aumentar / disminuir todos los efectos de sonido en un N%" | Multiplica cada volume={x} en una línea <Sfx, y el valor predeterminado en sfx.tsx, por (1 ± N/100). Redondea a 2 decimales. No toques CutVideo.tsx (esa es la voz). Ejecuta grep -rn "<Sfx" src antes y después, y muestra los valores cambiados. |
| "Cambiar solo el volumen del teclado / escritura" | Cambia solo las líneas con src={SFX.typing} (ui.tsx Terminal y scenes/Commands.tsx NoteCard). |
| "Cambiar solo el sonido X" | Encuentra su fila en la tabla anterior. Cambia solo ese volume. |
| "El sonido del teclado es débil / haz uno nuevo" | python3 ~/.claude/skills/reel-from-raw/scripts/make-typing-sound.py <proyecto>/public/sfx/typing.wav. Guarda una copia del archivo anterior primero. Edita los números en el script solo si el usuario pide una sensación diferente. |
| "Eliminar un sonido" | Elimina esa línea <Sfx .../>. |
| "¿Dónde puedo escucharlo antes de renderizar?" | Studio (paso 9). Presiona Reproducir o Espacio. Studio se recarga solo después de cada edición guardada. |
| "¿Cómo renderizo yo mismo?" | Terminal: cd <proyecto> && npx remotion render <Id> out/<nombre>.mp4 --gl=angle. UI de Studio: botón Render (extremo derecho de la barra sobre la línea de tiempo) → pestaña Video → establece Nombre de salida → Render video. El progreso se muestra en la pestaña Trabajos. La configuración de OpenGL ya es angle. |
| "Renderízalo" | Paso 10, con RENDER_OK=1. Luego da la ruta completa del archivo de salida. |
| "Cambiar el handle" | Root.tsx defaultProps.handle. |
Cómo funciona la sincronización
src/timeline.ts:CUTS(segundos raw eliminados),out(sec)mapea un segundo raw a un fotograma de salida.<At from={rawSec} to={rawSec} name="...">muestra un bloque para ese intervalo hablado.r(t0, t)da un retardo de fotograma dentro de un bloque, para "mostrar esto cuando se dice la palabra en t".CutVideoalterna zoom 1.0 / 1.14 por segmento (zoom de impacto en cada corte). No añadas más zoom.
Mapa de la librería
| Archivo | Exportaciones | Usar para |
|---|---|---|
theme.ts | DISPLAY (Anton), SANS (Inter), MONO, colores C, extrude() | Todo el texto y color. Sin nuevas fuentes o colores. |
sfx.tsx | SFX, Sfx | Efectos de sonido (ver arriba) |
ui.tsx | Pop, useIn, useOut, BELOW_NECK, Panel, TermFrame, Terminal | Aparición con resorte, panel inferior, terminal escrito |
scenes/Intro.tsx | Hook({title, sub, subAt}), DailyStep({children}), DayTitle({day}), CommandList({commands, line, lineAt}), LightLeak | Apertura, transiciones de sección |
scenes/Commands.tsx | CommandTag({n, total, name, nameAt, meaning, meaningAt, color}), FolderPath, FileGrid, MoveSwap, NoteCard | Un tema por sección: etiqueta arriba, visual en Panel |
scenes/Commands.tsx (Día 2, texto codificado) | IdCard, OwnerSwap, PhoneApps, Snapshot, TopView, PdfSearch | Añade props para el texto antes de reutilizar uno |
scenes/Outro.tsx | DayDone({day}), NextDay({day, commands, at}), FollowCard({handle}) | Final (NextDay es opcional) |
Reel.tsx | Reel | Reel completo del Día 1. Úsalo como ejemplo para la estructura. |
Mantén tamaños, colores y animaciones cuando cambies texto.