> Como instalar o Bingsu, gravar a tela, editar, compartilhar páginas e conectar o Claude, o ChatGPT, o Codex e outros agentes de IA. Uma página, todas as tarefas.

Source: https://docs.bingsustudio.com/pt-br/

# Documentação

1. [Instale o Bingsu](https://docs.bingsustudio.com/pt-br/#install-bingsu)
2. [Permitir a gravação de tela](https://docs.bingsustudio.com/pt-br/#allow-screen-recording)
3. [Gravar a tela](https://docs.bingsustudio.com/pt-br/#record-your-screen)
4. [Escolher uma janela, um app ou uma área](https://docs.bingsustudio.com/pt-br/#pick-a-window-an-app-or-an-area)
5. [Som e microfones](https://docs.bingsustudio.com/pt-br/#sound-and-microphones)
6. [Sua câmera e os convidados da chamada](https://docs.bingsustudio.com/pt-br/#your-camera-and-call-guests)
7. [Pausar, parar e a tela de bloqueio](https://docs.bingsustudio.com/pt-br/#pause-stop-and-the-lock-screen)
8. [Aparar, cortar e recortar](https://docs.bingsustudio.com/pt-br/#trim-cut-and-crop)
9. [Zoom e fundos](https://docs.bingsustudio.com/pt-br/#zoom-and-backgrounds)
10. [Transcrição, legendas e capítulos](https://docs.bingsustudio.com/pt-br/#transcript-captions-and-chapters)
11. [Compartilhar uma página](https://docs.bingsustudio.com/pt-br/#share-a-page)
12. [Conectar um agente de IA](https://docs.bingsustudio.com/pt-br/#connect-an-ai-agent)
13. [Pedir a um agente para gravar](https://docs.bingsustudio.com/pt-br/#ask-an-agent-to-record)
14. [O que um agente pode fazer](https://docs.bingsustudio.com/pt-br/#what-an-agent-can-do)
15. [Deixar vários agentes gravarem ao mesmo tempo](https://docs.bingsustudio.com/pt-br/#let-several-agents-record-at-once)
16. [Câmera e microfones para agentes](https://docs.bingsustudio.com/pt-br/#camera-and-microphones-for-agents)
17. [Usar a linha de comando](https://docs.bingsustudio.com/pt-br/#use-the-command-line)
18. [Atualizações](https://docs.bingsustudio.com/pt-br/#updates)
19. [Privacidade](https://docs.bingsustudio.com/pt-br/#privacy)
20. [Resolver um problema](https://docs.bingsustudio.com/pt-br/#fix-a-problem)
21. [Desinstalar](https://docs.bingsustudio.com/pt-br/#uninstall)

[Markdown](https://docs.bingsustudio.com/pt-br/index.md) [llms.txt](https://docs.bingsustudio.com/docs/llms.txt)

O Bingsu grava sua tela, sua câmera e suas chamadas no seu computador, e deixa que agentes de IA gravem o próprio trabalho. Cada tarefa abaixo pode ser copiada como prompt, para que seu agente faça por você.

## Instale o Bingsu

1. [Baixe o Bingsu para Mac](https://bingsustudio.com/download/). Ele precisa do macOS 26 Tahoe ou posterior.
2. Abra o `Bingsu.dmg` na pasta Downloads e arraste o Bingsu para Aplicativos.
3. Abra o Bingsu. Ele fica na barra de menus, não no Dock.

Ou com o Homebrew:

```
brew install --cask bingsu
```

Para conferir o arquivo antes de abrir, compare o SHA-256 dele com o da [página de download](https://bingsustudio.com/download/#verify):

```
shasum -a 256 ~/Downloads/Bingsu.dmg
```

No Windows:

1. [Baixe o Bingsu para Windows](https://bingsustudio.com/download/#windows). Ele precisa do Windows 10 (versão 2004) ou mais recente.
2. Abra `Bingsu.msix` na sua pasta Downloads e escolha Instalar.
3. Abra o Bingsu pelo menu Iniciar.

No Linux:

1. [Baixe o Bingsu para Linux](https://bingsustudio.com/download/#linux). Ele precisa do GNOME ou do KDE no Wayland com PipeWire; o X11 também funciona.
2. Torne o arquivo executável e abra:

```
chmod +x ~/Downloads/Bingsu.AppImage && ~/Downloads/Bingsu.AppImage
```

## Permitir a gravação de tela

O macOS pergunta uma vez, na primeira gravação. Ative o Bingsu em Ajustes do Sistema, Privacidade e Segurança, Gravação de Tela e Áudio do Sistema, e abra o Bingsu de novo.

A câmera e o microfone são perguntas separadas. O macOS pergunta sobre cada um só na primeira vez que você o usa. O Bingsu nunca liga nenhum dos dois sozinho.

## Gravar a tela

1. Clique no ícone do Bingsu na barra de menus, ou aperte ⌥⇧⌘R de qualquer lugar.
2. Escolha o que gravar: uma tela, uma janela, um app ou uma área.
3. Aperte Gravar. Quando terminar, aperte Parar e salvar.

Cada arquivo é verificado depois de salvo: a duração, a imagem, as faixas de som, os silêncios e se alguma janela fechou. Um problema aparece como aviso na gravação.

Os arquivos vão para `~/Movies/Bingsu`. Mude a pasta nos Ajustes.

## Escolher uma janela, um app ou uma área

- **Uma janela** continua sendo gravada quando outras a cobrem, e pega só o som daquele app.
- **Um app** grava todas as janelas dele.
- **Uma área** grava uma parte fixa de uma tela. Arraste para desenhá-la.
- **Uma tela** grava tudo o que aparece naquele monitor.

Uma janela minimizada não envia imagem. A gravação repete o último quadro até você trazer a janela de volta.

## Som e microfones

A gravação de uma janela ou de um app pega o som daquele app e nada mais. A gravação de uma tela pega o som do Mac.

Adicione quantos microfones quiser. Cada um mostra o nível ao vivo, ganha uma faixa própria no arquivo e entra numa faixa mixada que qualquer player toca. Se um microfone for desconectado, a faixa dele fica em silêncio até você conectar de novo, e a gravação continua.

## Sua câmera e os convidados da chamada

Escolha uma câmera na linha Câmera do painel. Ela fica sobre a gravação como uma bolha e também é salva numa faixa de vídeo própria.

- Arraste a bolha para qualquer lugar. Arraste o canto dela para mudar o tamanho.
- Deixe-a em círculo, quadrado arredondado ou larga, e espelhe-a pela barra de ferramentas dela.
- Clique nela com o botão direito para desligar a câmera ou escondê-la.

No Zoom, Meet, Teams, FaceTime, Slack, Discord, Webex ou WhatsApp, o Bingsu encontra as pessoas na janela da chamada e adiciona cada uma como uma bolha, até cinco rostos. Ele pode acompanhar quem estiver falando, ou uma pessoa só. A voz de cada convidado vem do app de chamada, numa faixa própria. A busca de rostos roda no seu Mac; nada sobre um rosto sai dele nem fica guardado.

## Pausar, parar e a tela de bloqueio

- Pausar e continuar não deixam buraco no arquivo.
- Defina uma duração para a gravação e ela para no segundo exato.
- Quando a tela bloqueia, o Bingsu pausa e continua quando você entra de novo. Mude isso nos Ajustes.
- Se o Mac travar, não tem problema: o Bingsu grava os arquivos em pedaços de dois segundos e recupera o arquivo pela metade na próxima vez que abrir.

## Aparar, cortar e recortar

Abra uma gravação no editor.

1. Arraste as alças para aparar o início e o fim.
2. Para cortar um trecho, marque-o com I e O e aperte X. ⌘Z desfaz.
3. Recorte em 16:9, 9:16, 1:1 ou 4:3.
4. Salve uma cópia em HEVC, H.264, ProRes, GIF ou só o som.

O original nunca muda. Cada edição salva um arquivo novo ao lado dele, com nomes como “(edited)”, “(1080p)” e assim por diante.

## Zoom e fundos

Foco e Moldura são aplicados quando você salva uma cópia, nunca gravados no original.

- **Foco** aproxima com suavidade onde você clica e digita, e suaviza o ponteiro. Cada zoom aparece na linha do tempo, onde você pode movê-lo, mudá-lo ou removê-lo.
- **Moldura** coloca uma janela ou área sobre um fundo, com margem, cantos arredondados e sombra.

## Transcrição, legendas e capítulos

O Bingsu escreve uma transcrição com marcações de tempo, usando o modelo de fala da Apple que roda no próprio aparelho. Nada é enviado e nada gasta créditos. Num Mac com Apple Intelligence, ele também escreve um título, um resumo curto e capítulos.

- Mostre legendas numa página para compartilhar, ou grave-as numa cópia do vídeo.
- Corte o vídeo apagando palavras na transcrição.
- Funciona com todos os idiomas que o seu Mac aceita. O macOS baixa o modelo de um idioma na primeira vez que ele é usado.

Desative isso em Ajustes, Geral, “Entender as gravações”.

## Compartilhar uma página

O Bingsu transforma uma gravação numa pasta que é um site inteiro: um player, o título, os capítulos, a transcrição e as legendas. Você publica onde já hospeda seus sites. Nós nunca vemos a página, o link dela nem quem assiste.

| Hospedagem | Publique a pasta com |
| --- | --- |
| Cloudflare Pages | `npx wrangler pages deploy <folder> --project-name <name>` |
| Vercel | `npx vercel deploy <folder> --prod --yes` |
| Netlify | `npx netlify-cli deploy --dir <folder> --prod` |
| GitHub Pages | `npx gh-pages --add -d <folder> -e <name>` |
| ChatGPT Sites | Peça ao Codex, no app do ChatGPT, para publicar a pasta |

Veja a prévia da página no seu Mac antes de publicar. A página só oferece o vídeo para baixar se você ativar essa opção. Quem tiver o endereço pode assistir, então mande o endereço só para quem deve ver.

## Conectar um agente de IA

Copie o prompt de conexão de [bingsustudio.com/agents](https://bingsustudio.com/agents/#connect) no app do seu agente: ChatGPT para Mac, Claude, Codex, Cursor, Grok Build e outros. Ele adiciona o Bingsu como servidor MCP local, confere se está funcionando e diz o que ele sabe fazer. A mesma página lista os passos manuais para cada app.

Na primeira vez que um agente pede para gravar, o Bingsu pergunta a você numa janela própria. Ajustes, Agentes lista todos os agentes que você autorizou, com a opção Revogar.

## Pedir a um agente para gravar

Peça com as suas palavras. Por exemplo:

- “Grave esta janela enquanto você roda os testes, sem som. Quando terminar, pare, verifique o arquivo e me diga onde ele está.”
- “Grave a janela de Ajustes por 20 segundos, depois crie uma página para compartilhar com a gravação e me passe a pasta.”
- “Grave o meu navegador por 30 segundos a 60 qps, depois salve uma cópia em GIF com menos de 10 MB.”

Um agente confere a imagem antes com `bingsu_screenshot`, grava com `bingsu_start` e só confia num arquivo quando a verificação diz `ok`. A gravação dele aparece na sua barra de menus com o nome dele, e você pode pará-la quando quiser.

## O que um agente pode fazer

| Ferramenta | O que faz |
| --- | --- |
| `bingsu_sources` | Lista telas, janelas, apps, microfones e câmeras, com ids |
| `bingsu_screenshot` | A imagem exata que a gravação de uma fonte mostraria |
| `bingsu_start` | Grava uma fonte; com `seconds` e `wait`, devolve o arquivo salvo e verificado |
| `bingsu_wait`, `bingsu_stop`, `bingsu_pause` | Espera, para ou pausa a gravação do próprio agente |
| `bingsu_status` | O que está gravando, se cabe mais, espaço livre em disco |
| `bingsu_recordings`, `bingsu_verify` | Gravações recentes e as verificações delas; verifica um arquivo de novo |
| `bingsu_export` | Uma cópia aparada, cortada, recortada ou convertida; nunca sobrescreve |
| `bingsu_understand` | Transcrição, título, resumo e capítulos, feitos no Mac |
| `bingsu_share_page` | Uma pasta de site para uma gravação, pronta para publicar |
| `bingsu_mark`, `bingsu_script`, `bingsu_presenter` | Passos com nome, um roteiro de narração e um trecho de voz ou de apresentador |

Todo erro tem um código `error` estável, um `message` e um `fix`.

## Deixar vários agentes gravarem ao mesmo tempo

- Cada agente grava, para e pausa só as próprias gravações. Você vê todas na barra de menus e pode parar qualquer uma.
- As gravações de janela e de app de um agente pegam o som daquele app sem tocá-lo nos seus alto-falantes.
- Os agentes controlam navegadores com as próprias ferramentas, nunca com o seu ponteiro ou o seu teclado.
- O Bingsu nunca baixa a qualidade para caber mais uma gravação. Quando os codificadores estão ocupados, o agente recebe `busy` antes de começar, ou espera na fila com `queue: true`.
- Um agente que precisa de uma tela inteira pode criar a própria tela virtual com `bingsu display add`.

## Câmera e microfones para agentes

Os agentes não podem usar a câmera nem os microfones até você ativar “Podem usar a câmera e os microfones” em Ajustes, Agentes. Essa opção começa desligada. Sem ela, um agente que pede um deles recebe `devices_off`, e uma gravação nunca liga nenhum sozinha.

## Usar a linha de comando

O comando `bingsu` faz o que as ferramentas MCP fazem, com as mesmas respostas em JSON.

```
bingsu record "Safari" --for 30s --json
bingsu edit <id> --start 3.5 --end 1:20 --format gif --max-mb 10
bingsu share-page <id> --title "Design review, new onboarding"
```

O código de saída 3 quer dizer que o arquivo foi salvo, mas a verificação achou um problema. Defina `BINGSU_SESSION` com um valor exclusivo do seu script, para que as gravações dele fiquem só dele.

## Atualizações

O Bingsu procura atualizações uma vez por dia baixando um arquivo pequeno que lista a versão mais recente. A requisição informa ao servidor a sua versão e nada mais. Cada atualização é assinada, e o Bingsu só instala uma atualização cuja assinatura confere. Desative a verificação nos Ajustes. Com o Homebrew, rode `brew upgrade`.

## Privacidade

Gravações, transcrições e ajustes ficam no seu Mac. Não há conta, analytics, relatórios de falhas nem telemetria. Um agente que você conecta vê o que o Bingsu devolve a ele, como caminhos de arquivos, capturas de tela e transcrições, e o app dele pode enviar isso aos próprios servidores, sob os próprios termos. Leia a [política de privacidade](https://bingsustudio.com/privacy/).

## Resolver um problema

| Erro | O que fazer |
| --- | --- |
| `permission` | Permita o Bingsu em Ajustes do Sistema, Privacidade e Segurança, Gravação de Tela e Áudio do Sistema |
| `sound_permission` | Permita quando o macOS perguntar, ou grave sem som |
| `device_permission` | Permita a câmera ou o microfone em Ajustes do Sistema, Privacidade e Segurança |
| `devices_off` | Ative “Podem usar a câmera e os microfones” em Ajustes, Agentes |
| `agents_off` | Ative de novo scripts e agentes em Ajustes, Agentes |
| `not_found` | A janela, o app ou a gravação não existe mais; o `fix` lista o que existe |
| `disk_full` | Libere espaço; o Bingsu precisa de 1 GB |
| `busy` | Pare uma gravação, ou comece com `queue: true` |
| `not_yours` | Deixe o id de fora para agir sobre a sua própria gravação |

Ainda com problema? [Abra uma issue no GitHub](https://github.com/bingsustudio/bingsu/issues).

## Desinstalar

1. Feche o Bingsu pelo menu dele.
2. Arraste o Bingsu de Aplicativos para o Lixo.
3. Remova o comando: `rm ~/.local/bin/bingsu`
4. Remova-o dos seus agentes, por exemplo `claude mcp remove bingsu`.

As suas gravações ficam em `~/Movies/Bingsu` até você apagá-las.

## Da próxima vez, *mostre*.

Grave uma vez e mande um link. Ou deixe o seu agente gravar.

[Baixar para](https://docs.bingsustudio.com/pt-br/download/#all) [Conecte seu agente](https://docs.bingsustudio.com/pt-br/agents/#connect)