FlashRecord — ferramenta ultraleve de gravação de terminal para desenvolvedores - capturas de tela e GIFs direto do terminal

Olá, aqui é a Flamehaven, criando toda semana ferramentas novas e úteis. Nesta semana, apresentamos o FlashRecord.

O FlashRecord é uma ferramenta de captura de tela CLI nativa em Python ultraleve (≈2 MB), projetada para entrar direto no fluxo de trabalho de desenvolvedores. Não há GUI; você pode criar capturas de tela (@sc) e gravações em GIF (@sv) diretamente do terminal, além de integrar tudo diretamente a scripts/testes/CI com import flashrecord.

Principais recursos

• CLI em primeiro lugar & nativo em Python — execute diretamente com import flashrecord ou flashrecord @sv em pipelines.
• Amigável para workflows — salvamento automático de sessões Claude/Gemini/Codex, exportação de snippets em Markdown para PRs/documentação e suporte a notas de instrução inline.
• Ultraleve: cerca de 2 MB de instalação, com dependências focadas em bibliotecas padrão como Pillow/NumPy/imageio
• Simplicidade de um comando — @sc (captura de tela), @sv (gravação em GIF) — compatível tanto com uso interativo quanto via script.
• Compressão inteligente — implementação pura em PIL+NumPy inspirada em CWAM, reduzindo bastante o tamanho dos arquivos enquanto preserva as partes visualmente importantes.
• Vários presets de compressão — como high, balanced, compact, permitindo escolher o equilíbrio entre qualidade e tamanho.
• Otimização temporal e espacial — subamostragem temporal (ex.: 10→8 FPS), escalonamento adaptativo de resolução e preservação de qualidade baseada em saliência (variância, densidade de bordas, entropia).
• Fidelidade de cores RGB preservada — as áreas importantes mantêm todas as informações de cor.
• Limpeza automática & gerenciamento de retenção — é possível configurar a exclusão automática de arquivos com mais de N horas, com nomenclatura de saída e estrutura de pastas consistentes.
• Multiplataforma — mesmos comandos em Windows / macOS / Linux (※ macOS: screencapture, Linux: gnome-screenshot/scrot, Windows: baseado em ImageGrab).
• Pronto para produção — inclui suíte de testes com pytest, documentação em Sphinx e CI com GitHub Actions.
• Integração fácil com scripts & CI — caminhos de saída determinísticos, permitindo anexar evidências visuais diretamente em testes, scripts de build e jobs de CI.
• Sem dependências nativas extras — requer basicamente apenas Pillow, NumPy e imageio, sem binários externos pesados.
• Captura e codificação rápidas — capturas de tela em cerca de 10–50 ms (dependendo da plataforma); pipeline de captura/codificação ajustado ao workflow de desenvolvedores.
• API extensível — fornece funções importáveis para captura de tela/gravação/gerenciamento de sessão, podendo ser embutidas em ferramentas ou testes.
• Foco em privacidade — o padrão é processamento local; uploads para a nuvem só funcionam quando integrados pelo usuário.
• Roadmap pronto — saídas em WebP/MP4, captura de áudio, captura por janela, extensão para VSCode, streaming e mais estão planejados.

Principais casos de uso:

• Gerar rapidamente GIFs para descrições de PRs e documentação
• Automatizar testes visuais no CI e anexar GIFs de evidência em caso de falha
• Produzir assets de tutorial/demo sem sair do terminal

Experimente agora mesmo (instalação a partir do código-fonte):

git clone https://github.com/Flamehaven/FlashRecord  
cd FlashRecord  
pip install -e .  
flashrecord @sc        # captura de tela  
flashrecord @sv 5 10   # exemplo: 5 segundos, 10 FPS  
  

Repositório: https://github.com/Flamehaven/FlashRecord — licença MIT.

Feedback, issues e PRs são bem-vindos — se quiser benchmarks específicos (tamanho antes/depois de GIFs de exemplo, desempenho por resolução/FPS) ou explicações técnicas mais detalhadas, posso publicar em seguida.