Automatically frame your iPhone screenshots — from the Simulator or a real device — with a device bezel, the moment they land on your Desktop.
iPhone 截圖(模擬器或實機)存到桌面後,自動套上實機外框(bezel)。
| Simulator screenshot 模擬器截圖 | Auto-framed 自動加框後 |
|---|---|
 |
 |
Save a screenshot in the iPhone Simulator (Cmd+S), or take one on a real iPhone through iPhone Mirroring, and a framed ... Bezel.png appears next to it on your Desktop within seconds — no clicks, no drag-and-drop, fully automatic.
- macOS (uses the built-in launchd; no third-party dependencies)
- Xcode or Command Line Tools, for compiling at install time (
xcode-select --install)
git clone https://github.com/PeterPanSwift/simulator-bezel.git
cd simulator-bezel
./install.shThen press Cmd+S in the Simulator to save a screenshot to your Desktop and watch it get framed. If macOS asks for permission to access your Desktop on the first run, click Allow.
install.shcompilesbezel-frame, deploys it together withbezel.pngto~/Library/Application Support/add-bezel/, and registers a launchd LaunchAgent (~/Library/LaunchAgents/com.add-bezel.plist).- The LaunchAgent uses WatchPaths to watch
~/Desktop: whenever the folder changes, the system launchesbezel-frame --scanonce. Idle cost is zero (kernel event notification, not polling), and a scan that finds nothing to do finishes in about 16 ms. bezel-frameauto-detects the transparent screen cutout inbezel.png(flood-filling transparent pixels from the center), draws the screenshot underneath and the bezel on top — so swapping in a different bezel image requires no code changes.- A file is processed when its name starts with
Screenshot(orSimulator Screenshot) and containsiPhone— this covers both Simulator names likeScreenshot iPhone 17 Pro 08-05-2026 at 16.42.20.pngand real-device names likeScreenshot Peter's iPhone 08-06-2026 at 00.26.35.png. Files that already have a... Bezel.pngcounterpart are skipped (idempotent — rescanning never redoes work).
Replace bezel.png with any frame image whose screen area is transparent, then run ./install.sh again. The cutout position and size are detected at runtime.
The bundled bezel.png is an iPhone 17 Pro (Cosmic Orange) with a 1206×2622 screen cutout — a 1:1 match for Simulator screenshot resolution.
install.sh gives you two Finder right-click entry points, both of which frame any image regardless of its filename and save the result next to the original as ... Bezel.png:
- Quick Action — right-click an image → Quick Actions → Add Bezel. Installed as an Automator workflow at
~/Library/Services/Add Bezel.workflow; also selectable from the Finder preview pane and the Touch Bar. - Open With — right-click an image → Open With → Add Bezel, or drop images onto
~/Applications/Add Bezel.app(an AppleScript droplet compiled withosacompile).
If a menu item doesn't show up right away, relaunch Finder or log out and back in.
./add-bezel.sh # scan ~/Desktop
./add-bezel.sh ~/Pictures # scan a specific folderOr frame a single file:
./bezel-frame screenshot.png # bezel.png taken from the binary's folder, writes "screenshot Bezel.png"
./bezel-frame bezel.png screenshot.png output.png- Execution log:
~/Library/Caches/add-bezel.log— one line per scan (visible=screenshots seen,framed=newly framed). - If nothing happens, check the LaunchAgent:
launchctl print gui/$(id -u)/com.add-bezel.
./uninstall.shFramed images on your Desktop are left untouched.
iPhone 的截圖存到桌面後,自動套上實機外框(bezel),產生適合分享、放簡報的圖片。模擬器截圖與透過「iPhone 鏡像輸出」拍的實機截圖都支援。
存下 Screenshot iPhone 17 Pro ... .png 幾秒後,旁邊就會自動出現加好外框的 Screenshot iPhone 17 Pro ... Bezel.png,完全不用動手。
- macOS(使用內建的 launchd,不需安裝任何第三方工具)
- Xcode 或 Command Line Tools(安裝時編譯用:
xcode-select --install)
git clone https://github.com/PeterPanSwift/simulator-bezel.git
cd simulator-bezel
./install.sh安裝後在模擬器按 Cmd+S 存一張截圖到桌面試試。第一次執行時若 macOS 詢問是否允許取用「桌面」,請按允許。
install.sh會把編譯好的bezel-frame和bezel.png部署到~/Library/Application Support/add-bezel/,並註冊一個 launchd LaunchAgent(~/Library/LaunchAgents/com.add-bezel.plist)。- LaunchAgent 用 WatchPaths 監看
~/Desktop:桌面一有變動,系統就喚起bezel-frame --scan掃描一次。平常完全不耗資源(核心事件通知,不是輪詢),沒有新截圖時一次掃描約 16 毫秒就結束。 bezel-frame會自動偵測bezel.png透明螢幕開口的位置(從中心 flood-fill 透明像素),把截圖墊在下層、外框疊在上層合成,所以換不同外框圖不需要改任何程式。- 檔名開頭是
Screenshot(或Simulator Screenshot)且含有iPhone的檔案才會處理 — 同時涵蓋模擬器的Screenshot iPhone 17 Pro 08-05-2026 at 16.42.20.png與實機的Screenshot 彼得潘 的 iPhone 08-06-2026 at 00.26.35.png。已經有對應... Bezel.png的會跳過(冪等,重複掃描不會重做)。
把 bezel.png 換成任何螢幕區域為透明的外框圖,重新執行 ./install.sh 即可。開口位置與大小都是執行時自動偵測的。
附的 bezel.png 是 iPhone 17 Pro(宇宙橙),螢幕開口 1206×2622,和模擬器截圖解析度 1:1 對應。
install.sh 提供兩種 Finder 右鍵入口,都能幫任何圖片加框(不限檔名格式),加框後的 ... Bezel.png 存在原圖旁邊:
- 快速動作 — 對圖片按右鍵 →「快速動作」→「Add Bezel」。以 Automator workflow 形式安裝在
~/Library/Services/Add Bezel.workflow,Finder 預覽面板也能點。 - 打開檔案的應用程式 — 對圖片按右鍵 →「打開檔案的應用程式」→「Add Bezel」,或把圖片拖到
~/Applications/Add Bezel.app圖示上(用osacompile編譯的 AppleScript droplet)。
如果選單一開始沒出現,重新啟動 Finder 或登出再登入即可。
./add-bezel.sh # 掃描 ~/Desktop
./add-bezel.sh ~/Pictures # 掃描指定資料夾或單張合成:
./bezel-frame bezel.png 截圖.png 輸出.png- 執行記錄:
~/Library/Caches/add-bezel.log,每次掃描都會留一行(visible=看到幾張截圖 framed=這次加框幾張)。 - 若一直沒反應,檢查 LaunchAgent 狀態:
launchctl print gui/$(id -u)/com.add-bezel。
./uninstall.sh已加框的圖片不會被刪除。
MIT