Instalar · Capturar · Anotar · Exportar

# Documentação

Como instalar e usar o OpenScreenShot, a extensão de código aberto de captura de tela e anotações para Chrome.

## Nesta página

- [Instalar](https://openscreenshot.app/pt-br/docs/#install)
- [Fazer uma captura de tela](https://openscreenshot.app/pt-br/docs/#capture)
- [Modos de captura](https://openscreenshot.app/pt-br/docs/#modes)
- [Depois de uma captura](https://openscreenshot.app/pt-br/docs/#after-capture)
- [Anotar](https://openscreenshot.app/pt-br/docs/#annotate)
- [Beautify](https://openscreenshot.app/pt-br/docs/#beautify)
- [Anotar uma imagem que você já tem](https://openscreenshot.app/pt-br/docs/#import)
- [Exportar](https://openscreenshot.app/pt-br/docs/#export)
- [Gravar uma aba](https://openscreenshot.app/pt-br/docs/#record)
- [Rascunhos](https://openscreenshot.app/pt-br/docs/#drafts)
- [Atalhos de teclado](https://openscreenshot.app/pt-br/docs/#shortcuts)
- [Configurações](https://openscreenshot.app/pt-br/docs/#settings)
- [Agentes e CLI](https://openscreenshot.app/pt-br/docs/#agents-cli)
- [Privacidade](https://openscreenshot.app/pt-br/docs/#privacy)
- [Obter ajuda](https://openscreenshot.app/pt-br/docs/#support)

## Instalar

O OpenScreenShot está disponível na Chrome Web Store.

1. Abra a [página do OpenScreenShot](https://chromewebstore.google.com/detail/hdabbojjccojlapnfjpdppcpfcnhgmdp) no Chrome.
2. Clique em **Usar no Chrome**.
3. Aceite as permissões. A extensão precisa da aba ativa e de permissão para executar o script de captura nela.
4. O ícone do OpenScreenShot aparece na barra de ferramentas. Clique nele para abrir o popup.

## Fazer uma captura de tela

Clique no ícone do OpenScreenShot na barra de ferramentas e a captura de página inteira começa — sem menu no caminho. Tudo roda localmente no seu navegador. Há quatro formas de iniciar uma captura:

- **O ícone da barra de ferramentas** — um clique captura a página inteira. Desative **Modo Express de um clique** nas configurações para recuperar o seletor de modos; o clique direito no ícone traz os outros modos e as configurações.
- **Um atalho de teclado** — `Ctrl+Shift+S` para a página inteira, `Alt+Shift+V` para a área visível, `Ctrl+Shift+E` para uma região. No macOS são `⌘⇧S`, `⌥⇧V` e `⌘⇧E`. Capturar elemento não tem tecla padrão. Defina ou altere qualquer um deles em `chrome://extensions/shortcuts`.
- **O menu de contexto** — o submenu do OpenScreenShot em qualquer página oferece os mesmos quatro modos e as Configurações.
- **Repetir região** — o rodapé do popup e o menu do botão direito recapturam o último retângulo de região. Os dois itens aparecem depois que você seleciona uma região.

A linha **Atraso** no popup segura a captura por 3, 5 ou 10 segundos, e o selo na barra de ferramentas faz a contagem regressiva. Use para estados de hover, menus suspensos e tooltips que fecham no momento em que você clica em outro lugar.

## Modos de captura

### Página inteira

Captura toda a página com rolagem e a costura em uma única imagem. A extensão rola a página janela por janela, captura cada bloco e os compõe juntos. Cabeçalhos fixos são capturados no primeiro bloco e compostos uma única vez no topo. Páginas que rolam um elemento interno em vez da janela também funcionam. Uma página mais alta do que uma imagem (32.000 pixels de dispositivo) é salva em até seis imagens: com Baixar, cada parte recebe um nome; com Editor ou Copiar, cada parte abre na própria aba do editor.

### Área visível

Captura a área visível atual na hora. Sem rolagem. Use para uma captura rápida do que está na tela agora.

### Região selecionada

Clique e arraste para desenhar um retângulo. Alças de redimensionamento aparecem em cada borda e canto. Use as teclas de seta para mover a seleção um pixel por vez, ou segure `Shift` para mover dez pixels por vez. Pressione `Enter` para confirmar ou `Esc` para cancelar.

### Elemento

Passe o cursor sobre a página para selecionar um cartão, gráfico, tabela, imagem ou outro elemento, depois clique ou pressione `Enter` para capturar exatamente os limites dele. `↑` seleciona o elemento pai, `↓` o filho, e `←`/`→` os vizinhos. Se o elemento não estiver totalmente visível, o seletor oferece uma captura de página inteira.

## Depois de uma captura

A linha **Após capturar** no popup escolhe o que uma captura concluída faz. Vale para todos os pontos de entrada: os botões do popup, os atalhos de teclado e o menu do botão direito.

- **Editor** — abre o editor de anotações em uma nova aba. Este é o padrão.
- **Copiar** — copia a captura e pula o editor. Cole direto em um chat, um documento ou uma issue.
- **Baixar** — salva a captura na sua pasta de downloads e pula o editor. Os salvamentos rápidos saem em PNG.

Copiar e Baixar não abrem aba, então o selo na barra de ferramentas é a confirmação. Uma captura com falha pisca `!` no selo. **Reabrir última** no rodapé do popup abre a captura mais recente no editor a qualquer momento.

## Anotar

O editor abre em uma aba inteira e carrega a captura mais recente do armazenamento local. Cada ferramenta tem um atalho de uma letra.

- **Selecionar** `V` — mova, redimensione ou exclua qualquer anotação. Clique duas vezes em uma camada de texto para editá-la de novo.
- **Forma** `R` — desenha um retângulo, retângulo arredondado, elipse ou triângulo. **Preenchimento** define nenhum preenchimento ou um preenchimento sólido na cor do traço; segure `Shift` para lados iguais, e a elipse vira um círculo.
- **Seta** `A` — desenha uma seta direcional com ponta preenchida, aberta, dupla ou em ponto. Arraste a alça redonda do meio para curvá-la.
- **Linha** `L` — a seta sem ponta.
- **Caneta** `P` — desenho à mão livre.
- **Marca-texto** `H` — um traço translúcido à mão livre.
- **Texto** `T` — adiciona uma caixa de texto, com tamanho definido pelo controle de fonte.
- **Número do passo** `S` — números que contam sozinhos e se renumeram quando você exclui um.
- **Desfoque** `B` — oculta conteúdo sensível como desfoque suave, mosaico grosso ou preenchimento opaco. O preenchimento opaco sobrevive à recompressão.
- **Spotlight** `O` — recortes em retângulo, retângulo arredondado ou elipse que se fundem em uma única camada escurecida.
- **Conta-gotas** `I` — pega uma cor da captura. Ele amostra o que você vê, então uma cor dentro de um spotlight ou em um gradiente do Beautify é capturada como aparece. O botão de amostra na linha de cores abre o seletor de tela inteira do Chrome para qualquer coisa fora do canvas.
- **Recortar** `C` — apara a imagem para uma área selecionada.
- **Cut** `X` — marca faixas horizontais em uma captura longa e as remove, com prévia ao vivo.

Segure `Shift` enquanto desenha para formas com lados iguais e linhas e setas a 45°. A barra de estilo traz uma paleta de 8 cores em `1`–`8`, uma cor personalizada, cores recentes, quatro espessuras de traço que se ajustam ao tamanho da captura e um controle de tamanho de fonte. Suas escolhas são lembradas entre sessões. Arraste as ferramentas na barra lateral para colocar suas favoritas primeiro, ou mova a ferramenta em foco com `Alt+↑` / `Alt+↓`. Desfazer e refazer são `Ctrl+Z` / `Ctrl+Shift+Z`, ou `⌘Z` / `⌘⇧Z` no macOS.

## Beautify

O painel **Beautify** na barra superior emoldura a captura para compartilhar: um **Estilo**, mais os controles **Margem interna**, **Cantos** e **Sombra** e um **Fundo** com seis gradientes, uma cor sólida personalizada ou transparência. O quadro tem prévia ao vivo e acompanha todas as exportações, a área de transferência e o PDF.

## Anotar uma imagem que você já tem

Solte um arquivo de imagem sobre a área do editor, ou cole um com `Ctrl+V` / `⌘V` fora de um campo de texto. A importação ocupa o mesmo lugar de uma captura, então todas as ferramentas, o quadro Beautify e todos os caminhos de exportação continuam funcionando, e a barra superior mostra **Importada**. Importar substitui a tela, então o editor pergunta antes quando há anotações a perder.

## Exportar

Clique em **Salvar imagem** na barra superior do editor, ou pressione `Ctrl+S` / `⌘S`, para abrir o diálogo **Exportar**. Ao lado, **Copiar** coloca um PNG na área de transferência e **PDF** salva um PDF com um clique. No diálogo, escolha um formato:

- **PNG** — sem perdas, mantém a transparência.
- **JPEG** — arquivos menores, qualidade ajustável.
- **WebP** — qualidade ajustável como JPEG, transparência como PNG.
- **PDF** — exporte como uma única página de imagem, ajustada a A4/Letter, ou dividida em várias páginas com sobreposição de 5 mm para o conteúdo não ser cortado no meio de uma linha.

**Escala** exporta a 25, 50, 100 ou 200%, ou em uma largura exata em pixels. Fica oculta para PDF, que se ajusta à página. Um tamanho acima do limite de canvas do Chrome é recusado em vez de gravado como um arquivo vazio.

`Ctrl+C` / `⌘C` copia a imagem final direto para a área de transferência. O diálogo de exportação também pode salvar as configurações atuais como seus novos padrões.

## Gravar uma aba

A gravação de abas está disponível na versão para Chrome; a versão para Firefox por enquanto só faz capturas de tela. Clique em **Gravar** no pop-up para abrir a aba de gravação ao lado da sua página. Durante uma gravação, pressione `Alt+Shift+X` para pará-la de qualquer aba. Na primeira gravação, o Chrome mostra um pedido de permissão para capturar a aba.

### Iniciar uma gravação

A aba de gravação mostra uma imagem da sua página e a imagem ao vivo da sua câmera. Ative ali **Mic**, **Som da aba** ou **Webcam**; o pedido de permissão do navegador aparece nessa aba. Arraste sobre a imagem para gravar só uma parte da página, ou mantenha **Aba inteira**. Clique em **Iniciar gravação** e o OpenScreenShot muda para a sua página.

Se uma gravação navegar para outro site, o registro de cliques precisa da permissão opcional “Gravar em todos os sites” (veja [Configurações](https://openscreenshot.app/pt-br/docs/#settings)) para acompanhá-la. Sem ela, o selo da barra de ferramentas fica âmbar, e o zoom e os efeitos de clique param no resto do vídeo. O vídeo continua sendo gravado.

### A aba de gravação

Durante a gravação, a aba de gravação mostra um cronômetro e os botões Pausar/Retomar, Parar e Cancelar. Nada é adicionado à página gravada, então nenhum controle aparece no vídeo. Volte à aba para parar, ou pressione `Alt+Shift+X`. Ao parar, a mesma aba abre o editor.

A webcam entra na exportação como uma bolha redonda que você posiciona no editor, e o editor corta o vídeo para a área escolhida.

### O editor

Parar abre o editor de gravação com a sua tomada em uma linha do tempo. O editor adiciona um zoom suave de 2x a cada clique do seu cursor — ajuste ou exclua qualquer um deles, ou adicione seus próprios blocos de zoom manuais em 1,5x, 2x ou 3x. Apare o início ou o fim de qualquer segmento arrastando as alças. Ondas de clique marcam onde você clicou, e a bolha da webcam, o quadro Beautify e os controles de volume do mic e da aba ficam no painel lateral. Mostrar cursor desenha um ponteiro suave que segue o trajeto gravado do seu cursor; desative nas configurações.

### Exportar

Exportar renderiza a tomada de novo via canvas, misturando as trilhas e os efeitos que você definiu, e baixa um arquivo MP4 (H.264 e AAC) por padrão, ou WebM pelo seletor ao lado do botão. O MP4 é limitado a 4096×2304, então uma aba maior é reduzida para caber. Navegadores sem gravação em MP4 exportam apenas WebM.

## Rascunhos

Suas edições são salvas localmente enquanto você trabalha. Se a aba do editor fechar ou travar, a próxima aba do editor oferece o rascunho de volta. Restaurar é sempre um clique, então um rascunho antigo nunca substitui uma captura que você quis começar do zero. Uma imagem recortada ganha o próprio rascunho, então as anotações nunca são restauradas sobre a imagem errada.

## Atalhos de teclado

Pressione `?` no editor para a folha completa. Além das letras das ferramentas acima:

- `1`–`8` — definem a cor da anotação.
- `Ctrl+C` / `⌘C` — copia para a área de transferência.
- `Ctrl+S` / `⌘S` — exporta.
- `Backspace` — exclui a anotação selecionada.
- `Esc` — limpa a seleção, ou cancela um recorte.
- `Ctrl` / `⌘` com `+`, `−` ou `0` — aproxima, afasta, tamanho real. `F` ajusta à tela.
- `Espaço` + arrastar — desloca o canvas.

`Alt+Shift+X` interrompe a gravação atual de qualquer lugar — não precisa do editor nem do popup abertos.

## Configurações

Abra o ícone de engrenagem no popup para definir:

- **Tema** — claro, escuro ou sistema.
- **Formato padrão** — PNG, JPEG, WebP ou PDF.
- **Qualidade** — para JPEG, WebP e PDF.
- **Modelo de nome de arquivo** — clique em um chip de token para inserir `{date}`, `{time}`, `{title}`, `{domain}`, `{w}` ou `{h}`. Uma prévia ao vivo mostra o resultado. Com `/`, o arquivo é salvo em uma pasta dentro de Downloads, por exemplo `Screenshots/{title}`.

As configurações ficam no armazenamento local deste dispositivo. **Restaurar padrões** no fim do painel pede dois cliques.

**Gravar em todos os sites** — desativado por padrão. Ativar pede a permissão de host opcional `<all_urls>`, para que o registro de cliques acompanhe uma aba que navega para outro site durante a gravação.

## Agentes e CLI

`openscreenshot` (npm) é uma ferramenta local, separada e opcional para automatizar capturas pela linha de comando ou por um agente de IA. Ela usa o Chrome que já está no seu computador — sem download de navegador, sem serviço hospedado. Defina `CHROME_PATH` se o seu Chrome não for encontrado automaticamente.

```
pnpm dlx openscreenshot shot https://example.com --out shot.png --full
```

Como servidor MCP, adicione isto à configuração do seu cliente MCP:

```
{ "command": "pnpm", "args": ["dlx", "openscreenshot"] }
```

Depois chame a ferramenta `capture_screenshot` com `{ "url": "https://example.com" }`. As entradas opcionais são `fullPage` (padrão false), `width` (200–3840, padrão 1280), `height` (200–2160, padrão 800) e `redact`, que cobre com tarjas pretas, antes da captura, `selectors` CSS, `patterns` de texto (`email`, `phone`, `secret`) e `rects` em pixels. A ferramenta retorna o conteúdo de uma imagem PNG ao seu cliente. Um cliente que usa um modelo hospedado pode enviar essa imagem ao provedor dele; use `redact` para dados que não podem sair do dispositivo e revise as configurações de dados do cliente.

## Privacidade

O OpenScreenShot processa tudo localmente no seu navegador. As capturas ficam no armazenamento local do Chrome e não são enviadas a nenhum servidor. Gravações, registros do cursor e streams de mic/webcam ficam no IndexedDB do seu dispositivo até você excluí-los. A extensão não tem análise de uso, telemetria nem serviços de terceiros.

Veja a [Política de Privacidade](https://openscreenshot.app/pt-br/privacy/) para todos os detalhes.

## Obter ajuda

Veja a página de [Suporte e FAQ](https://openscreenshot.app/pt-br/support/) para perguntas comuns e limitações conhecidas. Se precisar de mais ajuda, abra uma issue no [GitHub](https://github.com/pghqdev/OpenScreenShot/issues).

## Instale o OpenScreenShot

Grátis, de código aberto e privado. Disponível na Chrome Web Store.

[Adicionar ao Chrome](https://chromewebstore.google.com/detail/hdabbojjccojlapnfjpdppcpfcnhgmdp) [Adicionar ao Firefox](https://addons.mozilla.org/firefox/addon/openscreenshot/)

---

Canonical page: https://openscreenshot.app/pt-br/docs/