Cómo grabar demos de terminal y CLI que se puedan seguir de verdad

Las demos de terminal están entre los vídeos más útiles que puede hacer quien programa. También entre los más difíciles de ver. Texto monoespaciado diminuto, un muro de salida que se desplaza, un comando que desaparece por arriba antes de que nadie pueda leerlo… y a los dos minutos el espectador se rinde.

La solución está casi por completo en la preparación. Una grabación de terminal que funciona se construye antes de pulsar Grabar, no se rescata después. Este es el proceso completo.

Por qué cuesta tanto ver una grabación de terminal

Una grabación de interfaz gráfica tiene anclas visuales: botones, iconos, disposición. Una terminal no tiene ninguna. Todo es del mismo tamaño, del mismo color, y se mueve rápido. Los problemas son siempre los mismos:

• Texto demasiado pequeño: una fuente cómoda a un brazo de distancia resulta ilegible en un vídeo 1080p reproducido en una ventana pequeña
• Temas con poco contraste: los grises apagados sobre un fondo casi negro quedan elegantes en tu monitor y desaparecen tras la compresión de vídeo
• Salida que se escapa: la línea interesante pasa volando mientras aún estás explicando el comando
• Entrada invisible: quien mira no ve tus pulsaciones, así que un flag escrito rápido parece magia
• Tiempos muertos: instalaciones, compilaciones y suites de tests generan treinta segundos en los que no pasa nada

Todos tienen arreglo en menos de cinco minutos.

Prepara la terminal antes de grabar

Trata tu terminal de demos como un entorno distinto del de trabajo. La mayoría de aplicaciones de terminal admiten perfiles: crea uno llamado «Recording» y configúralo una sola vez.

• Tamaño de fuente 18–24 pt: aproximadamente el doble de lo habitual. Si en tu monitor parece absurdo, seguramente sea lo correcto para vídeo
• Tema de alto contraste: texto claro sobre fondo oscuro sólido. Evita por completo la transparencia y las imágenes de fondo: se comprimen mal y añaden ruido visual
• Tamaño de ventana, no pantalla completa: una terminal a pantalla completa demasiado grande encoge el texto respecto al encuadre. Una ventana de unas 90–100 columnas llena bien un cuadro 16:9
• Desactiva las ligaduras si confunden: los glifos de flecha para -> y != despistan a quien intenta copiar tus comandos
• Sube un poco el interlineado: un respiro mínimo hace que una salida densa se lea mucho mejor

Limpia tu shell

El prompt y el historial llevan más información de la que crees. Antes de grabar:

• Simplifica el prompt: un prompt largo con rama de Git, versión de Node, marca de tiempo y una ruta de dos líneas se come el ancho y distrae. Lo ideal es un breve ~/project $
• Oculta tu usuario y tu hostname: identifican a ti y a tu máquina en un vídeo que quizá publiques
• Vacía el buffer de desplazamiento y el historial: los comandos anteriores pueden revelar nombres de clientes, hosts internos o trabajo ajeno
• Revisa tus variables de entorno: la salida de env en vídeo ha filtrado más claves de API que cualquier fragmento de código
• Usa un directorio desechable: una carpeta de proyecto limpia evita archivos sueltos en la salida de ls
• Desactiva las notificaciones: la campana de la terminal y los avisos del escritorio arruinan una toma

Si tu demo toca credenciales reales, usa valores ficticios. Tapar cosas en posproducción cuesta mucho más que definir antes API_KEY=demo-key-1234.

Planifica la secuencia de comandos

Escribe los comandos antes de grabar, en un archivo de notas y no de memoria. Un guion breve con exactamente lo que vas a teclear, en orden, hace tres cosas: evita erratas bajo presión, mantiene la demo en línea recta y se convierte en el esquema de tu narración.

Después recórrelo entero una vez sin grabar. Ahí aparecen las sorpresas: una caché ya caliente, una dependencia por instalar, una confirmación que habías olvidado. Al terminar, restablece el directorio para que la toma grabada parta del mismo estado.

Ajustes de grabación para trabajo en terminal

El contenido de una terminal es casi todo texto estático: indulgente en unos aspectos y exigente en otros.

• Captura la ventana, no toda la pantalla: la captura de ventana ciñe el encuadre a la terminal y oculta el resto del escritorio
• 30 fps sobran: el texto no necesita 60 fps. Además, una tasa menor significa texto más nítido con el mismo bitrate
• Graba a la resolución nativa de tu pantalla: ampliar el texto después es justo lo que produce el desenfoque
• Sin webcam, o muy pequeña: en una demo de terminal el protagonista es la salida. Un PiP grande tapa la esquina inferior, que es exactamente donde aparece el texto nuevo

El ritmo: lo que casi todo el mundo falla

