ドキュメント

## 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. Mac 版 Bingsu をダウンロードします。macOS 26 Tahoe 以降が必要です。
2. ダウンロードフォルダーから Bingsu.dmg を開き、Bingsu をアプリケーションフォルダーにドラッグします。
3. Bingsu を開きます。Bingsu は Dock ではなく、メニューバーにあります。

Homebrew を使う場合：

brew install --cask bingsu

開く前にファイルを確認するには、その SHA-256 をダウンロードページのものと比べます：

shasum -a 256 ~/Downloads/Bingsu.dmg

Windows の場合:

1. Windows 版 Bingsu をダウンロードします。Windows 10（バージョン 2004）以降が必要です。
2. ダウンロードフォルダの Bingsu.msix を開き、「インストール」を選びます。
3. スタートメニューから Bingsu を開きます。

Linux の場合:

1. Linux 版 Bingsu をダウンロードします。PipeWire を使う Wayland 上の GNOME か KDE が必要です。X11 でも動きます。
2. ファイルに実行権限を付けて開きます:

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 が一度だけ許可を求めます。「システム設定」＞「プライバシーとセキュリティ」＞「画面収録とシステムオーディオ録音」で Bingsu をオンにし、Bingsu を開き直してください。

カメラとマイクの許可は別々に求められます。macOS はそれぞれを初めて使うときにだけ尋ねます。Bingsu がどちらかを勝手にオンにすることはありません。

## 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. メニューバーの Bingsu アイコンをクリックするか、どこからでも ⌥⇧⌘R を押します。
2. 録画する対象を選びます：画面、ウインドウ、アプリ、範囲。
3. 「Record」を押します。終わったら「Stop and Save」を押します。

すべてのファイルは保存後にチェックされます：長さ、映像、音声トラック、無音、ウインドウが閉じられていないか。問題があると、その録画に警告が表示されます。

ファイルは ~/Movies/Bingsu に保存されます。フォルダーは「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.

• ウインドウは、ほかのウインドウに隠れても録画が続き、そのアプリの音声だけを録音します。
• アプリは、そのアプリのすべてのウインドウを録画します。
• 範囲は、画面の決まった部分を録画します。ドラッグして範囲を描きます。
• 画面は、そのディスプレイ上のすべてを録画します。

しまったウインドウからは映像が送られません。ウインドウを元に戻すまで、録画には最後のフレームが繰り返し入ります。

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

ウインドウやアプリの録画では、そのアプリの音声だけが入ります。画面の録画では Mac の音声が入ります。

マイクはいくつでも追加できます。それぞれにリアルタイムの音量が表示され、ファイル内に専用のトラックが作られ、どのプレーヤーでも再生されるひとつのミックストラックにもまとめられます。マイクが抜けても、そのトラックは挿し直すまで無音になるだけで、録画は続きます。

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

パネルの「Camera」の行でカメラを選びます。カメラはバブルとして録画の上に重なり、専用のビデオトラックとしても保存されます。

• バブルは好きな場所にドラッグできます。角をドラッグするとサイズを変えられます。
• ツールバーから、円形、角丸の四角形、横長に変えたり、左右反転したりできます。
• 右クリックすると、カメラをオフにしたり、非表示にしたりできます。

Zoom、Meet、Teams、FaceTime、Slack、Discord、Webex、WhatsApp では、Bingsu が通話ウインドウ内の参加者を見つけ、それぞれをバブルとして追加します（最大 5 人）。話している人を追うことも、1 人を映し続けることもできます。各ゲストの声は通話アプリから取り出され、専用のトラックに入ります。顔の検出は Mac 上で行われ、顔に関する情報が外に出ることも、保存されることもありません。

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

• 一時停止と再開をしても、ファイルに隙間はできません。
• 録画の長さを指定すると、その秒ちょうどで停止します。
• 画面がロックされると Bingsu は一時停止し、再びサインインすると録画を続けます。この動作は「Settings」で変更できます。
• Bingsu はファイルを 2 秒単位で書き込むので、Mac がクラッシュしても、次に開いたときに書きかけのファイルを復元します。

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

録画をエディターで開きます。

1. ハンドルをドラッグして、始まりと終わりをトリムします。
2. 一部を切り取るには、I と O で範囲を指定してから X を押します。⌘Z で取り消せます。
3. 16:9、9:16、1:1、4:3 に切り抜けます。
4. コピーを HEVC、H.264、ProRes、GIF、または音声のみで保存できます。

元のファイルは変更されません。編集のたびに、「(edited)」「(1080p)」などの名前の新しいファイルが隣に保存されます。

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

フォーカスとフレームはコピーを保存するときに加えられ、元のファイルに焼き込まれることはありません。

