Envie prints na hora com ShareX, Flameshot ou Greenshot

Tirar um print é instantâneo. Colocá-lo em algum lugar onde dê para compartilhar, normalmente, não é. Você salva o arquivo, abre uma aba do navegador, procura o botão de upload, espera terminar, copia o link e fecha a aba. Para quem tira print mais de algumas vezes por dia, esse intervalo entre a captura e o link compartilhável vira um atrito real. É exatamente o problema que as integrações de ferramentas de captura de tela do YourImageShare existem para eliminar.

ShareX, Flameshot e Greenshot estão entre as ferramentas de captura de tela mais usadas no Windows e no Linux, e as três permitem enviar a captura direto para um destino de upload personalizado assim que você a faz. Aponte qualquer uma delas para o YourImageShare e a aba do navegador sai do seu fluxo de vez: captura, envio, link copiado para a área de transferência e pronto.

ShareX (Windows)

O ShareX é provavelmente a ferramenta de captura de tela e gravação de vídeo mais completa do Windows, e o sistema de uploader personalizado dele foi feito sob medida para serviços como este. Um arquivo de configuração .sxcu pronto está disponível na página de documentação da API, em Screenshot Tools. Baixe o arquivo e, no ShareX, vá em Destinations, Custom uploader settings, Import, from file e abra o arquivo baixado. Substitua a chave de API de exemplo no campo Headers pela sua chave real e defina esse uploader como destino ativo de imagens e arquivos. A partir daí, toda captura é enviada automaticamente assim que você a faz, e o link direto fica copiado na área de transferência, pronto para colar.

Um detalhe importante: o atalho de exclusão embutido do ShareX não está ligado nesta configuração, porque ele espera uma solicitação de exclusão simples, baseada em link, e o endpoint de exclusão desta API é uma requisição autenticada de verdade. Para apagar um arquivo enviado pelo ShareX, basta entrar em Minha conta em yourimageshare.com ou chamar diretamente o endpoint de exclusão, se você já estiver à vontade com a API.

Flameshot (Linux)

O Flameshot é a ferramenta de captura padrão em muitos desktops Linux e, embora não tenha uploaders personalizados nativos como o ShareX, um pequeno script de shell cumpre o mesmo papel. O script executa flameshot gui para você selecionar uma área, envia o resultado e copia o link retornado para a área de transferência usando a ferramenta de clipboard disponível no seu sistema, com alternativa caso alguma esteja ausente. A configuração é feita uma única vez: baixe o script, torne-o executável e defina sua chave de API como variável de ambiente ou em um arquivo de configuração. Depois, associe o script ao atalho de teclado que você já usa para o Flameshot, e cada captura passa a ser captura e envio em um só toque.

Flameshot enviando para o Imgur? Envie para outro lugar

O Flameshot tem um botão de upload, mas ele só conhece um destino: o Imgur. Se o envio do Flameshot para o Imgur falha, ou você prefere não colocar prints de trabalho em um site de comunidade, o script acima resolve. Ele mantém as ferramentas de captura e anotação do Flameshot exatamente como estão e substitui apenas a última etapa, de modo que o print vai para a sua própria conta no YourImageShare e o link cai na sua área de transferência. Os arquivos enviados assim não entram em nenhum feed público, e você pode listá-los ou apagá-los depois com a mesma chave de API. Para ver as diferenças em mais detalhes, confira a comparação de alternativa ao Imgur.

Greenshot (Windows)

O Greenshot é uma alternativa mais leve e simples ao ShareX, que muita gente prefere justamente por não atrapalhar. Ele aceita destinos de comando externo, e um script em PowerShell cuida do envio, escrito para a versão do PowerShell que já vem com o Windows, então não há nada extra para instalar. A configuração consiste em fazer o destino External command do Greenshot executar o PowerShell com o script como argumento e definir sua chave de API uma vez como variável de ambiente. Depois disso, o fluxo normal de captura do Greenshot funciona como sempre, com o envio acontecendo em segundo plano, sem alarde.

