Documentación

## 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. Descarga Bingsu para Mac. Necesita macOS 26 Tahoe o posterior.
2. Abre Bingsu.dmg desde tu carpeta Descargas y arrastra Bingsu a Aplicaciones.
3. Abre Bingsu. Vive en la barra de menús, no en el Dock.

Con Homebrew:

brew install --cask bingsu

Para verificar el archivo antes de abrirlo, compara su SHA-256 con el de la página de descarga:

shasum -a 256 ~/Downloads/Bingsu.dmg

En Windows:

1. Descarga Bingsu para Windows. Necesita Windows 10 (versión 2004) o posterior.
2. Abre Bingsu.msix desde tu carpeta Descargas y elige Instalar.
3. Abre Bingsu desde el menú Inicio.

En Linux:

1. Descarga Bingsu para Linux. Necesita GNOME o KDE en Wayland con PipeWire; también funciona con X11.
2. Haz que el archivo sea ejecutable y ábrelo:

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.

macOS lo pregunta una vez, la primera vez que grabas. Activa Bingsu en Ajustes del Sistema, Privacidad y seguridad, Grabación de pantalla y audio del sistema, y vuelve a abrir Bingsu.

La cámara y el micrófono son preguntas aparte. macOS pide permiso para cada uno solo la primera vez que lo usas. Bingsu nunca activa ninguno por su cuenta.

## 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. Haz clic en el icono de Bingsu en la barra de menús o pulsa ⌥⇧⌘R desde cualquier lugar.
2. Elige qué grabar: una pantalla, una ventana, una app o un área.
3. Pulsa «Record». Pulsa «Stop and Save» cuando termines.

Cada archivo se verifica después de guardarlo: su duración, su imagen, sus pistas de sonido, los silencios y si se cerró alguna ventana. Si hay un problema, aparece como aviso en la grabación.

Los archivos van a ~/Movies/Bingsu. Cambia la carpeta en «Settings».

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

• Una ventana se sigue grabando cuando otras ventanas la tapan, y toma solo el sonido de esa app.
• Una app graba todas sus ventanas.
• Un área graba una parte fija de una pantalla. Arrastra para dibujarla.
• Una pantalla graba todo lo que hay en ese monitor.

Una ventana minimizada no envía imagen. La grabación repite su último fotograma hasta que vuelves a mostrar la ventana.

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

Una grabación de ventana o de app toma el sonido de esa app y nada más. Una grabación de pantalla toma el sonido del Mac.

Añade cualquier número de micrófonos. Cada uno muestra su nivel en directo, tiene su propia pista en el archivo y entra en una pista mezclada que reproduce cualquier reproductor. Si desconectas un micrófono, su pista queda en silencio hasta que lo vuelvas a conectar, y la grabación continúa.

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

Elige una cámara en la fila «Camera» del panel. Aparece sobre tu grabación como una burbuja y también se guarda como su propia pista de vídeo.

• Arrastra la burbuja a cualquier sitio. Arrastra su esquina para cambiar el tamaño.
• Hazla circular, cuadrada con esquinas redondeadas o panorámica, y ponla en espejo desde su barra de herramientas.
• Haz clic derecho en ella para apagar la cámara u ocultarla.

En Zoom, Meet, Teams, FaceTime, Slack, Discord, Webex o WhatsApp, Bingsu encuentra a las personas en la ventana de la llamada y añade a cada una como burbuja, hasta cinco caras. Puede seguir a quien hable o a una sola persona. La voz de cada invitado sale de la app de llamadas en su propia pista. La detección de caras se hace en tu Mac; nada de una cara sale de él ni se guarda.

## 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 y reanudar no deja huecos en el archivo.
• Ponle una duración a una grabación y se detiene en el segundo exacto.
• Cuando se bloquea la pantalla, Bingsu pausa y continúa cuando vuelves a iniciar sesión. Cámbialo en «Settings».
• Por si el Mac falla, Bingsu escribe los archivos en fragmentos de dos segundos y recupera el archivo a medio escribir la próxima vez que se abre.

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

Abre una grabación en el editor.

1. Arrastra los tiradores para recortar el principio y el final.
2. Para quitar una parte, márcala con I y O y pulsa X. ⌘Z deshace.
3. Encuadra a 16:9, 9:16, 1:1 o 4:3.
4. Guarda una copia en HEVC, H.264, ProRes, GIF o solo sonido.

El original nunca cambia. Cada edición guarda un archivo nuevo a su lado, llamado «(edited)», «(1080p)», etc.

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

Enfoque y Marco se añaden al guardar una copia, nunca se aplican al original.

