¿Qué hace screen-demo?
Convierte una URL en un video demo. Eres el director: examinas la página, escribes el recorrido como JSON, y el script lo reproduce, captura los fotogramas propios de la página (nunca el escritorio) y edita el video. Los desplazamientos, el deslizamiento del cursor y la escritura se capturan fotograma a fotograma a 30 fps, por lo que son suaves incluso en una página pesada; lo que la página hace por sí misma después de un clic o una carga proviene de la screencast en vivo.
Configuración (una vez)
- Python 3.10+ con Pillow y un Playwright reciente:
python -m pip install -U playwright pillow, luegopython -m playwright install chromium. - ffmpeg en PATH (
winget install ffmpeg,brew install ffmpeg).
Verifica con python tests/selftest.py (una página local, sin red, aproximadamente un minuto).
Flujo de trabajo
- Pregunta para qué es el video: la URL, las 2 a 4 cosas que mostrar (el hero, una característica, el precio, un flujo de registro), el formato (
landscape16:9 para YouTube y READMEs,vertical9:16 para Shorts y Reels,square), y si quieren un GIF. Solo el sitio o aplicación propios del usuario, o una página pública que tenga permiso de mostrar. - Examina la página:
python scripts/demo.py inspect URL WORK [--format vertical]. Lee cadaWORK/page-N.jpg(la página en segmentos del tamaño de la ventana, cada elemento cliqueable enmarcado con un número rojo) yWORK/elements.txt. Aquí aparece un banner de cookies o una ventana emergente: el primer paso del recorrido lo cierra (el botón "Rechazar" o "Cerrar"). - Escribe
WORK/tour.json(formato en references/tour-format.md): una tarjeta de título, luego pasos cortos. Un buen recorrido: una leyenda que dice qué hace el producto, un desplazamiento a lo primero que vale la pena ver, un zoom en ello, un clic o algo de escritura que muestre el producto funcionando, un resaltado en el resultado, una leyenda por idea. De 15 a 40 segundos. Los objetivos son los números de inspect (#12), ocss=...otext=.... - Graba:
python scripts/demo.py record WORK/tour.json OUT [--gif]. Reproduce el recorrido, imprime cada paso que falló, y renderizaOUT/demo.mp4(yOUT/demo.gif). - Revisa
OUT/keys.jpg(un fotograma de cada paso) antes de darlo por terminado: un zoom en lo incorrecto, una leyenda sobre el punto del fotograma, un paso que falló (el elemento se movió o estaba oculto), un banner todavía en medio. Para cambiar solo las leyendas, zooms o la tarjeta de título, editaOUT/tour.jsony ejecutapython scripts/demo.py render OUT [--gif](sin nueva grabación); para cualquier otra cosa, graba de nuevo. - Entrega: la ruta de
demo.mp4(y el GIF), su duración, y una línea por cada idea que muestra.
Reglas
- Nunca iniciar sesión con una contraseña, nunca escribir una contraseña o número de tarjeta (el script rechaza campos de contraseña y pago), nunca comprar, enviar, publicar o eliminar nada, nunca enviar un formulario con datos personales de alguien. Una demo de un área con inicio de sesión requiere que el usuario proporcione una página de cuenta de prueba ellos mismos.
- Rechazar banners de cookies (la menor cantidad de datos) a menos que el usuario indique lo contrario.
- Mantener las leyendas cortas (3 a 8 palabras); una idea por leyenda; el movimiento propio del video hace el resto.
- Respetar el sitio: ningún recorrido de una página que el usuario no tenga permiso de mostrar.
Ejemplo
Usuario: "haz un demo de 20 segundos de mi landing page https://example.com para el README, muestra el registro"
Ejecutas inspect, lees las 3 imágenes, ves un banner de cookies (#2 "Rechazar todo"), el hero, un campo "Pruébalo" (#9) y una tarjeta de precios (#21); escribes un recorrido: una tarjeta de título, clic en #2, leyenda "Notas que se escriben solas", escribir en #9, clic en #10, resaltar el resultado, leyenda "Gratis para siempre", desplazarse a #21, zoom; grabas con --gif, abres keys.jpg, ves que el zoom enmarcó bien el precio, y respondes con demo.mp4 (21 s), demo.gif (3 MB) y las cuatro ideas.