Por que se dar ao trabalho em vez de arrastar o arquivo para uma aba do navegador

A resposta sincera é velocidade e hábito. Se você tira print algumas vezes por semana, uma aba do navegador resolve. Se tira dezenas por dia, seja para documentar bugs para uma equipe de desenvolvimento, para mandar algo a um colega ou para montar uma base de conhecimento cheia de prints anotados, a aba do navegador vira a parte mais lenta de uma ação que seria instantânea. Ligar o envio direto à ferramenta que você já usa para capturar elimina uma etapa manual inteira e, depois de configurado, fica configurado. Não há manutenção contínua, nem tela de login para atravessar, nem nada para lembrar além do atalho de teclado que você já conhece.

O que acontece com o arquivo depois do envio

Tudo que é enviado por uma dessas integrações se comporta exatamente como um envio normal feito pelo site: ganha um link direto do arquivo, um link de página com opções de compartilhamento, uma tag HTML para incorporar e um link BBCode para fóruns, tudo gerado automaticamente. Se um print só precisa existir por pouco tempo, como um relatório de bug pontual ou um anexo temporário de suporte, o mesmo recurso de envios com expiração disponível pela API pode ser aplicado, e o arquivo e sua página somem sozinhos após um tempo definido, sem exigir limpeza manual depois. Os detalhes completos sobre como funciona a expiração estão na referência da API.

Criando sua própria integração

ShareX, Flameshot e Greenshot cobrem as ferramentas de captura mais comuns, mas o mecanismo por trás é sempre a mesma API de upload documentada em yourimageshare.com/about/api. Qualquer ferramenta que consiga executar um script ou fazer uma requisição HTTP a partir de um atalho de teclado pode ser configurada do mesmo jeito. Existem bibliotecas oficiais para JavaScript e Python, caso você prefira escrever um pequeno script a lidar com comandos curl puros, e as duas cuidam do upload multipart e da leitura de erros por você, sem que seja preciso construir tudo do zero.

Primeiros passos

Os três downloads, junto com os passos exatos de configuração de cada um, estão na página de documentação da API, em Screenshot Tools. Primeiro você precisa de uma chave de API, que leva menos de um minuto para gerar em Minha conta depois de entrar em yourimageshare.com. Sem cartão de crédito, sem período de teste: o plano grátis é generoso o bastante para o hábito diário de tirar prints caber nele com folga.

Acertando o campo da chave de API de primeira

O erro de configuração mais comum nessas três ferramentas é um espaço sobrando ou uma colagem incompleta ao substituir a chave de API de exemplo, o que gera um erro de autenticação confuso logo na primeira captura, sem nada que aponte claramente para a causa real. Depois de configurar qualquer uma das três, faça uma captura na hora e confirme que aparece um link real e funcional, copiado para a área de transferência ou visível no histórico da própria ferramenta. Se falhar, o campo da chave de API é a primeira coisa a conferir; em seguida, verifique se a chave ainda é válida na aba API em Minha conta em yourimageshare.com, já que gerar uma nova chave invalida imediatamente a anterior.

Usando outra ferramenta de captura de tela

ShareX, Flameshot e Greenshot cobrem as configurações mais comuns no Windows e no Linux, mas não são as únicas ferramentas de captura que aceitam destinos de upload personalizados. Qualquer uma que consiga executar um script ou enviar uma requisição HTTP depois da captura pode ser apontada para o mesmo endpoint de upload. Os requisitos são simples: um POST para /api, o arquivo enviado como multipart form data em um campo chamado uploads e sua chave de API como header ou parâmetro de consulta. Se a sua ferramenta preferida aceitar um comando personalizado ou webhook após a captura, o mesmo padrão dos scripts do Flameshot e do Greenshot, que lê o caminho de um arquivo e o envia, se adapta direto. Os detalhes campo a campo estão na página de documentação da API.

