Documentation

## 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. Téléchargez Bingsu pour Mac. Il nécessite macOS 26 Tahoe ou une version ultérieure.
2. Ouvrez Bingsu.dmg depuis votre dossier Téléchargements et faites glisser Bingsu dans Applications.
3. Ouvrez Bingsu. Il se trouve dans la barre des menus, pas dans le Dock.

Ou avec Homebrew :

brew install --cask bingsu

Pour vérifier le fichier avant de l’ouvrir, comparez son SHA-256 avec celui de la page de téléchargement :

shasum -a 256 ~/Downloads/Bingsu.dmg

Sous Windows :

1. Téléchargez Bingsu pour Windows. Il faut Windows 10 (version 2004) ou une version plus récente.
2. Ouvrez Bingsu.msix depuis votre dossier Téléchargements et choisissez Installer.
3. Ouvrez Bingsu depuis le menu Démarrer.

Sous Linux :

1. Téléchargez Bingsu pour Linux. Il faut GNOME ou KDE sous Wayland avec PipeWire ; X11 fonctionne aussi.
2. Rendez le fichier exécutable, puis ouvrez-le :

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 vous le demande une fois, au premier enregistrement. Activez Bingsu dans Réglages Système, Confidentialité et sécurité, Enregistrement de l’écran et de l’audio du système, puis rouvrez Bingsu.

La caméra et le micro font l’objet de demandes séparées. macOS demande chaque autorisation seulement à la première utilisation. Bingsu ne les active jamais de lui-même.

## 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. Cliquez sur l’icône de Bingsu dans la barre des menus, ou appuyez sur ⌥⇧⌘R depuis n’importe où.
2. Choisissez quoi enregistrer : un écran, une fenêtre, une application ou une zone.
3. Appuyez sur « Record ». Quand vous avez fini, appuyez sur « Stop » puis « Save ».

Chaque fichier est vérifié après la sauvegarde : sa durée, son image, ses pistes son, les silences et la fermeture éventuelle d’une fenêtre. Un problème s’affiche sous forme d’avertissement sur l’enregistrement.

Les fichiers sont enregistrés dans ~/Movies/Bingsu. Changez de dossier dans « 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.

• Une fenêtre continue d’être enregistrée quand d’autres fenêtres la recouvrent, avec le son de cette seule application.
• Une application enregistre toutes ses fenêtres.
• Une zone enregistre une partie fixe d’un écran. Faites glisser pour la tracer.
• Un écran enregistre tout ce qui s’affiche dessus.

Une fenêtre réduite n’envoie aucune image. L’enregistrement répète sa dernière image jusqu’à ce que vous la rouvriez.

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

L’enregistrement d’une fenêtre ou d’une application capte le son de cette application et rien d’autre. L’enregistrement d’un écran capte le son du Mac.

Ajoutez autant de micros que vous voulez. Chacun affiche son niveau en direct, a sa propre piste dans le fichier et alimente une piste mixée que tous les lecteurs savent lire. Si un micro est débranché, sa piste reste muette jusqu’à ce que vous le rebranchiez, et l’enregistrement continue.

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

Choisissez une caméra dans la ligne « Camera » du panneau. Elle s’affiche en bulle par-dessus votre enregistrement et elle est aussi sauvegardée sur sa propre piste vidéo.

• Faites glisser la bulle où vous voulez. Faites glisser son coin pour la redimensionner.
• Depuis sa barre d’outils, rendez-la ronde, carrée à coins arrondis ou large, et affichez-la en miroir.
• Faites un clic droit dessus pour couper la caméra ou la masquer.

Dans Zoom, Meet, Teams, FaceTime, Slack, Discord, Webex ou WhatsApp, Bingsu repère les personnes dans la fenêtre de l’appel et ajoute chacune sous forme de bulle, jusqu’à cinq visages. Il peut suivre la personne qui parle, ou une seule personne. La voix de chaque invité provient de l’application d’appel, sur sa propre piste. La détection des visages se fait sur votre Mac ; aucune donnée sur un visage n’en sort ni n’est conservée.

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

• Mettre en pause puis reprendre ne laisse aucun trou dans le fichier.
• Fixez une durée à un enregistrement et il s’arrête à la seconde près.
• Quand l’écran se verrouille, Bingsu se met en pause et reprend quand vous vous reconnectez. Modifiez ce comportement dans « Settings ».
• En cas de plantage du Mac, Bingsu écrit les fichiers par segments de deux secondes et récupère le fichier à moitié écrit à sa prochaine ouverture.

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

Ouvrez un enregistrement dans l’éditeur.

1. Faites glisser les poignées pour raccourcir le début et la fin.
2. Pour retirer un passage, marquez-le avec I et O, puis appuyez sur X. ⌘Z annule.
3. Recadrez en 16:9, 9:16, 1:1 ou 4:3.
4. Sauvegardez une copie en HEVC, H.264, ProRes, GIF ou son seul.