El ritmo de una buena demo de terminal no es el ritmo al que tú trabajas.

1. Di qué vas a hacer antes de teclearlo: «Ahora instalo la CLI de forma global»
2. Escribe a un ritmo constante y deliberado, más lento de lo normal pero sin exagerar
3. Haz una pausa antes de pulsar Intro para que el comando completo se vea y se pueda leer
4. Guarda silencio mientras aparece la salida y habla después
5. Señala lo importante en lugar de leer toda la salida en voz alta

Con los comandos largos, tecléalos en dos pasos visibles —primero el comando base y luego los flags— mientras explicas qué hace cada uno. Se sigue mucho mejor que una línea de cuarenta caracteres que aparece de golpe.

Cómo manejar comandos largos

Nadie quiere ver un npm install de noventa segundos. Tienes tres buenas opciones:

• Rampas de velocidad: mantén el comando a la vista y pasa la espera a 4x–10x, para que se vea que ocurrió sin tener que sufrirlo
• Recorta la espera: corta desde que arranca el comando hasta justo antes del resultado. Corta en una línea de prompt y la edición será invisible
• Precalienta la caché: ejecuta el comando una vez antes de grabar y en la toma terminará en pocos segundos de forma natural

Elijas lo que elijas, di en voz alta cuánto tarda de verdad —«esto suele tardar unos dos minutos»— para que nadie se sorprenda al probarlo.

Haz legible la salida en el editor

La fase de edición es la que convierte una grabación decente en una buena.

• Haz zoom sobre la salida importante: acercarse a las tres líneas que importan es muchísimo más eficaz que pedir al espectador que entorne los ojos ante una pantalla de logs
• Añade superposiciones de texto para los comandos clave: poner el comando en pantalla como rótulo da algo que leer mientras narras
• Anota los mensajes de error: cuando muestres un fallo a propósito, resalta la línea que lo explica
• Añade capítulos: Instalación, Configuración, Primera ejecución, Solución de problemas; las demos de terminal se siguen haciendo, y hace falta volver atrás
• Elimina los silencios: la eliminación automática de silencios aprieta los huecos alrededor de los comandos sin tocar tu forma de hablar

Combinar la terminal con otras ventanas

Casi ninguna demo real es solo terminal. Ejecutas un comando, revisas el navegador y luego editas un archivo de configuración.

• Decide la disposición antes de grabar: terminal y navegador en paralelo, o cambio a pantalla completa; elige una y mantenla
• Si cambias de ventana, pausa antes: da medio segundo para que se registre el cambio antes de seguir hablando
• Mantén tamaños de fuente coherentes: una fuente grande de terminal junto a una diminuta de editor deja el editor ilegible
• Valora la captura de área: si tienes una disposición fija de dos ventanas, capturar esa región mantiene el encuadre estable en todo el vídeo

Lista de comprobación previa

[ ] Perfil de grabación activo: fuente grande, tema de alto contraste, sin transparencia
[ ] Prompt simplificado, usuario y hostname ocultos
[ ] Buffer de desplazamiento e historial vaciados
[ ] Secretos sustituidos por valores ficticios
[ ] Secuencia de comandos escrita y ensayada una vez
[ ] Directorio de trabajo restablecido a un estado limpio
[ ] Notificaciones y campana de terminal desactivadas
[ ] Captura de ventana seleccionada, 30 fps, resolución nativa
[ ] Prueba de diez segundos revisada para comprobar la legibilidad

Ese último punto es el que más cuenta. Graba diez segundos, reprodúcelos al tamaño en que realmente los verá tu público y pregúntate si el texto se lee con comodidad. Si no, sube la fuente y repite antes de comprometerte con una toma de doce minutos.

Errores frecuentes

• Grabar a pantalla completa en una pantalla 4K: el texto acaba microscópico en el vídeo exportado
• Limpiar la pantalla continuamente: el espectador pierde el contexto de lo que acaba de pasar
• Redimensionar la terminal a mitad de grabación: el texto se reorganiza y resulta brusco
• Leer la salida literalmente: resume — «pasan las doce pruebas»
• Dejar el cursor parpadeando sobre un fotograma estático: recorta esas colas, hacen que el vídeo parezca atascado
• Dar por hecho que conocen tus alias: si escribes gs, di que es git status

Conclusión

Una demo de terminal se gana o se pierde en la legibilidad. Fuente grande, tema de alto contraste, prompt limpio, secuencia ensayada y un latido de pausa antes de cada Intro. Luego, en el editor, el zoom y las rampas de velocidad mantienen la atención donde está la salida que importa. Con eso, tus recorridos por la línea de comandos dejan de ser algo que se aguanta y pasan a ser algo que la gente sigue con su propia terminal abierta al lado.