Usuários de Mac

Nenhuma das três ferramentas abordadas aqui roda nativamente no macOS, mas a mesma ideia funciona com o fluxo de captura que você já usa, geralmente uma pequena automação do Atalhos ou um script associado a um atalho de teclado com launchd ou um utilitário da barra de menus. O script de shell do Flameshot é um bom modelo inicial mesmo fora do Linux, já que a etapa de envio, uma requisição curl com o arquivo anexado, funciona do mesmo jeito no macOS. Trocar a etapa de cópia para usar pbcopy no lugar das ferramentas de clipboard do Linux costuma ser a única mudança necessária.

Como é, de fato, um bom fluxo de captura de tela

Vale ser específico sobre o que "instantâneo" significa aqui, já que a palavra costuma ser usada sem muito critério. Com qualquer uma dessas três integrações bem configurada, a sequência completa, de apertar o atalho de captura até ter um link funcional na área de transferência, é uma única ação ininterrupta: você seleciona a área, solta o mouse e o link já está lá, esperando para ser colado. Não há janela intermediária para salvar, nem pasta para lembrar, nem janela de navegador para abrir. Esse detalhe, reduzir a zero as etapas entre a captura e o link compartilhável, é o ponto central, e também o motivo de tanta gente que configura uma dessas opções nunca mais voltar ao jeito antigo.

Para quem documenta bugs como parte do trabalho, isso rende mais do que parece. Alguns prints por dia, cada um economizando ao menos trinta segundos em relação à antiga rotina de salvar e enviar, representam tempo de verdade recuperado ao longo da semana de trabalho, sem mudar mais nada na forma como você trabalha.

Mantendo os prints organizados quando há muitos

Quando enviar fica tão fácil, o número de prints tende a crescer rápido, o que levanta uma dúvida justa: algo se perde no meio disso? Todo arquivo enviado, seja pelo site, por um script ou por uma dessas ferramentas, aparece listado em Minha conta em yourimageshare.com, do mais recente para o mais antigo, com um título e uma descrição que você pode adicionar depois, caso valha a pena acompanhar determinado print. O que só é necessário por pouco tempo pode receber uma expiração no momento do envio, assim capturas antigas e sem utilidade não precisam ser removidas manualmente depois.

Uma chave, várias máquinas

Se o seu fluxo de capturas passa por mais de um computador, como um notebook do trabalho e um desktop pessoal, a mesma chave de API pode ser usada nos dois sem conflito. Os envios de qualquer máquina caem na mesma conta e aparecem juntos em Minha conta, então não é preciso gerar uma chave por dispositivo, a menos que você queira acompanhar o uso separadamente ou pretenda revogar o acesso de uma máquina de forma independente mais tarde.

Reserve os dez minutos necessários para configurar a ferramenta que combina com o seu ambiente, e o benefício se acumula a cada print tirado daí em diante, enquanto a ferramenta estiver instalada.

Se prints não são o principal tipo de arquivo que você envia, outro post deste blog explica como automatizar envios diretamente pela API para scripts, bots e pipelines de build, e outro mostra como adicionar um botão de upload de verdade a softwares de fórum como phpBB, SMF e MyBB, para quem administra uma comunidade e não apenas envia arquivos para uso próprio.

De qualquer forma, o objetivo é o mesmo em que todo o YourImageShare se baseia: deixar o arquivo hospedado e o link na sua mão o mais rápido possível, com o mínimo de etapas no meio.

Configure uma dessas opções uma vez e o hábito se firma sozinho, já que o caminho mais rápido também é simplesmente o mais fácil de continuar usando.

Só precisa compartilhar um print, sem instalar nada? Leve-o para a área de transferência e cole a imagem na nossa página de colar para receber um link. Prefere uma extensão de navegador a um aplicativo de computador? O YourImageShare Capture para Firefox faz o mesmo - capturar, anotar e publicar - sem sair do navegador.