Edición y Control de Calidad de Video
Nunca edites en el lugar. Escribe las salidas en un archivo nuevo (*_v2.mp4, renders/), mantén intacto el original y confirma antes de sobrescribir o eliminar cualquier cosa.
Recetas de edición (FFmpeg)
# Recortar sin recodificar (corta en keyframes) / con precisión de fotograma recodificando
ffmpeg -ss 00:00:05 -to 00:00:20 -i in.mp4 -c copy out.mp4
ffmpeg -i in.mp4 -ss 5 -to 20 -c:v libx264 -crf 16 -c:a aac out.mp4
# Concatenar clips con códecs idénticos
printf "file '%s'\n" a.mp4 b.mp4 > list.txt && ffmpeg -f concat -safe 0 -i list.txt -c copy out.mp4
# Reencuadrar de 16:9 a 9:16 alrededor de un sujeto en x=CX (píxeles); prefiere recomponer el diseño en su lugar
ffmpeg -i in.mp4 -vf "crop=ih*9/16:ih:CX-ih*9/32:0,scale=1080:1920" -c:a copy out_9x16.mp4
# Quemar subtítulos (estilo para redes sociales) / adjuntar como pista blanda
ffmpeg -i in.mp4 -vf "subtitles=captions.srt:force_style='FontName=Inter,FontSize=14,Outline=1,MarginV=60'" out.mp4
ffmpeg -i in.mp4 -i captions.srt -c copy -c:s mov_text out.mp4
# Reemplazar audio / atenuar música bajo la voz / normalizar a -14 LUFS
ffmpeg -i in.mp4 -i mix.wav -map 0:v -map 1:a -c:v copy -shortest out.mp4
ffmpeg -i music.wav -i vo.wav -filter_complex "[0][1]sidechaincompress=threshold=0.05:ratio=8:attack=150:release=300[m];[m][1]amix=inputs=2:normalize=0" mix.wav
ffmpeg -i mix.wav -af loudnorm=I=-14:TP=-1:LRA=11 -ar 48000 mix_norm.wav # dos pasadas para entrega final
# Codificación para entrega web/redes sociales (desde el master; el master ya es CRF 16 — ver hyperframes-production)
ffmpeg -i in.mp4 -c:v libx264 -pix_fmt yuv420p -crf 18 -preset slow -movflags +faststart -c:a aac -b:a 192k out.mp4
Para recortes de cabezas parlantes, corta en los límites de las oraciones a partir de una transcripción (marcas de tiempo voice-video-sync), elimina solo los rellenos donde el corte sea invisible y mantén 80–150 ms de tono de ambiente en cada corte. Para el reencuadre de animaciones diseñadas, recomponer por relación de aspecto en el proyecto fuente en lugar de recortar cuando sea posible.
Compuertas de control de calidad
Ejecutar desde el directorio del proyecto (QC=<plugin-root>/scripts/qc.sh):
$QC probe final.mp4 # códec, tamaño, fps, duración, audio presente
$QC sheet final.mp4 qc/sheet.png 4 4 # hoja de contactos para una lectura completa
$QC stills final.mp4 qc/ 0.5 3 7.5 # un fotograma por compás de la historia; falla si termina después del final
$QC loudness final.mp4 # -14 ±1 LUFS (pasa -23 para transmisión), pico verdadero <= -1 dBTP
$QC loop final.mp4 # solo bucles: la costura debe verse como un paso de fotograma normal
Luego revisa los fotogramas y la hoja contra el storyboard:
| Compuerta | Pasa cuando |
|---|---|
| Especificaciones | resolución, fps, duración y códec coinciden con el brief para cada relación de aspecto |
| Historia | comprensible con el sonido apagado; los primeros 2 s transmiten el valor o el gancho |
| Continuidad | cada corte tiene su portador; sin transiciones entre pantallas no relacionadas; sin costuras de ping-pong |
| Ritmo | acciones clave en los compases; sin fotogramas muertos; sin quietud inmotivada > 3 s |
| Legibilidad | texto sin recortar ni superponer; subtítulos ≤2 líneas dentro de áreas seguras; números legibles a través del desenfoque de movimiento |
| Marca | colores muestreados coinciden con los tokens; fuentes y conjunto de iconos correctos; sin rediseño |
| Datos | cada número o afirmación en pantalla está en la lista de datos del storyboard |
| Seguridad | sin PII, sin marcas reales de terceros sin permiso, licencias y atribuciones presentes |
| Audio | sonoridad y pico verdadero dentro del rango; SFX bajo la música; VO inteligible sobre la música |
| Accesibilidad | ≤3 destellos por segundo; subtítulos coinciden con las palabras habladas |
| Bucle | cuando se solicita, la costura pasa qc.sh loop |
| Determinismo | la misma marca de tiempo renderizada dos veces es idéntica (verificar 3 fotogramas al azar) |
Informa cada compuerta como pasa / falla / no revisada, con la ruta de evidencia (fotograma, hoja, salida del comando).
Corrige las fallas en la fuente y vuelve a renderizar; no las encubras en la codificación final. Para videos
largos, divide el control de calidad por capítulo y usa el agente motion-qc por capítulo en paralelo.