Documentação

## Install Bingsu

1. [Download Bingsu for Mac](https://bingsustudio.com/download/). It needs macOS 26 Tahoe or later.
2. Open `Bingsu.dmg` from your Downloads folder and drag Bingsu to Applications.
3. Open Bingsu. It lives in the menu bar, not the Dock.

With Homebrew instead:

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

To check the file before you open it, compare its SHA-256 with the one on the [download page](https://bingsustudio.com/download/#verify):

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

On Windows:

1. [Download Bingsu for Windows](https://bingsustudio.com/download/#windows). It needs Windows 10 (version 2004) or later.
2. Open `Bingsu.msix` from your Downloads folder and choose Install.
3. Open Bingsu from the Start menu.

On Linux:

1. [Download Bingsu for Linux](https://bingsustudio.com/download/#linux). It needs GNOME or KDE on Wayland with PipeWire; X11 works too.
2. Make the file runnable and open it:

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

1. Baixe o Bingsu para Mac. 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:

shasum -a 256 ~/Downloads/Bingsu.dmg

No Windows:

1. Baixe o Bingsu para 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. 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

## Allow screen recording

macOS asks once, the first time you record. Turn Bingsu on in System Settings, Privacy & Security, Screen & System Audio Recording, then reopen Bingsu.

The camera and the microphone are separate questions. macOS asks for each only when you first use it. Bingsu never turns either on by itself.

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.

## Record your screen

1. Click the Bingsu icon in the menu bar, or press ⌥⇧⌘R from anywhere.
2. Pick what to record: a screen, a window, an app or an area.
3. Press Record. Press Stop and Save when you are done.

Every file is checked after it is saved: its length, its picture, its sound tracks, silence, and whether a window closed. A problem shows as a warning on the recording.

Files go to `~/Movies/Bingsu`. Change the folder in Settings.

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.

## Pick a window, an app or an area

- **A window** keeps recording when other windows cover it, and takes only that app's sound.
- **An app** records all of its windows.
- **An area** records a fixed part of a screen. Drag to draw it.
- **A screen** records everything on that display.

A minimized window sends no picture. The recording repeats its last frame until you bring the window back.

• 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.

## Sound and microphones

A window or app recording takes that app's sound and nothing else. A screen recording takes the Mac's sound.

Add any number of microphones. Each shows a live level, gets its own track in the file, and goes into one mixed track that every player plays. If a microphone is unplugged, its track stays silent until you plug it back in, and the recording goes on.

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.

## Your camera and call guests

Choose a camera in the panel's Camera row. It sits over your recording as a bubble, and it is also saved as its own video track.

- Drag the bubble anywhere. Drag its corner to resize it.
- Make it a circle, a rounded square or wide, and mirror it from its toolbar.
- Right-click it to turn the camera off or hide it.

In Zoom, Meet, Teams, FaceTime, Slack, Discord, Webex or WhatsApp, Bingsu finds the people in the call window and adds each as a bubble, up to five faces. It can follow whoever speaks, or one person. Each guest's voice comes from the call app on its own track. Finding faces runs on your Mac; nothing about a face leaves it or is kept.

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.

## Pause, stop and the lock screen

- Pause and resume leave no gap in the file.
- Give a recording a length and it stops on the exact second.
- When the screen locks, Bingsu pauses and goes on when you sign back in. Change this in Settings.
- If the Mac crashes, Bingsu writes files in two-second pieces and recovers the half-written file the next time it opens.

• 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.

## Trim, cut and crop

Open a recording in the editor.

1. Drag the handles to trim the start and the end.
2. To cut a part out, mark it with I and O, then press X. ⌘Z undoes.
3. Crop to 16:9, 9:16, 1:1 or 4:3.
4. Save a copy as HEVC, H.264, ProRes, a GIF or sound only.

The original is never changed. Each edit saves a new file next to it, named "(edited)", "(1080p)" and so on.

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 and backgrounds

Focus and Frame are added when you save a copy, never baked into the original.

- **Focus** zooms in smoothly where you click and type and smooths the pointer. Every zoom shows on the timeline, where you can move, change or remove it.
- **Frame** puts a window or area on a background, with padding, rounded corners and a shadow.

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.

## Transcript, captions and chapters

Bingsu writes a transcript with times, using Apple's on-device speech model. Nothing is uploaded and nothing costs credits. On a Mac with Apple Intelligence it also writes a title, a short summary and chapters.

- Show captions on a share page, or burn them into a copy of the video.
- Cut the video by deleting words in the transcript.
- Every language your Mac supports works. macOS downloads a language's model the first time it is used.

Turn this off in Settings, General, "Understand recordings".

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”.

## Share a page

Bingsu turns a recording into a folder that is a whole website: a player, the title, chapters, the transcript and captions. You publish it where you already host sites. We never see the page, its link or its viewers.

| Host | Publish the folder with |
| --- | --- |
| 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 | Ask Codex in the ChatGPT app to publish the folder |

Preview the page on your Mac before you publish. The page offers no download of the video unless you turn it on. Anyone with the address can watch it, so keep the address to the people it is for.

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.

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.

## Connect an AI agent

Copy the connect prompt from [bingsustudio.com/agents](https://bingsustudio.com/agents/#connect) into your agent app: ChatGPT for Mac, Claude, Codex, Cursor, Grok Build and others. It adds Bingsu as a local MCP server, checks that it works and tells you what it can do. The same page lists the steps for each app by hand.

The first time an agent asks to record, Bingsu asks you in its own window. Settings, Agents lists every agent you allowed, with Revoke.

Copie o prompt de conexão de bingsustudio.com/agents 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.

## Ask an agent to record

Ask in your own words. For example:

- "Record this window while you run the tests, with sound off. When you are done, stop, check the file and tell me where it is."
- "Record the Settings window for 20 seconds, then make a share page from it and give me the folder."
- "Record my browser for 30 seconds at 60 fps, then save a GIF copy under 10 MB."

An agent checks the picture first with `bingsu_screenshot`, records with `bingsu_start`, and trusts a file only when its check says `ok`. Its recording shows in your menu bar with its name, and you can stop it at any time.

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.

## What an agent can do

| Tool | What it does |
| --- | --- |
| `bingsu_sources` | Lists displays, windows, apps, microphones and cameras, with ids |
| `bingsu_screenshot` | The exact picture a recording of a source would show |
| `bingsu_start` | Records a source; with `seconds` and `wait`, returns the saved, checked file |
| `bingsu_wait`, `bingsu_stop`, `bingsu_pause` | Waits for, stops or pauses the agent's own recording |
| `bingsu_status` | What is recording, room for more, free disk space |
| `bingsu_recordings`, `bingsu_verify` | Recent recordings and their checks; checks a file again |
| `bingsu_export` | A trimmed, cut, cropped or converted copy; never overwrites |
| `bingsu_understand` | Transcript, title, summary and chapters, made on the Mac |
| `bingsu_share_page` | A website folder for a recording, ready to publish |
| `bingsu_mark`, `bingsu_script`, `bingsu_presenter` | Named steps, a narration script, and a voice or presenter clip |

Every error has a stable `error` code, a `message` and a `fix`.

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

## Let several agents record at once

- Each agent records, stops and pauses only its own recordings. You see all of them in the menu bar and can stop any.
- An agent's window and app recordings take that app's sound without playing it on your speakers.
- Agents drive browsers with their own tools, never your pointer or keyboard.
- Bingsu never lowers quality to fit one more recording. When the encoders are full, an agent hears `busy` before it starts, or waits in line with `queue: true`.
- An agent that needs a whole screen can make its own virtual display with `bingsu display add`.

• 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.

## Camera and microphones for agents

Agents can't use the camera or microphones until you turn on "Can use the camera and microphones" in Settings, Agents. It is off at first. Without it, an agent that asks for one gets `devices_off`, and a recording never turns one on by itself.

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.

## Use the command line

The `bingsu` command does what the MCP tools do, with the same JSON answers.

```sh
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"
```

Exit code 3 means the file was saved but its check found a problem. Set `BINGSU_SESSION` to a value unique to your script, so its recordings stay its own.

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.

## Updates

Bingsu checks for updates once a day by downloading a small file that lists the latest version. The request tells the server your version and nothing else. Each update is signed, and Bingsu installs only an update whose signature matches. Turn the check off in Settings. With Homebrew, run `brew upgrade`.

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.

## Privacy

Recordings, transcripts and settings stay on your Mac. There is no account, no analytics, no crash reporting and no telemetry. An agent you connect sees what Bingsu returns to it, such as file paths, screenshots and transcripts, and its app may send that to its own servers under its own terms. Read the [privacy policy](https://bingsustudio.com/privacy/).

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.

## Fix a problem

| Error | What to do |
| --- | --- |
| `permission` | Allow Bingsu in System Settings, Privacy & Security, Screen & System Audio Recording |
| `sound_permission` | Allow it when macOS asks, or record with sound off |
| `device_permission` | Allow the camera or microphone in System Settings, Privacy & Security |
| `devices_off` | Turn on "Can use the camera and microphones" in Settings, Agents |
| `agents_off` | Turn scripts and agents back on in Settings, Agents |
| `not_found` | The window, app or recording is gone; the `fix` lists what exists |
| `disk_full` | Free some space; Bingsu needs 1 GB |
| `busy` | Stop a recording, or start with `queue: true` |
| `not_yours` | Leave the id out to act on your own recording |

Still stuck? [Open an issue on GitHub](https://github.com/PapayaSound/bingsu/issues).

Ainda com problema? Abra uma issue no GitHub.

## Uninstall

1. Quit Bingsu from its menu.
2. Drag Bingsu from Applications to the Trash.
3. Remove the command: `rm ~/.local/bin/bingsu`
4. Remove it from your agents, for example `claude mcp remove bingsu`.

Your recordings stay in `~/Movies/Bingsu` until you delete them.

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.