Bezelbub MCP server

Bezelbub

Bezelbub puts your screenshots and screen recordings inside realistic Apple device bezels, so you get pixel-accurate device mockups for iPhone, iPad, Mac, and Apple TV as framed images and videos. You can use it three ways:

• As a macOS and iOS app. Drop in a screenshot or a video, and Bezelbub picks the matching device and frames it.
• As a headless command-line tool, bezelbub (brew install cwooddgr/tap/bezelbub). Frame a screenshot from a script, add a device frame to a screen recording, or export a transparent HEVC-with-alpha video with a VP9/WebM copy for Chrome and Firefox. We built it for shell scripts, CI, and AI agents. Jump to the CLI docs.
• As a Swift package with no UI, BezelbubKit, if you want the framing engine inside your own tool.

Get Bezelbub on the App Store for Mac, iPhone, and iPad.

What you can do with it

• Let it find the device. Drop in a screenshot or video and you get the right bezel. We recognize iPhones and iPads by their exact resolution. For Macs, iMac, Studio Display, and Apple TV we recognize the capture size of each macOS display zoom setting, from "Larger Text" to "More Space", so you can take the capture at any zoom level. If we don't have a size on file, we fall back to matching by aspect ratio. When several models share a panel, you pick from all of them. Load another screenshot for the same device and your device and color choices stay put.
• Drag and drop on the Mac. Drop a screenshot or screen recording on the window or the Dock icon.
• Paste on the Mac. Copy a screenshot and press ⌘V, or use Edit ▸ Paste.
• Photos and the share sheet on iPhone and iPad. Import from Photos, or send an image to Bezelbub from any app's share sheet.
• Frame videos. Export MOV and MP4 screen recordings with the bezel on top, with the audio kept.
• Export transparent video. Save a framed recording with a fully transparent background as HEVC-with-alpha in a QuickTime .mov, ready to lay over any web page or presentation.
• Fix rotation. Rotate a video that came in sideways. Option-click to go the other way.
• Pick the color. Every color Apple ships for each device.
• Set the export size. Change the width, the height, or the scale before saving. Images go up to 16,384 px and videos up to 7,680 px.
• Copy or save. Copy a framed image to the clipboard, save it as PNG, or export a framed video as MOV or MP4.
• Portrait or landscape for iPhone and iPad.

Devices

• iPhone: 14, 14 Plus, 14 Pro, 14 Pro Max, 15, 15 Plus, 15 Pro, 15 Pro Max, 16, 16 Plus, 16 Pro, 16 Pro Max, 17, 17 Pro, 17 Pro Max, Air, 18 Pro, 18 Pro Max
• iPhone Duo: three views, each its own device. Frame the inner display with the phone open (iphoneduo), the outer display with the phone closed (iphoneduoouter), or the outer display with the phone open and seen from the back (iphoneduoouteropen), in portrait or landscape
• iPad: iPad, iPad (A16), iPad Air 11"/13" M2, iPad Air 11"/13" M4, iPad mini, iPad mini (A17 Pro), iPad Pro 11"/13" M4, iPad Pro 11"/13" M5
• Mac: MacBook Air 13", MacBook Air 13"/15" M5, MacBook Pro 14", MacBook Pro 16", MacBook Pro 14"/16" M5, MacBook Neo, iMac 24", iMac 24" M4, Studio Display (2026). Any display zoom setting works. The Studio Display bezel covers the XDR too, because Apple ships identical art for both
• Apple TV: Apple TV 4K, from 1080p or 4K screenshots

The bezelbub command-line tool

Shortened. The full README is on GitHub.