• フォーカスは、クリックや入力をした場所へなめらかにズームし、ポインターの動きもなめらかにします。ズームはすべてタイムラインに表示され、そこで移動、変更、削除ができます。
• フレームは、ウインドウや範囲を、余白、角丸、影を付けて背景の上に配置します。

## 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 は Apple のオンデバイス音声モデルを使って、タイムスタンプ付きの文字起こしを作ります。何もアップロードされず、クレジットも消費しません。Apple Intelligence に対応した Mac では、タイトル、短い要約、チャプターも作ります。

• 字幕は共有ページに表示することも、動画のコピーに焼き込むこともできます。
• 文字起こしの単語を削除して、動画をカットできます。
• Mac が対応しているすべての言語で使えます。各言語のモデルは、初めて使うときに macOS がダウンロードします。

この機能は「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 は録画を、それだけで完結したウェブサイトのフォルダーに変換します。中身はプレーヤー、タイトル、チャプター、文字起こし、字幕です。あなたがいつもサイトを公開している場所で公開してください。私たちがそのページやリンク、閲覧者を見ることはありません。

公開する前に、Mac でページをプレビューしてください。ダウンロードをオンにしない限り、ページから動画はダウンロードできません。アドレスを知っている人は誰でも視聴できるので、アドレスは見せたい相手にだけ伝えてください。

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

bingsustudio.com/agents の接続用プロンプトを、ChatGPT for Mac、Claude、Codex、Cursor、Grok Build などのエージェントアプリに貼り付けます。Bingsu がローカル MCP サーバーとして追加され、動作が確認され、何ができるかが表示されます。同じページに、アプリごとの手動の設定手順もあります。

エージェントが初めて録画を求めたとき、Bingsu は自分のウインドウであなたに確認します。「Settings」＞「Agents」には許可したエージェントがすべて表示され、「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.

頼み方は自由です。たとえば：

• 「テストを実行している間、このウインドウを音声なしで録画して。終わったら停止してファイルをチェックし、保存場所を教えて」
• 「設定ウインドウを 20 秒録画して、それから共有ページを作ってフォルダーを渡して」
• 「ブラウザーを 60 fps で 30 秒録画して、10 MB 未満の GIF のコピーを保存して」

エージェントはまず bingsu_screenshot で映像を確認し、bingsu_start で録画し、チェック結果が ok のファイルだけを信頼します。エージェントの録画はその名前付きでメニューバーに表示され、いつでも停止できます。

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

どのエラーにも、変わらない error コード、message、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`.

• 各エージェントが録画、停止、一時停止できるのは自分の録画だけです。あなたはメニューバーですべての録画を確認でき、どれでも停止できます。
• エージェントによるウインドウやアプリの録画は、そのアプリの音声をスピーカーで鳴らさずに録音します。
• エージェントは自分のツールでブラウザーを操作し、あなたのポインターやキーボードは使いません。
• Bingsu は、録画をもうひとつ増やすために画質を下げることはしません。エンコーダーがいっぱいのとき、エージェントは開始前に busy を受け取るか、queue: true で順番を待ちます。
• 画面全体が必要なエージェントは、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.

「Settings」＞「Agents」で「Can use the camera and microphones」をオンにするまで、エージェントはカメラやマイクを使えません。この設定は最初はオフです。オフのままカメラやマイクを求めたエージェントには devices_off が返され、録画が勝手にカメラやマイクをオンにすることもありません。

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

bingsu コマンドは MCP ツールと同じことを行い、同じ 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"

終了コード 3 は、ファイルは保存されたもののチェックで問題が見つかったことを意味します。BINGSU_SESSION にスクリプト固有の値を設定すると、そのスクリプトの録画を他と区別できます。

## 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 は 1 日 1 回、最新バージョンが書かれた小さなファイルをダウンロードしてアップデートを確認します。このリクエストでサーバーに伝わるのは、あなたのバージョンだけです。各アップデートには署名があり、Bingsu は署名が一致するアップデートだけをインストールします。確認は「Settings」でオフにできます。Homebrew の場合は 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/).

録画、文字起こし、設定はあなたの Mac に残ります。アカウントも、アクセス解析も、クラッシュレポートも、テレメトリーもありません。接続したエージェントには、ファイルパス、スクリーンショット、文字起こしなど、Bingsu が返した情報が見えます。そのアプリは、独自の規約に基づいてそれらを自社のサーバーに送信する場合があります。プライバシーポリシーをお読みください。

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

それでも解決しない場合は、GitHub で issue を作成してください。

## 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. Bingsu をメニューから終了します。
2. Bingsu をアプリケーションフォルダーからゴミ箱にドラッグします。
3. コマンドを削除します：rm ~/.local/bin/bingsu
4. エージェントからも削除します。たとえば claude mcp remove bingsu。

録画は、削除するまで ~/Movies/Bingsu に残ります。