Doku

## 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. Lade Bingsu für Mac. Es braucht macOS 26 Tahoe oder neuer.
2. Öffne Bingsu.dmg aus deinem Downloads-Ordner und zieh Bingsu in den Ordner „Programme“.
3. Öffne Bingsu. Es wohnt in der Menüleiste, nicht im Dock.

Oder mit Homebrew:

brew install --cask bingsu

Um die Datei vor dem Öffnen zu prüfen, vergleiche ihren SHA-256-Wert mit dem auf der Download-Seite:

shasum -a 256 ~/Downloads/Bingsu.dmg

Unter Windows:

1. Lade Bingsu für Windows herunter. Bingsu braucht Windows 10 (Version 2004) oder neuer.
2. Öffne Bingsu.msix in deinem Downloads-Ordner und wähle „Installieren“.
3. Öffne Bingsu über das Startmenü.

Unter Linux:

1. Lade Bingsu für Linux herunter. Bingsu braucht GNOME oder KDE unter Wayland mit PipeWire. X11 geht auch.
2. Mach die Datei ausführbar und öffne sie:

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 fragt einmal, beim ersten Aufnehmen. Schalte Bingsu unter Systemeinstellungen, Datenschutz & Sicherheit, Bildschirm- & Systemaudioaufnahme ein und öffne Bingsu dann erneut.

Kamera und Mikrofon sind eigene Fragen. macOS fragt jeweils erst, wenn du sie zum ersten Mal nutzt. Bingsu schaltet keins von beiden selbst ein.

## 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. Klicke auf das Bingsu-Symbol in der Menüleiste oder drücke von überall ⌥⇧⌘R.
2. Wähle, was du aufnehmen willst: einen Bildschirm, ein Fenster, eine App oder einen Bereich.
3. Drücke „Record“. Wenn du fertig bist, drücke „Stop and Save“.

Jede Datei wird nach dem Sichern geprüft: Länge, Bild, Tonspuren, Stille und ob ein Fenster geschlossen wurde. Ein Problem erscheint als Warnung an der Aufnahme.

Dateien landen in ~/Movies/Bingsu. Den Ordner änderst du in den 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.

• Ein Fenster wird weiter aufgenommen, wenn andere Fenster es verdecken, und nur mit dem Ton dieser App.
• Eine App nimmt alle ihre Fenster auf.
• Ein Bereich nimmt einen festen Teil eines Bildschirms auf. Zieh, um ihn aufzuziehen.
• Ein Bildschirm nimmt alles auf diesem Display auf.

Ein minimiertes Fenster liefert kein Bild. Die Aufnahme wiederholt sein letztes Bild, bis du das Fenster zurückholst.

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

Eine Fenster- oder App-Aufnahme nimmt den Ton dieser App auf und sonst nichts. Eine Bildschirmaufnahme nimmt den Ton des Mac auf.

Füge beliebig viele Mikrofone hinzu. Jedes zeigt einen Live-Pegel, bekommt eine eigene Spur in der Datei und fließt in eine gemischte Spur, die jeder Player abspielt. Wird ein Mikrofon abgesteckt, bleibt seine Spur still, bis du es wieder ansteckst, und die Aufnahme läuft weiter.

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

Wähle im Panel in der Zeile „Camera“ eine Kamera. Sie liegt als Bubble über deiner Aufnahme und wird außerdem als eigene Videospur gesichert.

• Zieh die Bubble an jede beliebige Stelle. Zieh an ihrer Ecke, um die Größe zu ändern.
• Mach sie in ihrer Werkzeugleiste rund, zu einem abgerundeten Quadrat oder breit, und spiegle sie dort.
• Klicke mit der rechten Maustaste darauf, um die Kamera auszuschalten oder die Bubble auszublenden.

In Zoom, Meet, Teams, FaceTime, Slack, Discord, Webex oder WhatsApp findet Bingsu die Personen im Anruffenster und fügt jede als Bubble hinzu, bis zu fünf Gesichter. Es kann der Person folgen, die gerade spricht, oder einer bestimmten Person. Die Stimme jedes Gasts kommt aus der Anruf-App, auf einer eigenen Spur. Die Gesichtserkennung läuft auf deinem Mac. Nichts über ein Gesicht verlässt ihn oder wird gespeichert.

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

• Pausieren und Fortsetzen hinterlassen keine Lücke in der Datei.
• Gib einer Aufnahme eine Länge, und sie stoppt auf die Sekunde genau.
• Wird der Bildschirm gesperrt, pausiert Bingsu und macht weiter, wenn du dich wieder anmeldest. Das änderst du in den Settings.
• Falls der Mac abstürzt: Bingsu schreibt Dateien in Stücken von zwei Sekunden und stellt die halb geschriebene Datei beim nächsten Öffnen wieder her.

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

Öffne eine Aufnahme im Editor.

1. Zieh an den Griffen, um Anfang und Ende zu kürzen.
2. Um einen Teil herauszuschneiden, markiere ihn mit I und O und drücke dann X. ⌘Z macht es rückgängig.
3. Schneide auf 16:9, 9:16, 1:1 oder 4:3 zu.
4. Sichere eine Kopie als HEVC, H.264, ProRes, GIF oder nur Ton.

Das Original wird nie verändert. Jede Bearbeitung sichert eine neue Datei daneben, benannt mit „(edited)“, „(1080p)“ und so weiter.

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

Fokus und Rahmen kommen erst beim Sichern einer Kopie hinzu, nie fest ins Original.

• Fokus zoomt sanft dorthin, wo du klickst und tippst, und glättet den Zeiger. Jeder Zoom erscheint in der Timeline, wo du ihn verschieben, ändern oder entfernen kannst.
• Rahmen setzt ein Fenster oder einen Bereich auf einen Hintergrund, mit Abstand, abgerundeten Ecken und Schatten.

