문서 · Bingsu

Bingsu는 내 컴퓨터에서 화면, 카메라, 통화를 녹화해요. AI 에이전트도 자기가 하는 작업을 직접 녹화할 수 있어요. 아래 작업은 모두 프롬프트로 복사할 수 있어서 에이전트에게 대신 맡길 수 있어요.

Bingsu 설치

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

Mac용 Bingsu 다운로드. macOS 26 Tahoe 이상이 필요해요.
다운로드 폴더에서 Bingsu.dmg을 열고 Bingsu를 응용 프로그램 폴더로 끌어다 놓으세요.
Bingsu를 여세요. Dock이 아니라 메뉴 막대에 있어요.

Homebrew로 설치하려면:

brew install --cask bingsu

열기 전에 파일을 확인하려면 SHA-256 값을 다운로드 페이지의 값과 비교하세요.

shasum -a 256 ~/Downloads/Bingsu.dmg

Windows에서:

Windows용 Bingsu를 다운로드하세요. Windows 10(버전 2004) 이상이 필요해요.
다운로드 폴더에서 Bingsu.msix을 열고 설치를 누르세요.
시작 메뉴에서 Bingsu를 여세요.

Linux에서:

Linux용 Bingsu를 다운로드하세요. PipeWire가 있는 Wayland 환경의 GNOME이나 KDE가 필요해요. X11에서도 쓸 수 있어요.
파일에 실행 권한을 주고 여세요:

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.

메뉴 막대의 Bingsu 아이콘을 클릭하거나, 어디서든 ⌥⇧⌘R을 누르세요.
녹화할 대상을 고르세요: 화면, 창, 앱 또는 영역.
'Record'를 누르세요. 다 끝나면 'Stop'과 '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가 통화 창 속 사람들을 찾아 각각 버블로 추가해요. 얼굴은 최대 다섯 개예요. 말하는 사람을 따라가거나 한 사람만 따라갈 수 있어요. 게스트의 목소리는 통화 앱에서 가져와 각자 별도 트랙에 담겨요. 얼굴 찾기는 Mac에서 실행되고, 얼굴에 관한 어떤 정보도 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'에서 바꿀 수 있어요.
Mac이 멈추는 경우에 대비해 Bingsu는 파일을 2초 단위 조각으로 쓰고, 다음에 열 때 쓰다 만 파일을 복구해요.

앞뒤 자르기, 구간 잘라 내기, 크롭

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

편집기에서 녹화를 여세요.

핸들을 끌어 앞뒤를 자르세요.
구간을 잘라 내려면 I와 O로 표시한 다음 X를 누르세요. ⌘Z로 실행 취소해요.
16:9, 9:16, 1:1, 4:3으로 크롭하세요.
사본을 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는 녹화를 완전한 웹사이트 폴더로 만들어요: 플레이어, 제목, 챕터, 녹취록, 자막. 이미 사이트를 호스팅하는 곳에 게시하면 돼요. 저희는 페이지도, 링크도, 시청자도 보지 않아요.

호스트	폴더를 게시할 곳
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	ChatGPT 앱의 Codex에게 폴더 게시를 요청하세요

게시하기 전에 Mac에서 페이지를 미리 보세요. 직접 켜지 않는 한 페이지에서 영상을 내려받을 수 없어요. 주소를 아는 사람은 누구나 볼 수 있으니, 주소는 보여 줄 사람에게만 알려 주세요.

AI 에이전트 연결하기

## 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의 연결 프롬프트를 에이전트 앱에 붙여 넣으세요. Mac용 ChatGPT, 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초 동안 녹화하고, 그걸로 공유 페이지를 만들어서 폴더를 줘.”
“내 브라우저를 60fps로 30초 동안 녹화하고, 10MB 이하 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`.

도구	하는 일
`bingsu_sources`	디스플레이, 창, 앱, 마이크, 카메라를 ID와 함께 나열해요
`bingsu_screenshot`	소스를 녹화하면 보일 화면 그대로
`bingsu_start`	소스를 녹화해요. `seconds`와 `wait`를 주면 저장하고 검사한 파일을 돌려줘요
`bingsu_wait`, `bingsu_stop`, `bingsu_pause`	에이전트 자신의 녹화를 기다리거나, 멈추거나, 일시 정지해요
`bingsu_status`	녹화 중인 항목, 추가 녹화 여유, 남은 디스크 공간
`bingsu_recordings`, `bingsu_verify`	최근 녹화와 검사 결과. 파일을 다시 검사해요
`bingsu_export`	앞뒤를 자르거나, 구간을 잘라 내거나, 크롭하거나, 변환한 사본. 원본을 덮어쓰지 않아요
`bingsu_understand`	Mac에서 만드는 녹취록, 제목, 요약, 챕터
`bingsu_share_page`	바로 게시할 수 있는 녹화용 웹사이트 폴더
`bingsu_mark`, `bingsu_script`, `bingsu_presenter`	이름 붙인 단계, 내레이션 대본, 음성 또는 발표자 클립

모든 오류에는 고정된 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는 하루에 한 번 최신 버전이 적힌 작은 파일을 내려받아 업데이트를 확인해요. 이 요청은 서버에 내 버전만 알리고 다른 정보는 보내지 않아요. 업데이트는 모두 서명되어 있고, 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/bingsustudio/bingsu/issues).

오류	해결 방법
`permission`	시스템 설정 > 개인정보 보호 및 보안 > 화면 및 시스템 오디오 녹음에서 Bingsu를 허용하세요
`sound_permission`	macOS가 물으면 허용하거나, 소리 없이 녹화하세요
`device_permission`	시스템 설정 > 개인정보 보호 및 보안에서 카메라나 마이크를 허용하세요
`devices_off`	'Settings' > 'Agents'에서 'Can use the camera and microphones'을 켜세요
`agents_off`	'Settings' > 'Agents'에서 스크립트와 에이전트를 다시 켜세요
`not_found`	창, 앱 또는 녹화가 없어졌어요. `fix`에 지금 있는 항목이 나와요
`disk_full`	공간을 확보하세요. Bingsu에는 1GB가 필요해요
`busy`	녹화 하나를 멈추거나, `queue: true`로 시작하세요
`not_yours`	자기 녹화를 대상으로 하려면 id를 빼세요

그래도 안 되나요? 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.

메뉴에서 Bingsu를 종료하세요.
응용 프로그램 폴더에서 Bingsu를 휴지통으로 끌어다 놓으세요.
명령어 제거: rm ~/.local/bin/bingsu
에이전트에서도 제거하세요. 예: claude mcp remove bingsu.

녹화는 직접 지우기 전까지 ~/Movies/Bingsu에 남아 있어요.