Free, open-source screen recorder for macOS. A share link the moment you stop, then auto-zoom, smooth cursor and captions under the same link. Native Swift, your own S3/R2 bucket, CLI and MCP server. A Loom and Screen Studio alternative.
See the code
Reelbird is a free, open-source screen recorder for macOS that copies a share link the moment you stop recording, then lets you polish the same take with auto-zoom, a smooth cursor and captions without changing the link.
Website · Download · Compare · CLI · MCP · Sharing setup · Troubleshooting · Support
It's a native Swift app with no account, no telemetry and no Reelbird server: share links point at a storage bucket you own, such as Cloudflare R2. It includes a command-line tool and an MCP server, so coding agents can record and share demos too. You can download it (not yet notarised by Apple) or build it from source, on macOS 15 or later.
Why not just use Loom or Screen Studio? Loom's free plan stops each video at 5 minutes and won't let you download it; Screen Studio costs $29 a month and gives you a link only after you export. Reelbird gives you the link when you stop and the auto-zoom polish later, under the same link, for free. How it compares.
![]() | ![]() |
![]() | ![]() |
Records what you need, as separate tracks. A display, a window or an area, plus camera, microphone and system audio, with no virtual audio driver. Camera and audio stay on their own tracks, so you can move the camera bubble or mute system sound after recording.
The camera goes where you put it. Drag the camera bubble while you record and the video follows: it starts where the bubble was and glides each time you moved it. In the editor, drag it anywhere on the preview (it snaps to the edges and centre lines), pick a corner, delete single moves or keep it in one place. Circle, rounded square or a 3:4 portrait tile.
Keeps your take if the app quits. Every track is written to disk in 2-second segments from the first frame. If Reelbird crashes or quits mid-recording, the take is recovered the next time Reelbird opens, minus at most the last two seconds.
Warns you while it matters. If the microphone is recording silence, capture stalls, audio drifts, the disk is filling up or uploads fall behind, you see it during the recording, not after.
Auto-zoom and a smooth cursor. Reelbird logs clicks, typing, scrolls and pointer movement next to the video, then plans zooms that follow them. One slider sets how much it zooms, from subtle to punchy, and you can add, move or delete zooms on the timeline. The cursor is redrawn from that log, so it glides instead of jittering, and you can resize or hide it after the fact. Preview and export use the same Metal renderer, so the export looks exactly like the preview.
Audio that sounds finished. Auto level brings your voice to a steady −16 LUFS with a true-peak limiter. Enhance voice removes background noise and evens out your voice on your Mac, with a strength control and a blend back to the original; the raw microphone track is never changed. Lower under voice turns system audio down while you talk.
Instant share links to your own bucket. With Share while recording on, Reelbird uploads a 1080p stream as you record and copies the link the moment you stop. After editing, Update link replaces the video and keeps the URL. Setup is in docs/SHARING.md.
Captions on your Mac. Captions come from Apple's on-device speech recognition. Burn them into the export, or let viewers turn them on from the share page. Cut Long Silences removes the pauses in one go. From the command line, reelbird suggest writes a title and chapters with Apple's on-device model on Macs with Apple Intelligence. No API keys.
Clean frames. Backgrounds, padding, rounded corners, aspect ratios for every platform, and Hide Browser Toolbar to crop the tabs and bookmarks bar off a browser window.
Exports the usual formats. MP4 (H.264), HEVC and ProRes with hardware encoding, plus GIF.
Works with agents. The reelbird command-line tool and its MCP server let Claude Code, Codex or Cursor list screens, record a demo of the change they just made, export it and hand you the link.
Open project format. A recording is a .reelbird folder of standard MP4 files, JSON and an event log, with relative paths. Nothing is locked in. See docs/FORMAT.md.
| Reelbird | Loom | Screen Studio | Cap | OpenScreen | |
|---|---|---|---|---|---|
| Price | Free | Free plan; Business $18/user/mo | $29/mo, or $9/mo billed yearly | Free for personal use; paid from $29/yr | Free |
| Free-plan limits | None | 25 videos, 5 min each, 720p | No free plan listed | Personal use, 5-min links | None |
| Open source | MIT | No | No | AGPLv3 (some parts MIT) | MIT |
| Link when you stop | Yes, to your own bucket | Yes, on Loom's cloud | After export | Yes (Instant mode) | No links |
| Auto-zoom and smooth cursor | Yes | No | Yes | Yes (Studio mode) | Yes |
| Polish an instant link later, same URL | Yes | No auto-zoom | Link comes after export | Instant and Studio are separate modes | No links |
| Download your video | Always | Business plans and up | Yes | Yes | Yes |
| Comments or viewer stats | No | Yes | Yes | Viewer analytics on Pro | No links |
| Platforms | Mac | Mac, Windows, web, mobile | Mac | Mac, Windows (beta), Linux | Mac, Windows, Linux |
| Notarised download | Not yet: approve once, or build from source | Yes | Yes | Yes | Yes |
Checked 12 October 2026 on each vendor's own pages: Loom pricing, Loom downloads, Screen Studio, Cap pricing, OpenScreen. Loom is the better team tool and runs everywhere; Screen Studio has the more mature editor; Cap and OpenScreen run on Windows and Linux. More detail, plus CleanShot X, Tella and Screenity, at reelbird.shiptiffin.app/compare.
Download Reelbird 0.1.0 for Apple silicon Macs on macOS 15 or later (5.6 MB).
It isn't notarised by Apple yet, so macOS asks you to approve it once:
After an update, macOS may ask for Screen Recording permission again, because the app isn't signed with an Apple Developer ID. Building from source avoids both steps. The SHA-256 of each zip is listed on its release page.
Building it yourself takes a few minutes and needs no Xcode, and macOS trusts the result without the approval step.
You need:
xcode-select --install), which bring Swift 6.2 and the macOS 26 SDK. They install on macOS 15.6 and later. Xcode 26 works too but isn't required.git clone https://github.com/btahir/reelbird.git
cd reelbird
make install
make install builds a release copy of the app and copies it to /Applications, asking first if Reelbird is already there. Then open it:
open /Applications/Reelbird.app
Reelbird lives in the menu bar. Look for the robin.
Some Command Line Tools installs ship a stale SwiftPM file that breaks every Package.swift. The scripts detect this and work around it on their own (see scripts/env.sh), so you don't need to do anything. Run make to see every target.
The welcome tour asks for each permission in turn. You can change them later in Settings… → Permissions or in System Settings → Privacy & Security.
| Permission | Needed for |
|---|---|
| Screen & System Audio Recording | Recording the screen and system sound. Required. |
| Microphone | Your voice. |
| Camera | The camera bubble. |
| Accessibility and Input Monitoring | Optional. The keystroke overlay (Settings… → Recording → Record keystrokes). |
| Speech Recognition | Captions on macOS 15 only. macOS 26 and later doesn't ask. |
Screen Recording takes effect only after Reelbird reopens. After you turn it on, choose Quit & Reopen in Reelbird (or quit it from the menu bar and open it again).
By default the app is signed ad hoc. That signature changes with every build, so macOS forgets the Screen Recording permission each time you rebuild. If you build often, create a local signing certificate once:
scripts/dev-signing.sh
export RB_SIGN_IDENTITY="Reelbird Local Signing" # add this to your ~/.zshrc
make install
The script creates a self-signed certificate named "Reelbird Local Signing" in your login keychain and does nothing if it already exists. Every build signed with it has the same identity, so the permission sticks. The first build asks whether codesign may use the key. Choose Always Allow. scripts/dev-signing.sh --remove deletes the certificate. It never leaves your Mac and isn't trusted for anything except signing your own builds.
These two work in every app. Change them in Settings… → General.
| Shortcut | Action |
|---|---|
| ⌥⇧R | New recording; while recording, stop |
| ⌥⇧P | Pause or resume |
While picking what to record, Return starts and Esc closes the picker. During the countdown, Return, Space or a click skips it and Esc cancels. When selecting an area, Return records and Esc cancels.
In the editor:
| Key | Action |
|---|---|
| Space | Play or pause |
| J / K / L | Back 2 seconds / pause / play |
| ← / → | Step back or forward 1/30 second (with ⇧: one second) |
| Home / End | Jump to start or end |
| S | Split at the playhead |
| Z | Add a zoom at the playhead |
| Delete | Cut the selected part, delete the selected zoom, or restore a cut |
| Esc | Clear the selection |
| ⌘1 to ⌘7 | Background, Cursor, Zoom, Camera, Canvas, Audio, Captions |
| ⌘= / ⌘− | Zoom the timeline in or out |
| ⌘E | Export |
| ⌘Z / ⇧⌘Z | Undo / redo |
Elsewhere: ⌘N starts a new recording, ⇧⌘L opens the library, ⌘O opens a .reelbird project, ⇧⌘E shares or copies the link, ⇧⌘R shows the recording in Finder, ⌘⌫ moves it to the Trash, and ⌘, opens Settings.
The reelbird tool ships inside the app. Put it on your PATH:
mkdir -p ~/.local/bin
ln -sf /Applications/Reelbird.app/Contents/Helpers/reelbird ~/.local/bin/reelbird
reelbird sources # displays, windows, microphones and cameras, with IDs
reelbird record --display 1 --duration 30 # 30 seconds of the main display
reelbird record --window 1234 --share # a window by ID from `sources`; Ctrl-C stops
reelbird list # recent recordings
reelbird edit latest --set zoom.intensity=0.7 --trim 0:05-end
reelbird edit latest --set camera.x=0.5 --set camera.y=1 --clear-camera-moves # camera bottom centre, in one place
reelbird export latest --format mp4 --height 1080
reelbird captions latest # captions.vtt, made on this Mac
reelbird enhance latest --strength medium # clean up the voice; the raw mic is kept
reelbird share latest # upload and print the link
reelbird share latest --polished # render the edit, same link
reelbird help record
A project can be a .reelbird path, a name from reelbird list, or latest. Every command takes --json for machine-readable output and --library DIR to use another folder (the default is ~/Movies/Reelbird, or $REELBIRD_LIBRARY).
Sharing settings made in the app are used by the CLI too. To set them from the terminal, run reelbird config share --help.
When you record from a terminal, macOS asks for Screen Recording permission for the terminal app (Terminal, iTerm, your editor), not for Reelbird.
reelbird mcp runs an MCP server over stdio. Agents get tools to list sources, start and stop recordings, list and inspect projects, edit (including crop and camera placement), export, caption, enhance the voice, find silences, suggest chapters, and share or unshare.
Claude Code
claude mcp add reelbird -- /Applications/Reelbird.app/Contents/Helpers/reelbird mcp
Codex
codex mcp add reelbird -- /Applications/Reelbird.app/Contents/Helpers/reelbird mcp
or in ~/.codex/config.toml:
[mcp_servers.reelbird]
command = "/Applications/Reelbird.app/Contents/Helpers/reelbird"
args = ["mcp"]
Cursor (~/.cursor/mcp.json, or .cursor/mcp.json in a project)
{
"mcpServers": {
"reelbird": {
"type": "stdio",
"command": "/Applications/Reelbird.app/Contents/Helpers/reelbird",
"args": ["mcp"]
}
}
}
Then ask: "Record a 20-second demo of the settings page you just changed and give me the share link."
Recording through an agent needs Screen Recording permission for the app that runs the agent (your terminal or editor).
Sharing is optional; recording, editing and exporting work without it. Reelbird has no server, so share links point at a storage bucket you own. When you share, Reelbird uploads a small viewer page and the video to https://<your public URL>/r/<id>/, signed with your own keys. Anyone with that link can watch in a browser, and the link never changes, even after Update link.
Cloudflare R2 is the recommended host: no download (egress) fees, and the free tier includes 10 GB of storage. Setup takes about ten minutes, once:
reelbird. (R2 asks for a payment method even on the free tier.)video.example.com, recommended), or Public Development URL → Enable for a quick https://pub-….r2.dev URL (rate-limited; fine for trying it out).| Field | Value |
|---|---|
| Endpoint | https://<ACCOUNT_ID>.r2.cloudflarestorage.com (account ID is on the R2 overview page) |
| Bucket | your bucket name |
| Region | auto |
| Access key ID / Secret access key | from step 3 |
| Public URL | your custom domain or https://pub-….r2.dev |
Choose Test Connection, which uploads a test file and reads it back through your public URL, then Save. The secret is kept in your macOS Keychain, and the reelbird CLI uses the same settings (reelbird config share --help).
Then turn on Share while recording in the picker, and the link is on your clipboard when you stop. Or share any recording later from the editor. AWS S3, Backblaze B2 and MinIO work too. The full walkthrough, costs, privacy notes and CI setup are in docs/SHARING.md.
Reelbird says Screen Recording is off, but the switch is on. Quit and reopen Reelbird; the permission only applies after a restart. If it still fails, you probably rebuilt an ad-hoc signed copy, and macOS is holding the permission for the old build. Remove Reelbird from the Screen Recording list (select it, then the minus button), reopen Reelbird and allow it again. To stop this happening on every rebuild, set up local signing.
macOS asks again every month whether Reelbird may record your screen. That prompt comes from macOS, not Reelbird. Since macOS 15, the system asks you now and then to confirm apps that record the screen. Choose to keep allowing it.
A Keychain prompt asks to use "app.reelbird.share". That's your sharing secret. It appears when the CLI reads a secret the app saved, or after a rebuild changed the app's signature. Enter your login password and choose Always Allow. Local signing makes the answer stick across rebuilds. For CI, set REELBIRD_S3_SECRET_ACCESS_KEY instead (see docs/SHARING.md).
Keystrokes don't show up. Recording key presses needs Input Monitoring as well as Accessibility. Turn on Reelbird under System Settings → Privacy & Security → Input Monitoring (add it with the plus button if it isn't listed), then reopen Reelbird. Keystrokes are only recorded when Record keystrokes is on before you start.
Captions say they need a newer macOS. On macOS 26 and later, captions use Apple's SpeechAnalyzer and download the language model on first use. On macOS 15 they need on-device speech recognition for your language and the Speech Recognition permission.
The app quit while recording. Is the take lost? Open Reelbird again. It finishes the take from the segments on disk. From the terminal, reelbird recover PROJECT does the same.
~/Movies/Reelbird unless you choose another folder.Seven Swift modules with no third-party dependencies: capture (ScreenCaptureKit, AVFoundation), render (Metal), share (S3 uploads, HLS, viewer page), AI (Speech, Foundation Models), a shared core, the app and the CLI. docs/ARCHITECTURE.md explains the recording pipeline, sharing flow and renderer. docs/FORMAT.md documents the project format.
Bug reports, fixes and features are welcome. CONTRIBUTING.md covers building, tests and pull requests.
MIT.
Reelbird is free and always will be. If it saves you time or a subscription, you can support the project, once or monthly. Stars, bug reports and pull requests help too.
The Reelbird website is hosted on ShipTiffin, which puts all your apps on one server you own. It's open source too: shiptiffin/tiffin.
Free, open-source screen recorder for macOS. A share link the moment you stop, then auto-zoom, smooth cursor and captions under the same link. Native Swift, your own S3/R2 bucket, CLI and MCP server. A Loom and Screen Studio alternative.
See the code
Reelbird is a free, open-source screen recorder for macOS that copies a share link the moment you stop recording, then lets you polish the same take with auto-zoom, a smooth cursor and captions without changing the link.
Website · Download · Compare · CLI · MCP · Sharing setup · Troubleshooting · Support
It's a native Swift app with no account, no telemetry and no Reelbird server: share links point at a storage bucket you own, such as Cloudflare R2. It includes a command-line tool and an MCP server, so coding agents can record and share demos too. You can download it (not yet notarised by Apple) or build it from source, on macOS 15 or later.
Why not just use Loom or Screen Studio? Loom's free plan stops each video at 5 minutes and won't let you download it; Screen Studio costs $29 a month and gives you a link only after you export. Reelbird gives you the link when you stop and the auto-zoom polish later, under the same link, for free. How it compares.
![]() | ![]() |
![]() | ![]() |
Records what you need, as separate tracks. A display, a window or an area, plus camera, microphone and system audio, with no virtual audio driver. Camera and audio stay on their own tracks, so you can move the camera bubble or mute system sound after recording.
The camera goes where you put it. Drag the camera bubble while you record and the video follows: it starts where the bubble was and glides each time you moved it. In the editor, drag it anywhere on the preview (it snaps to the edges and centre lines), pick a corner, delete single moves or keep it in one place. Circle, rounded square or a 3:4 portrait tile.
Keeps your take if the app quits. Every track is written to disk in 2-second segments from the first frame. If Reelbird crashes or quits mid-recording, the take is recovered the next time Reelbird opens, minus at most the last two seconds.
Warns you while it matters. If the microphone is recording silence, capture stalls, audio drifts, the disk is filling up or uploads fall behind, you see it during the recording, not after.
Auto-zoom and a smooth cursor. Reelbird logs clicks, typing, scrolls and pointer movement next to the video, then plans zooms that follow them. One slider sets how much it zooms, from subtle to punchy, and you can add, move or delete zooms on the timeline. The cursor is redrawn from that log, so it glides instead of jittering, and you can resize or hide it after the fact. Preview and export use the same Metal renderer, so the export looks exactly like the preview.
Audio that sounds finished. Auto level brings your voice to a steady −16 LUFS with a true-peak limiter. Enhance voice removes background noise and evens out your voice on your Mac, with a strength control and a blend back to the original; the raw microphone track is never changed. Lower under voice turns system audio down while you talk.
Instant share links to your own bucket. With Share while recording on, Reelbird uploads a 1080p stream as you record and copies the link the moment you stop. After editing, Update link replaces the video and keeps the URL. Setup is in docs/SHARING.md.
Captions on your Mac. Captions come from Apple's on-device speech recognition. Burn them into the export, or let viewers turn them on from the share page. Cut Long Silences removes the pauses in one go. From the command line, reelbird suggest writes a title and chapters with Apple's on-device model on Macs with Apple Intelligence. No API keys.
Clean frames. Backgrounds, padding, rounded corners, aspect ratios for every platform, and Hide Browser Toolbar to crop the tabs and bookmarks bar off a browser window.
Exports the usual formats. MP4 (H.264), HEVC and ProRes with hardware encoding, plus GIF.
Works with agents. The reelbird command-line tool and its MCP server let Claude Code, Codex or Cursor list screens, record a demo of the change they just made, export it and hand you the link.
Open project format. A recording is a .reelbird folder of standard MP4 files, JSON and an event log, with relative paths. Nothing is locked in. See docs/FORMAT.md.
| Reelbird | Loom | Screen Studio | Cap | OpenScreen | |
|---|---|---|---|---|---|
| Price | Free | Free plan; Business $18/user/mo | $29/mo, or $9/mo billed yearly | Free for personal use; paid from $29/yr | Free |
| Free-plan limits | None | 25 videos, 5 min each, 720p | No free plan listed | Personal use, 5-min links | None |
| Open source | MIT | No | No | AGPLv3 (some parts MIT) | MIT |
| Link when you stop | Yes, to your own bucket | Yes, on Loom's cloud | After export | Yes (Instant mode) | No links |
| Auto-zoom and smooth cursor | Yes | No | Yes | Yes (Studio mode) | Yes |
| Polish an instant link later, same URL | Yes | No auto-zoom | Link comes after export | Instant and Studio are separate modes | No links |
| Download your video | Always | Business plans and up | Yes | Yes | Yes |
| Comments or viewer stats | No | Yes | Yes | Viewer analytics on Pro | No links |
| Platforms | Mac | Mac, Windows, web, mobile | Mac | Mac, Windows (beta), Linux | Mac, Windows, Linux |
| Notarised download | Not yet: approve once, or build from source | Yes | Yes | Yes | Yes |
Checked 12 October 2026 on each vendor's own pages: Loom pricing, Loom downloads, Screen Studio, Cap pricing, OpenScreen. Loom is the better team tool and runs everywhere; Screen Studio has the more mature editor; Cap and OpenScreen run on Windows and Linux. More detail, plus CleanShot X, Tella and Screenity, at reelbird.shiptiffin.app/compare.
Download Reelbird 0.1.0 for Apple silicon Macs on macOS 15 or later (5.6 MB).
It isn't notarised by Apple yet, so macOS asks you to approve it once:
After an update, macOS may ask for Screen Recording permission again, because the app isn't signed with an Apple Developer ID. Building from source avoids both steps. The SHA-256 of each zip is listed on its release page.
Building it yourself takes a few minutes and needs no Xcode, and macOS trusts the result without the approval step.
You need:
xcode-select --install), which bring Swift 6.2 and the macOS 26 SDK. They install on macOS 15.6 and later. Xcode 26 works too but isn't required.git clone https://github.com/btahir/reelbird.git
cd reelbird
make install
make install builds a release copy of the app and copies it to /Applications, asking first if Reelbird is already there. Then open it:
open /Applications/Reelbird.app
Reelbird lives in the menu bar. Look for the robin.
Some Command Line Tools installs ship a stale SwiftPM file that breaks every Package.swift. The scripts detect this and work around it on their own (see scripts/env.sh), so you don't need to do anything. Run make to see every target.
The welcome tour asks for each permission in turn. You can change them later in Settings… → Permissions or in System Settings → Privacy & Security.
| Permission | Needed for |
|---|---|
| Screen & System Audio Recording | Recording the screen and system sound. Required. |
| Microphone | Your voice. |
| Camera | The camera bubble. |
| Accessibility and Input Monitoring | Optional. The keystroke overlay (Settings… → Recording → Record keystrokes). |
| Speech Recognition | Captions on macOS 15 only. macOS 26 and later doesn't ask. |
Screen Recording takes effect only after Reelbird reopens. After you turn it on, choose Quit & Reopen in Reelbird (or quit it from the menu bar and open it again).
By default the app is signed ad hoc. That signature changes with every build, so macOS forgets the Screen Recording permission each time you rebuild. If you build often, create a local signing certificate once:
scripts/dev-signing.sh
export RB_SIGN_IDENTITY="Reelbird Local Signing" # add this to your ~/.zshrc
make install
The script creates a self-signed certificate named "Reelbird Local Signing" in your login keychain and does nothing if it already exists. Every build signed with it has the same identity, so the permission sticks. The first build asks whether codesign may use the key. Choose Always Allow. scripts/dev-signing.sh --remove deletes the certificate. It never leaves your Mac and isn't trusted for anything except signing your own builds.
These two work in every app. Change them in Settings… → General.
| Shortcut | Action |
|---|---|
| ⌥⇧R | New recording; while recording, stop |
| ⌥⇧P | Pause or resume |
While picking what to record, Return starts and Esc closes the picker. During the countdown, Return, Space or a click skips it and Esc cancels. When selecting an area, Return records and Esc cancels.
In the editor:
| Key | Action |
|---|---|
| Space | Play or pause |
| J / K / L | Back 2 seconds / pause / play |
| ← / → | Step back or forward 1/30 second (with ⇧: one second) |
| Home / End | Jump to start or end |
| S | Split at the playhead |
| Z | Add a zoom at the playhead |
| Delete | Cut the selected part, delete the selected zoom, or restore a cut |
| Esc | Clear the selection |
| ⌘1 to ⌘7 | Background, Cursor, Zoom, Camera, Canvas, Audio, Captions |
| ⌘= / ⌘− | Zoom the timeline in or out |
| ⌘E | Export |
| ⌘Z / ⇧⌘Z | Undo / redo |
Elsewhere: ⌘N starts a new recording, ⇧⌘L opens the library, ⌘O opens a .reelbird project, ⇧⌘E shares or copies the link, ⇧⌘R shows the recording in Finder, ⌘⌫ moves it to the Trash, and ⌘, opens Settings.
The reelbird tool ships inside the app. Put it on your PATH:
mkdir -p ~/.local/bin
ln -sf /Applications/Reelbird.app/Contents/Helpers/reelbird ~/.local/bin/reelbird
reelbird sources # displays, windows, microphones and cameras, with IDs
reelbird record --display 1 --duration 30 # 30 seconds of the main display
reelbird record --window 1234 --share # a window by ID from `sources`; Ctrl-C stops
reelbird list # recent recordings
reelbird edit latest --set zoom.intensity=0.7 --trim 0:05-end
reelbird edit latest --set camera.x=0.5 --set camera.y=1 --clear-camera-moves # camera bottom centre, in one place
reelbird export latest --format mp4 --height 1080
reelbird captions latest # captions.vtt, made on this Mac
reelbird enhance latest --strength medium # clean up the voice; the raw mic is kept
reelbird share latest # upload and print the link
reelbird share latest --polished # render the edit, same link
reelbird help record
A project can be a .reelbird path, a name from reelbird list, or latest. Every command takes --json for machine-readable output and --library DIR to use another folder (the default is ~/Movies/Reelbird, or $REELBIRD_LIBRARY).
Sharing settings made in the app are used by the CLI too. To set them from the terminal, run reelbird config share --help.
When you record from a terminal, macOS asks for Screen Recording permission for the terminal app (Terminal, iTerm, your editor), not for Reelbird.
reelbird mcp runs an MCP server over stdio. Agents get tools to list sources, start and stop recordings, list and inspect projects, edit (including crop and camera placement), export, caption, enhance the voice, find silences, suggest chapters, and share or unshare.
Claude Code
claude mcp add reelbird -- /Applications/Reelbird.app/Contents/Helpers/reelbird mcp
Codex
codex mcp add reelbird -- /Applications/Reelbird.app/Contents/Helpers/reelbird mcp
or in ~/.codex/config.toml:
[mcp_servers.reelbird]
command = "/Applications/Reelbird.app/Contents/Helpers/reelbird"
args = ["mcp"]
Cursor (~/.cursor/mcp.json, or .cursor/mcp.json in a project)
{
"mcpServers": {
"reelbird": {
"type": "stdio",
"command": "/Applications/Reelbird.app/Contents/Helpers/reelbird",
"args": ["mcp"]
}
}
}
Then ask: "Record a 20-second demo of the settings page you just changed and give me the share link."
Recording through an agent needs Screen Recording permission for the app that runs the agent (your terminal or editor).
Sharing is optional; recording, editing and exporting work without it. Reelbird has no server, so share links point at a storage bucket you own. When you share, Reelbird uploads a small viewer page and the video to https://<your public URL>/r/<id>/, signed with your own keys. Anyone with that link can watch in a browser, and the link never changes, even after Update link.
Cloudflare R2 is the recommended host: no download (egress) fees, and the free tier includes 10 GB of storage. Setup takes about ten minutes, once:
reelbird. (R2 asks for a payment method even on the free tier.)video.example.com, recommended), or Public Development URL → Enable for a quick https://pub-….r2.dev URL (rate-limited; fine for trying it out).| Field | Value |
|---|---|
| Endpoint | https://<ACCOUNT_ID>.r2.cloudflarestorage.com (account ID is on the R2 overview page) |
| Bucket | your bucket name |
| Region | auto |
| Access key ID / Secret access key | from step 3 |
| Public URL | your custom domain or https://pub-….r2.dev |
Choose Test Connection, which uploads a test file and reads it back through your public URL, then Save. The secret is kept in your macOS Keychain, and the reelbird CLI uses the same settings (reelbird config share --help).
Then turn on Share while recording in the picker, and the link is on your clipboard when you stop. Or share any recording later from the editor. AWS S3, Backblaze B2 and MinIO work too. The full walkthrough, costs, privacy notes and CI setup are in docs/SHARING.md.
Reelbird says Screen Recording is off, but the switch is on. Quit and reopen Reelbird; the permission only applies after a restart. If it still fails, you probably rebuilt an ad-hoc signed copy, and macOS is holding the permission for the old build. Remove Reelbird from the Screen Recording list (select it, then the minus button), reopen Reelbird and allow it again. To stop this happening on every rebuild, set up local signing.
macOS asks again every month whether Reelbird may record your screen. That prompt comes from macOS, not Reelbird. Since macOS 15, the system asks you now and then to confirm apps that record the screen. Choose to keep allowing it.
A Keychain prompt asks to use "app.reelbird.share". That's your sharing secret. It appears when the CLI reads a secret the app saved, or after a rebuild changed the app's signature. Enter your login password and choose Always Allow. Local signing makes the answer stick across rebuilds. For CI, set REELBIRD_S3_SECRET_ACCESS_KEY instead (see docs/SHARING.md).
Keystrokes don't show up. Recording key presses needs Input Monitoring as well as Accessibility. Turn on Reelbird under System Settings → Privacy & Security → Input Monitoring (add it with the plus button if it isn't listed), then reopen Reelbird. Keystrokes are only recorded when Record keystrokes is on before you start.
Captions say they need a newer macOS. On macOS 26 and later, captions use Apple's SpeechAnalyzer and download the language model on first use. On macOS 15 they need on-device speech recognition for your language and the Speech Recognition permission.
The app quit while recording. Is the take lost? Open Reelbird again. It finishes the take from the segments on disk. From the terminal, reelbird recover PROJECT does the same.
~/Movies/Reelbird unless you choose another folder.Seven Swift modules with no third-party dependencies: capture (ScreenCaptureKit, AVFoundation), render (Metal), share (S3 uploads, HLS, viewer page), AI (Speech, Foundation Models), a shared core, the app and the CLI. docs/ARCHITECTURE.md explains the recording pipeline, sharing flow and renderer. docs/FORMAT.md documents the project format.
Bug reports, fixes and features are welcome. CONTRIBUTING.md covers building, tests and pull requests.
MIT.
Reelbird is free and always will be. If it saves you time or a subscription, you can support the project, once or monthly. Stars, bug reports and pull requests help too.
The Reelbird website is hosted on ShipTiffin, which puts all your apps on one server you own. It's open source too: shiptiffin/tiffin.