## 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 schreibt ein Transkript mit Zeitmarken, mit dem Sprachmodell von Apple direkt auf dem Gerät. Nichts wird hochgeladen, und nichts kostet Credits. Auf einem Mac mit Apple Intelligence schreibt es außerdem einen Titel, eine kurze Zusammenfassung und Kapitel.

• Zeig Untertitel auf einer Freigabeseite an oder brenne sie in eine Kopie des Videos ein.
• Schneide das Video, indem du Wörter im Transkript löschst.
• Jede Sprache, die dein Mac unterstützt, funktioniert. macOS lädt das Modell einer Sprache bei der ersten Nutzung.

Das schaltest du unter Settings, General, „Understand recordings“ aus.

## 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 macht aus einer Aufnahme einen Ordner, der eine ganze Website ist: ein Player, der Titel, Kapitel, das Transkript und Untertitel. Du veröffentlichst ihn dort, wo du schon Websites hostest. Wir sehen nie die Seite, ihren Link oder ihre Zuschauer.

Sieh dir die Seite vor dem Veröffentlichen auf deinem Mac an. Die Seite bietet das Video nicht zum Download an, außer du schaltest das ein. Jede Person mit der Adresse kann es ansehen. Gib die Adresse also nur an die Menschen weiter, für die sie gedacht ist.

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

Kopiere den Verbindungs-Prompt von bingsustudio.com/agents in deine Agenten-App: ChatGPT für Mac, Claude, Codex, Cursor, Grok Build und andere. Er fügt Bingsu als lokalen MCP-Server hinzu, prüft, ob es funktioniert, und sagt dir, was es kann. Auf derselben Seite stehen die Schritte für jede App zum Einrichten von Hand.

Wenn ein Agent zum ersten Mal aufnehmen will, fragt Bingsu dich in einem eigenen Fenster. Unter Settings, Agents stehen alle Agenten, die du erlaubt hast, jeweils mit „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.

Frag mit deinen eigenen Worten. Zum Beispiel:

• „Nimm dieses Fenster ohne Ton auf, während du die Tests ausführst. Wenn du fertig bist, stopp die Aufnahme, prüf die Datei und sag mir, wo sie liegt.“
• „Nimm das Settings-Fenster 20 Sekunden lang auf, mach daraus eine Freigabeseite und gib mir den Ordner.“
• „Nimm meinen Browser 30 Sekunden lang mit 60 fps auf und sichere dann eine GIF-Kopie unter 10 MB.“

Ein Agent prüft zuerst das Bild mit bingsu_screenshot, nimmt mit bingsu_start auf und vertraut einer Datei erst, wenn ihre Prüfung ok meldet. Seine Aufnahme erscheint mit seinem Namen in deiner Menüleiste, und du kannst sie jederzeit stoppen.

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

Jeder Fehler hat einen stabilen error-Code, eine message und einen 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`.

• Jeder Agent nimmt nur seine eigenen Aufnahmen auf, stoppt und pausiert nur diese. Du siehst alle in der Menüleiste und kannst jede stoppen.
• Fenster- und App-Aufnahmen eines Agenten nehmen den Ton dieser App auf, ohne ihn über deine Lautsprecher abzuspielen.
• Agenten steuern Browser mit ihren eigenen Tools, nie mit deinem Zeiger oder deiner Tastatur.
• Bingsu senkt nie die Qualität, um noch eine Aufnahme unterzubringen. Sind die Encoder ausgelastet, bekommt ein Agent vor dem Start busy zurück oder wartet mit queue: true in der Schlange.
• Ein Agent, der einen ganzen Bildschirm braucht, kann mit bingsu display add ein eigenes virtuelles Display anlegen.

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

Agenten können Kamera und Mikrofone erst nutzen, wenn du unter Settings, Agents „Can use the camera and microphones“ einschaltest. Anfangs ist das aus. Ohne diese Einstellung bekommt ein Agent, der danach fragt, devices_off zurück, und eine Aufnahme schaltet sie nie selbst ein.

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

Der Befehl bingsu macht dasselbe wie die MCP-Tools, mit denselben JSON-Antworten.

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 bedeutet: Die Datei wurde gesichert, aber ihre Prüfung hat ein Problem gefunden. Setze BINGSU_SESSION auf einen Wert, den nur dein Skript nutzt, damit seine Aufnahmen seine eigenen bleiben.

## 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 sucht einmal am Tag nach Updates und lädt dafür eine kleine Datei mit der neuesten Version. Die Anfrage verrät dem Server deine Version und sonst nichts. Jedes Update ist signiert, und Bingsu installiert nur ein Update, dessen Signatur passt. Die Suche schaltest du in den Settings aus. Mit Homebrew führst du brew upgrade aus.

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

Aufnahmen, Transkripte und Einstellungen bleiben auf deinem Mac. Es gibt kein Konto, keine Analyse, keine Absturzberichte und keine Telemetrie. Ein Agent, den du verbindest, sieht, was Bingsu ihm zurückgibt, etwa Dateipfade, Screenshots und Transkripte, und seine App kann das nach ihren eigenen Bedingungen an ihre eigenen Server senden. Lies die Datenschutzerklärung.

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

Kommst du nicht weiter? Eröffne ein Issue auf 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. Beende Bingsu über sein Menü.
2. Zieh Bingsu aus dem Ordner „Programme“ in den Papierkorb.
3. Entferne den Befehl: rm ~/.local/bin/bingsu
4. Entferne es aus deinen Agenten, zum Beispiel mit claude mcp remove bingsu.

Deine Aufnahmen bleiben in ~/Movies/Bingsu, bis du sie löschst.