• Enfoque hace zoom suavemente donde haces clic y escribes, y suaviza el puntero. Cada zoom aparece en la línea de tiempo, donde puedes moverlo, cambiarlo o quitarlo.
• Marco coloca una ventana o un área sobre un fondo, con márgenes, esquinas redondeadas y 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".

Bingsu escribe una transcripción con marcas de tiempo usando el modelo de voz de Apple en el dispositivo. No se sube nada y nada consume créditos. En un Mac con Apple Intelligence también escribe un título, un resumen breve y capítulos.

• Muestra subtítulos en una página para compartir o incrústalos en una copia del vídeo.
• Corta el vídeo borrando palabras de la transcripción.
• Funcionan todos los idiomas que admite tu Mac. macOS descarga el modelo de un idioma la primera vez que se usa.

Desactívalo en «Settings», «General», «Understand recordings».

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

Bingsu convierte una grabación en una carpeta que es un sitio web completo: un reproductor, el título, los capítulos, la transcripción y los subtítulos. Lo publicas donde ya alojas tus sitios. Nunca vemos la página, su enlace ni quién la ve.

Previsualiza la página en tu Mac antes de publicarla. La página no ofrece descargar el vídeo a menos que lo actives. Cualquiera que tenga la dirección puede verlo, así que compártela solo con las personas a las que va dirigida.

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

Copia el prompt de conexión de bingsustudio.com/agents en tu app de agente: ChatGPT para Mac, Claude, Codex, Cursor, Grok Build y otras. Añade Bingsu como servidor MCP local, comprueba que funciona y te cuenta lo que puede hacer. La misma página explica los pasos para configurar cada app a mano.

La primera vez que un agente pide grabar, Bingsu te pregunta en su propia ventana. En «Settings», «Agents» aparecen todos los agentes a los que diste permiso, con la opción «Revoke».

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

Pídelo con tus propias palabras. Por ejemplo:

• «Graba esta ventana mientras ejecutas las pruebas, sin sonido. Cuando termines, detén la grabación, verifica el archivo y dime dónde está».
• «Graba la ventana “Settings” durante 20 segundos, luego crea una página para compartir con la grabación y dame la carpeta».
• «Graba mi navegador durante 30 segundos a 60 fps y luego guarda una copia en GIF de menos de 10 MB».

Un agente primero comprueba la imagen con bingsu_screenshot, graba con bingsu_start y solo se fía de un archivo cuando su verificación dice ok. Su grabación aparece en tu barra de menús con su nombre, y puedes detenerla en cualquier momento.

## 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`.

Cada error tiene un código error estable, un message y un 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 graba, detiene y pausa solo sus propias grabaciones. Tú las ves todas en la barra de menús y puedes detener cualquiera.
• Las grabaciones de ventana y de app de un agente toman el sonido de esa app sin reproducirlo por tus altavoces.
• Los agentes manejan los navegadores con sus propias herramientas, nunca con tu puntero ni tu teclado.
• Bingsu nunca baja la calidad para que quepa una grabación más. Cuando los codificadores están llenos, un agente recibe busy antes de empezar, o espera su turno con queue: true.
• Un agente que necesite una pantalla entera puede crear su propia pantalla virtual con 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.

Los agentes no pueden usar la cámara ni los micrófonos hasta que actives «Can use the camera and microphones» en «Settings», «Agents». Al principio está desactivado. Sin ello, un agente que pida uno recibe devices_off, y una grabación nunca activa ninguno por su cuenta.

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

El comando bingsu hace lo mismo que las herramientas MCP, con las mismas respuestas 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"

El código de salida 3 significa que el archivo se guardó pero su verificación encontró un problema. Da a BINGSU_SESSION un valor exclusivo de tu script, para que sus grabaciones sigan siendo suyas.

## 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`.

Bingsu busca actualizaciones una vez al día descargando un archivo pequeño que indica la última versión. La petición le dice al servidor tu versión y nada más. Cada actualización va firmada, y Bingsu solo instala una actualización cuya firma coincida. Desactiva la comprobación en «Settings». Con Homebrew, ejecuta 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/).

Las grabaciones, las transcripciones y los ajustes se quedan en tu Mac. No hay cuenta, ni analíticas, ni informes de fallos, ni telemetría. Un agente que conectes ve lo que Bingsu le devuelve, como rutas de archivos, capturas de pantalla y transcripciones, y su app puede enviarlo a sus propios servidores según sus propias condiciones. Lee la política de privacidad.

## 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).

¿Sigues atascado? Abre un issue en 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. Sal de Bingsu desde su menú.
2. Arrastra Bingsu de Aplicaciones a la Papelera.
3. Elimina el comando: rm ~/.local/bin/bingsu
4. Quítalo de tus agentes, por ejemplo claude mcp remove bingsu.

Tus grabaciones se quedan en ~/Movies/Bingsu hasta que las borres.