L’original n’est jamais modifié. Chaque modification sauvegarde un nouveau fichier à côté, nommé « (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.

Zoom auto et Cadre s’appliquent quand vous sauvegardez une copie, jamais dans l’original.

• Zoom auto agrandit l’image en douceur là où vous cliquez et tapez, et lisse le mouvement du pointeur. Chaque zoom apparaît sur la timeline, où vous pouvez le déplacer, le modifier ou le supprimer.
• Cadre pose une fenêtre ou une zone sur un arrière-plan, avec des marges, des coins arrondis et une ombre.

## 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 produit une transcription horodatée avec le modèle vocal d’Apple, directement sur l’appareil. Rien n’est envoyé en ligne et rien ne coûte de crédits. Sur un Mac avec Apple Intelligence, il rédige aussi un titre, un court résumé et des chapitres.

• Affichez les sous-titres sur une page de partage, ou incrustez-les dans une copie de la vidéo.
• Coupez la vidéo en supprimant des mots dans la transcription.
• Toutes les langues prises en charge par votre Mac fonctionnent. macOS télécharge le modèle d’une langue à sa première utilisation.

Désactivez cette fonction dans « 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 transforme un enregistrement en un dossier qui forme un site web complet : un lecteur, le titre, les chapitres, la transcription et les sous-titres. Vous le publiez là où vous hébergez déjà vos sites. Nous ne voyons jamais la page, son lien ni ses visiteurs.

Prévisualisez la page sur votre Mac avant de la publier. La page ne propose pas de télécharger la vidéo, sauf si vous l’activez. Toute personne qui a l’adresse peut la regarder : ne la donnez qu’aux personnes concernées.

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

Copiez le prompt de connexion de bingsustudio.com/agents dans votre application d’agent : ChatGPT pour Mac, Claude, Codex, Cursor, Grok Build et d’autres. Il ajoute Bingsu comme serveur MCP local, vérifie qu’il fonctionne et vous dit ce qu’il sait faire. La même page détaille la configuration manuelle pour chaque application.

La première fois qu’un agent demande à enregistrer, Bingsu vous pose la question dans sa propre fenêtre. « Settings », « Agents » liste chaque agent autorisé, avec un bouton « 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.

Demandez-le avec vos propres mots. Par exemple :

• « Enregistre cette fenêtre pendant que tu lances les tests, sans le son. Quand tu as fini, arrête, vérifie le fichier et dis-moi où il se trouve. »
• « Enregistre la fenêtre Réglages pendant 20 secondes, puis fais-en une page de partage et donne-moi le dossier. »
• « Enregistre mon navigateur pendant 30 secondes à 60 i/s, puis sauvegarde une copie en GIF de moins de 10 Mo. »

Un agent vérifie d’abord l’image avec bingsu_screenshot, enregistre avec bingsu_start et ne se fie à un fichier que si sa vérification indique ok. Son enregistrement apparaît dans votre barre des menus avec son nom, et vous pouvez l’arrêter à tout moment.

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

Chaque erreur a un code error stable, un message et 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`.

• Chaque agent n’enregistre, n’arrête et ne met en pause que ses propres enregistrements. Vous les voyez tous dans la barre des menus et pouvez arrêter n’importe lequel.
• Quand un agent enregistre une fenêtre ou une application, il capte le son de cette application sans le diffuser sur vos haut-parleurs.
• Les agents pilotent les navigateurs avec leurs propres outils, jamais avec votre pointeur ni votre clavier.
• Bingsu ne baisse jamais la qualité pour caser un enregistrement de plus. Quand les encodeurs sont saturés, l’agent reçoit busy avant de démarrer, ou attend son tour avec queue: true.
• Un agent qui a besoin d’un écran entier peut créer son propre écran virtuel avec 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.

Les agents ne peuvent pas utiliser la caméra ni les micros tant que vous n’avez pas activé « Can use the camera and microphones » dans « Settings », « Agents ». Ce réglage est désactivé au départ. Sans lui, un agent qui en demande un reçoit devices_off, et un enregistrement n’en active jamais un de lui-même.

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

La commande bingsu fait la même chose que les outils MCP, avec les mêmes réponses 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"

Le code de sortie 3 signifie que le fichier a été sauvegardé mais que sa vérification a trouvé un problème. Donnez à BINGSU_SESSION une valeur propre à votre script, pour que ses enregistrements restent les siens.

## 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 recherche les mises à jour une fois par jour en téléchargeant un petit fichier qui indique la dernière version. La requête transmet au serveur votre version et rien d’autre. Chaque mise à jour est signée, et Bingsu n’installe que celles dont la signature correspond. Désactivez cette vérification dans « Settings ». Avec Homebrew, lancez 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/).

Les enregistrements, les transcriptions et les réglages restent sur votre Mac. Pas de compte, pas d’analytics, pas de rapports de plantage, pas de télémétrie. Un agent que vous connectez voit ce que Bingsu lui renvoie, comme des chemins de fichiers, des captures d’écran et des transcriptions, et son application peut l’envoyer à ses propres serveurs selon ses propres conditions. Lisez la politique de confidentialité.

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

Toujours bloqué ? Ouvrez une issue sur 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. Quittez Bingsu depuis son menu.
2. Faites glisser Bingsu d’Applications vers la Corbeille.
3. Supprimez la commande : rm ~/.local/bin/bingsu
4. Retirez-le de vos agents, par exemple claude mcp remove bingsu.

Vos enregistrements restent dans ~/Movies/Bingsu jusqu’à ce que vous les supprimiez.