Repolode
Enviar
homeport

homeport/termshot

Uma CLI que executa um comando no terminal e renderiza a saída colorida em ANSI como uma captura de tela PNG no estilo de uma janela.

Ver no GitHub
Estrelas
976
Forks
42
Issues abertas
37
Último commit
mês passado

O que é?

termshot executa um comando em um pseudo-terminal, captura a saída — incluindo códigos de cor e formatação ANSI — e a renderiza como uma imagem parecida com uma janela de terminal. Ao contrário de ferramentas que aplicam realce de sintaxe a texto colado, ele usa os códigos de escape emitidos pelo próprio comando. Assim, a saída de ferramentas como ls, figlet ou lolcat mantém as cores originais.

O uso é simples: basta prefixar qualquer comando com termshot; por padrão, ele gera o arquivo out.png. As flags controlam a aparência (decoração da janela, sombra, margem, espaçamento interno, quebra de linha por colunas e exibição do comando), a saída (caminho do arquivo ou área de transferência do sistema em plataformas compatíveis) e o conteúdo (abertura da saída capturada no $EDITOR para remover linhas sensíveis). Também é possível executar um shell interativo completo e capturar a sessão quando ele for encerrado.

O projeto ainda está em desenvolvimento. Muitas sequências ANSI são interpretadas, mas alguns tipos de saída e comandos que redefinem a posição do cursor podem não ser renderizados corretamente.

Recursos principais

  • 01Renderiza códigos reais de cor e formatação ANSI, em vez de aplicar realce de sintaxe.
  • 02Adiciona uma janela no estilo de terminal, com decoração, sombra, margem e espaçamento interno opcionais.
  • 03Permite editar a saída capturada no $EDITOR antes de gerar a imagem.
  • 04Pode capturar uma sessão completa de shell interativo.
  • 05Pode ser instalado pelo Homebrew ou por meio de binários pré-compilados para macOS e Linux.

Casos de uso

  • Criar capturas de tela da saída da CLI para posts de blog, documentação ou notas de versão.
  • Compartilhar a saída de comandos nas redes sociais ou em chats, removendo antes as linhas sensíveis.
  • Mostrar ferramentas coloridas, como figlet ou lolcat, com a estilização original.

Início rápido

  1. 1

    Instale com Homebrew no macOS ou Linux

    brew install homeport/tap/termshot
  2. 2

    Coloque termshot antes de qualquer comando para gerar out.png

    termshot ls -a

Antes de usar

  • O README informa que o projeto ainda está em desenvolvimento e que algumas sequências ANSI ou comandos que redefinem o cursor podem não ser renderizados corretamente.

Tópicos

#terminal#cli#screenshot#ansi-colors#shell#golang

Perguntas frequentes

O que é termshot?
Uma CLI que executa um comando no terminal e renderiza a saída colorida em ANSI como uma captura de tela PNG no estilo de uma janela. termshot executa um comando em um pseudo-terminal, captura a saída — incluindo códigos de cor e formatação ANSI — e a renderiza como uma imagem parecida com uma janela de terminal. Ao contrário de ferramentas que aplicam realce de sintaxe a texto colado, ele usa os códigos de escape emitidos pelo próprio comando. Assim, a saída de ferramentas como ls, figlet ou lolcat mantém as cores originais.
termshot é gratuito? Qual é a licença?
termshot é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
termshot ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de termshot foi em 15 de set. de 2026.
Para que posso usar termshot?
Criar capturas de tela da saída da CLI para posts de blog, documentação ou notas de versão. Compartilhar a saída de comandos nas redes sociais ou em chats, removendo antes as linhas sensíveis. Mostrar ferramentas coloridas, como figlet ou lolcat, com a estilização original.
Como instalar termshot?
Instale com Homebrew no macOS ou Linux: brew install homeport/tap/termshot Coloque termshot antes de qualquer comando para gerar out.png: termshot ls -a
Onde consigo termshot?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/homeport/termshot

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados