O que screen-demo faz?
Transforma uma URL em um vídeo de demonstração. Você é o diretor: examina a página, escreve o tour como JSON, e o script reproduz, captura os quadros da própria página (nunca a área de trabalho) e edita o vídeo. Rolações, o deslizar do cursor e a digitação são capturados quadro a quadro a 30 qps, portanto são suaves mesmo em páginas pesadas; o que a página faz por si mesma após um clique ou carregamento vem da transmissão ao vivo.
Configuração (uma vez)
- Python 3.10+ com Pillow e um Playwright recente:
python -m pip install -U playwright pillow, depoispython -m playwright install chromium. - ffmpeg no PATH (
winget install ffmpeg,brew install ffmpeg).
Verifique com python tests/selftest.py (uma página local, sem rede, cerca de um minuto).
Fluxo de trabalho
- Pergunte para que é o vídeo: a URL, as 2 a 4 coisas a mostrar (o herói, um recurso, o preço, um fluxo de cadastro), o formato (
landscape16:9 para YouTube e READMEs,vertical9:16 para Shorts e Reels,square), e se querem um GIF. Apenas o próprio site ou aplicativo do usuário, ou uma página pública que ele tenha permissão de exibir. - Examine a página:
python scripts/demo.py inspect URL WORK [--format vertical]. Leia cadaWORK/page-N.jpg(a página em fatias do tamanho da viewport, cada elemento clicável numerado em vermelho) eWORK/elements.txt. Um banner de cookies ou pop-up aparece aqui: o primeiro passo do tour fecha ele (o botão "Rejeitar" ou "Fechar"). - Escreva
WORK/tour.json(formato em references/tour-format.md): um cartão de título, depois passos curtos. Um bom tour: uma legenda que diz o que o produto faz, uma rolagem até a primeira coisa que vale a pena ver, um zoom nela, um clique ou alguma digitação que mostre o produto funcionando, um destaque no resultado, uma legenda por ideia. 15 a 40 segundos. Os alvos são os números da inspeção (#12), oucss=...outext=.... - Grave:
python scripts/demo.py record WORK/tour.json OUT [--gif]. Reproduz o tour, imprime cada passo que falhou, e renderizaOUT/demo.mp4(eOUT/demo.gif). - Veja
OUT/keys.jpg(um quadro de cada passo) antes de considerar pronto: um zoom no lugar errado, uma legenda sobre o ponto do quadro, um passo que falhou (o elemento moveu-se ou estava oculto), um banner ainda no caminho. Para alterar apenas legendas, zooms ou o cartão de título, editeOUT/tour.jsone executepython scripts/demo.py render OUT [--gif](sem nova gravação); qualquer outra coisa, grave novamente. - Entregue: o caminho de
demo.mp4(e o GIF), sua duração, e uma linha por ideia que ele mostra.
Regras
- Nunca faça login com senha, nunca digite senha ou número de cartão (o script recusa campos de senha e pagamento), nunca compre, envie, publique ou exclua nada, nunca envie um formulário com dados pessoais de alguém. Uma demonstração de uma área logada precisa que o usuário forneça a página de uma conta de teste.
- Recuse banners de cookies (o mínimo de dados) a menos que o usuário diga o contrário.
- Mantenha legendas curtas (3 a 8 palavras); uma ideia por legenda; o próprio movimento do vídeo faz o resto.
- Respeite o site: nenhum tour de uma página que o usuário não possa exibir.
Exemplo
Usuário: "faça uma demonstração de 20 segundos da minha landing page https://exemplo.com para o README, mostre o cadastro"
Você executa o inspect, lê as 3 fatias, vê um banner de cookies (#2 "Rejeitar todos"), o herói, um campo "Experimente" (#9) e um cartão de preço (#21); você escreve um tour: um cartão de título, clique em #2, legenda "Notas que se escrevem sozinhas", digite em #9, clique em #10, destaque o resultado, legenda "Gratuito para sempre", role até #21, zoom; grave com --gif, abra keys.jpg, veja que o zoom enquadrou bem o preço, e responda com demo.mp4 (21 s), demo.gif (3 MB) e as quatro ideias.