Quando Usar

Use ao polir uma gravação de tela / vídeo de demonstração para compartilhamento, quando o usuário mencionar Screen Studio, zoom automático, aceleração de inatividade ou vídeo vertical/social a partir de uma captura de tela, e para qualquer demonstração voltada para redes sociais (saída vertical é o padrão para elas).

Fonte: connerkward/screenstudio-alternative-skill (MIT).

screenstudio-alt

O código da skill fica neste diretório (polish.py, render.py, studio.py, events-log.swift, fixtures de teste, etc.). Publicado publicamente como connerkward/screen-studio-alternative através da skill publish-skill.

Dois componentes:

• events-log (Swift) — registrador de entrada do lado da captura (cursor 60Hz, cliques, teclas; descarta teclas durante a entrada segura do macOS). Executa APENAS durante a gravação. Precisa de Acessibilidade/Monitoramento de Entrada para o terminal. Zoom automático/teclas/cursor precisam desses dados no momento da captura — não podem ser recuperados de pixels depois.
• polish.py (Python, ffmpeg + PIL) — o passe de pós-produção:

python3 src/polish.py in.mp4 --events in.events.jsonl \
  --speedup            # compress idle (input-gap ∩ frozen-pixels; animations stay 1x)
  --zoom               # eased auto-zoom on click clusters (zoompan)
  --keys               # accumulating keystroke chips (PIL overlays, no drawtext dep)
  --smooth-cursor      # synthetic eased cursor (best with sck-record --no-cursor)
  --vertical           # ALSO emit 1080x1920 following the action

--speedup funciona SEM eventos (apenas detecta congelamento) — utilizável em todo o corpus de diários existente.

• render.py — renderizador não destrutivo de alta qualidade (preferencial): câmera de física de mola em um único passe sobre os frames originais de alta resolução, LANCZOS para um alvo menor (zoom nítido, ~1.3× mais nítido que o caminho de upscale do ffmpeg), 60fps, H + 9:16 V. Ajustável --freq/--zeta (mola), --fps, --target-w. Aceita --regions [{t0,t1,z,cx,cy}] explícito. polish.py é o fallback mais antigo de filtro ffmpeg.
• studio.py [recording.mp4] — interface web local, linha do tempo de régua fixa estilo NLE (barra = duração da fonte, nunca escala → upstream sempre fixado): regiões de zoom são blocos arrastáveis (mover / redefinir bordas / clicar para adicionar / duplo clique para excluir); intervalos de inatividade são blocos de velocidade com edição apenas de taxa — intervalo da fonte travado, taxa definida via inspetor slider ao selecionar ou arrastar esticar taxa na borda direita (retime FCP / Esticar Taxa Premiere); alterações de taxa se propagam apenas para downstream. Rampa de suavização cosseno ajustável, zoom padrão, aspecto, estilo de quadro. Cursor sintético sempre suave + ripple de clique + som de clique real gravado (CC0 #735771). Exportação usa render.py. Porta livre, local. (Overlay de tecla existe no motor, mas está desativado por padrão.)

Caminho Fácil

screencast.sh --demo (skill de screencast) faz toda a cadeia: inicia o registrador de eventos, grava, depois polir + emite o 9:16 vertical automaticamente. Vertical é o PADRÃO para demonstrações voltadas para redes sociais.

Armadilhas (aprendidas da maneira difícil, mantidas aqui para não serem reaprendidas)

• ffmpeg NÃO PODE fazer scale=eval=frame animado → crop (redefinição de link trava expressões por frame de corte). É por isso que o zoom usa zoompan (sem variável t lá — use on/FPS).
• O ffmpeg desta máquina não tem drawtext; todos os overlays de texto/cursor são PNGs renderizados por PIL + overlay.
• Rig de teste: make-fixture.py sintetiza uma gravação de tela falsa + eventos.jsonl de verdade — valide qualquer alteração contra isso antes de confiar em filmagem real.

Limitações

• O fluxo de trabalho assume que o FFmpeg mais os scripts complementares estão disponíveis localmente; não é um editor de vídeo hospedado.
• Efeitos de cursor, clique e tecla polidos dependem de logs de eventos capturados durante a gravação; logs ausentes limitam o que pode ser reconstruído.
• Zoom automático e aceleração de inatividade ainda precisam de revisão humana para ritmo, enquadramento e gosto específico da plataforma.