[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-79156":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":9,"totalLinesOfCode":9,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":9,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":9,"rankLanguage":9,"license":9,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":22,"hasPages":22,"topics":9,"createdAt":9,"pushedAt":9,"updatedAt":24,"readmeContent":25,"aiSummary":26,"trendingCount":16,"starSnapshotCount":16,"syncStatus":27,"lastSyncTime":28,"discoverSource":29},79156,"capcap","realskyrin\u002Fcapcap","realskyrin","⌘⌘ - A lightweight, native macOS screenshot tool that lives in your menu bar. Double-tap ⌘ Command to capture any region of your screen — instantly copied to clipboard, or annotate first with pen and mosaic tools.",null,"https:\u002F\u002Fgithub.com\u002Frealskyrin\u002Fcapcap","Swift",518,39,5,9,0,37,82,192,111,8.81,false,"main","2026-06-12 02:03:49","# capcap\n\n![capcap](images\u002Fapp-banner.png)\n\n[简体中文](README.zh-CN.md)  ·  [繁體中文](README.zh-TW.md)\n\n**The fastest way to grab, mark up, and share screenshots on macOS.** Double-tap `⌘` from anywhere — snap to a window, drag a region, scroll-stitch a long page, then annotate and beautify in one tight floating window. Lives in your menu bar. No Dock icon, no telemetry, no subscription, no third-party dependencies. Bring your own object storage if you want a one-click cloud URL.\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"images\u002Feditor.png\" alt=\"capcap annotation editor — arrows, numbered callouts, mosaic, highlighter and text layered on a screenshot in a single floating toolbar\" width=\"760\" \u002F>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Frealskyrin\u002Fcapcap\u002Freleases\u002Flatest\">\u003Cb>Download Latest Release\u003C\u002Fb>\u003C\u002Fa>  · \n  \u003Ca href=\"#install-with-homebrew\">Install with Homebrew\u003C\u002Fa>  · \n  macOS 14+  ·  Universal (Apple Silicon + Intel)\n\u003C\u002Fp>\n\n## Why capcap\n\n- **One shortcut, zero friction.** Double-tap `⌘` anywhere and capcap is on screen in milliseconds — or record any global hotkey you like.\n- **Snap-to-window or pixel-perfect region.** Hover any window for a one-click capture, or drag a region with full Retina output across every connected display.\n- **A real annotation editor.** Arrows, numbered callouts, text, mosaic, highlighter, pen — all editable, draggable, rotatable and undoable *after* you place them.\n- **Scroll-stitch long content.** Capture a scrolling area, watch the stitched preview live, and keep editing the merged result.\n- **Beautify and pin.** Wrap shots in gradient or wallpaper backgrounds with rounded corners and shadow, or pin the final image floating above any window.\n- **Edit Finder images too.** Select a single image file in Finder and trigger the same shortcut to load it straight into the editor — the original is never touched.\n- **Menu bar history.** Recent screenshots and picked colors are one click away from re-copying — local-only, configurable size.\n- **One-click upload to your own image host.** Optional: configure Tencent COS, Qiniu Kodo, or Aliyun OSS once and the editor's upload button copies a public URL straight to your clipboard. Credentials stay on your Mac.\n- **Built with pure AppKit.** No SwiftUI, no Electron, no telemetry. Small, fast, and respectful of macOS.\n\n## Showcase\n\n\u003Ctable>\n\u003Ctr>\n  \u003Ctd width=\"50%\" align=\"center\">\n    \u003Cimg src=\"images\u002Fwindow-snap.png\" alt=\"Smart window detection — green dashed bounds snap to an app window\" \u002F>\u003Cbr\u002F>\n    \u003Csub>\u003Cb>Snap to any window in one click\u003C\u002Fb>\u003Cbr\u002F>No precise dragging — capcap detects window bounds for you.\u003C\u002Fsub>\n  \u003C\u002Ftd>\n  \u003Ctd width=\"50%\" align=\"center\">\n    \u003Cimg src=\"images\u002Fhistory.png\" alt=\"Menu bar history with screenshot thumbnails and picked color hex codes\" \u002F>\u003Cbr\u002F>\n    \u003Csub>\u003Cb>History at the menu bar\u003C\u002Fb>\u003Cbr\u002F>Re-copy any recent screenshot or picked hex color in a click.\u003C\u002Fsub>\n  \u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n  \u003Ctd width=\"50%\" align=\"center\">\n    \u003Cimg src=\"images\u002Fscroll-stitch.png\" alt=\"Scroll capture stitching a long page into a single tall screenshot with live preview\" \u002F>\u003Cbr\u002F>\n    \u003Csub>\u003Cb>Scroll-stitch long pages\u003C\u002Fb>\u003Cbr\u002F>Scroll inside the selection, watch frames merge live, and keep editing the result.\u003C\u002Fsub>\n  \u003C\u002Ftd>\n  \u003Ctd width=\"50%\" align=\"center\">\n    \u003Cimg src=\"images\u002Fbeautify.png\" alt=\"Beautify mode wrapping a screenshot in a gradient background with rounded corners and shadow\" \u002F>\u003Cbr\u002F>\n    \u003Csub>\u003Cb>Beautify in one click\u003C\u002Fb>\u003Cbr\u002F>Gradient or wallpaper backgrounds, rounded corners, shadow and padding — all adjustable.\u003C\u002Fsub>\n  \u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n  \u003Ctd colspan=\"2\" align=\"center\">\n    \u003Cimg src=\"images\u002Fimage-hosting.png\" alt=\"Settings panel showing Tencent COS, Qiniu Kodo, and Aliyun OSS image-host providers, with Aliyun OSS marked as default\" width=\"520\" \u002F>\u003Cbr\u002F>\n    \u003Csub>\u003Cb>Bring-your-own image host\u003C\u002Fb>\u003Cbr\u002F>Configure Tencent COS, Qiniu Kodo, or Aliyun OSS once — upload the current screenshot and copy its public URL with a single click.\u003C\u002Fsub>\n  \u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftable>\n\n## Features\n\n- **Edit any image directly** — select a single image file in Finder (Desktop or any window) and trigger the screenshot shortcut to open that image in the annotation editor instead of taking a screenshot. The original file is never modified; the edited result goes to the clipboard and history like a normal capture.\n- **Fast region and window capture** — drag any area, or hover and click a detected window to snap to its bounds.\n- **Multi-display support** — creates overlays on every connected screen and captures at full Retina resolution.\n- **Full annotation editor** — rectangle, ellipse, arrow, pen, highlighter, mosaic, numbered callouts, and text.\n- **Editable annotations** — move existing marks, change color and size, rotate supported annotations, bend arrows\u002Fcallouts, edit text, delete marks, and use undo\u002Fredo.\n- **Scroll capture** — capture a selected scrolling area, preview the stitched image live, and merge it back into the editor.\n- **Beautify mode** — wrap screenshots in rounded corners, soft shadow, gradient presets, wallpaper background, and adjustable padding.\n- **Color picker** — use the macOS color sampler, copy the picked hex value, and keep it in history.\n- **Pin to screen** — float the current screenshot above other windows as a draggable reference image.\n- **Save or copy** — save as PNG, confirm to copy PNG\u002FTIFF data to the clipboard, or cancel without output.\n- **Recent history** — menu bar history with thumbnails and picked colors for quick re-copy, with a configurable cache size.\n- **Image-host upload** — optional one-click upload to Tencent COS, Qiniu Kodo, or Aliyun OSS; the public URL is copied to the clipboard and stored alongside the thumbnail in History. Credentials live only in your local UserDefaults; pick one provider as the default and the editor's upload button lights up.\n- **Custom trigger** — use the default double-tap `⌘`, or record a custom global shortcut in Settings.\n- **Settings and localization** — Chinese\u002FEnglish UI, menu bar icon toggle, launch at login, demo mode, permission status, shortcut recording, and history cache size.\n- **Menu bar app** — runs as an agent app without a Dock icon.\n\n## Requirements\n\n- macOS 14.0+\n- Accessibility permission, used for the default double-tap `⌘` trigger\n- Screen Recording permission, used by ScreenCaptureKit and screenshot capture\n- Automation permission for Finder, requested on first use of the \"edit selected image\" shortcut\n\nOn first launch, capcap opens a setup window that shows both permission states. The app can launch once both required permissions are granted.\n\n## Install with Homebrew\n\nThis repository ships a Homebrew cask at `Casks\u002Fcapcap.rb`.\n\nBecause the repository name is `capcap` rather than `homebrew-capcap`, tap it with an explicit URL:\n\n```bash\nbrew tap realskyrin\u002Fcapcap https:\u002F\u002Fgithub.com\u002Frealskyrin\u002Fcapcap\nbrew install --cask capcap\n```\n\nSee [docs\u002Fhomebrew.md](docs\u002Fhomebrew.md) for the release\u002Fupdate workflow.\n\n## Build from Source\n\n```bash\n# Build and bundle build\u002Fcapcap.app\n.\u002Fscripts\u002Fbundle.sh\n```\n\nFor local development, this script rebuilds the app, kills any running instance, launches the new bundle, and verifies that it started:\n\n```bash\nbash scripts\u002Frebuild-and-open.sh\n```\n\nTo package a draggable DMG:\n\n```bash\nscripts\u002Fpackage-dmg.sh\n```\n\nThe app bundle is output to `build\u002Fcapcap.app`; DMGs are output to `dist\u002F`.\n\n## Usage\n\n1. Double-tap `⌘ Command`, press your custom shortcut, or choose **Take Screenshot** from the menu bar.\n2. Hover a window and click to capture it, or drag to select any region.\n3. Use the floating toolbar to annotate, pick a color, start scroll capture, beautify, save, pin, cancel, or confirm.\n4. Click the green checkmark or press `Enter` to copy the final image to the clipboard. Press `Esc` or click `x` to cancel.\n\nTo edit an existing image instead of taking a screenshot, click a single image file in Finder (so it's the current Finder selection), then trigger the same shortcut. capcap copies the file into a temporary working location and opens it in the editor with the toolbar already up. If anything other than exactly one image is selected, the shortcut behaves as a normal screenshot trigger.\n\n## Editor Tools\n\n| Tool | What it does |\n|------|--------------|\n| Rectangle \u002F Ellipse | Draw outlined shapes with selectable colors and stroke widths |\n| Arrow | Draw straight arrows; select an arrow later to move endpoints or bend the shaft |\n| Pen | Draw smoothed freehand strokes |\n| Highlighter | Draw semi-transparent marker strokes without darkening overlaps |\n| Mosaic | Brush pixelated regions over sensitive content, with adjustable block size |\n| Numbered | Add incrementing callout badges; drag while placing to add an arrow |\n| Text | Add editable single-line text with color and 10-100 pt size controls |\n| Eyedropper | Pick any screen color and copy its `#RRGGBB` value |\n| Undo \u002F Redo | Revert and restore editor changes |\n| Move Selection | Drag the whole selected screenshot region after selection |\n| Scroll Capture | Scroll inside the selected area, stitch frames, and continue editing the merged result |\n| Beautify | Add gradient or wallpaper backgrounds, rounded corners, shadow, and padding |\n| Save | Save the current result as a PNG |\n| Pin | Keep the current result floating above other windows |\n| Upload | Upload the current result to the configured image host and copy the public URL |\n| Confirm | Copy the final result to the clipboard |\n\nWhen an annotation is selected, capcap shows adjustment handles where supported: rotation for shapes, strokes, and text; curve handles for arrows and numbered callouts; endpoint handles for arrows; and edit\u002Fdelete actions for text and selected annotations.\n\n## Settings\n\nOpen Settings from the menu bar to configure:\n\n- Language: Chinese or English\n- Menu bar icon visibility\n- Launch at login\n- Demo Mode, which allows external screen recorders to capture capcap's overlay and editor\n- Screenshot shortcut: keep double-tap `⌘`, record a custom shortcut, or restore the default\n- History cache size, from 5 to 20 recent screenshots\u002Fcolors\n- Image-host upload: enable Tencent COS, Qiniu Kodo, or Aliyun OSS, fill in their credentials, and pick which one is the default for the editor's upload button\n- Accessibility and Screen Recording permission shortcuts\n\n## History\n\nThe menu bar **History** submenu stores recent screenshots and picked colors in `~\u002FLibrary\u002FApplication Support\u002Fcapcap\u002FHistory`. Click an image entry to copy it back to the clipboard, click a color entry to copy its hex value, or clear the full history from the submenu.\n\n## macOS Verification Warning\n\nIf macOS shows a warning like `Apple cannot verify \"capcap\" is free of malware`, remove the quarantine flag from the app bundle you trust, then open it again:\n\n```bash\nxattr -dr com.apple.quarantine \u002FApplications\u002Fcapcap.app\n```\n\nIf you are running a locally built copy instead of the app in `\u002FApplications`, replace the path with your actual app location, for example:\n\n```bash\nxattr -dr com.apple.quarantine .\u002Fbuild\u002Fcapcap.app\n```\n\nOnly do this for builds downloaded from this repository or ones you built yourself.\n\n## Project Structure\n\n- `capcap\u002FApp\u002F` — app entry point, delegate, and bundle metadata\n- `capcap\u002FCapture\u002F` — overlay, selection, window detection, ScreenCaptureKit capture, scroll stitching, clipboard, and history\n- `capcap\u002FEditor\u002F` — annotation models, editor canvas, floating toolbar, beautify rendering, mosaic, scroll preview, and pin windows\n- `capcap\u002FTrigger\u002F` — double-tap `⌘` monitor and custom Carbon hotkey registration\n- `capcap\u002FUI\u002F` — menu bar controller, toast, cursor chip, and tooltips\n- `capcap\u002FSettings\u002F` — startup\u002Fsettings window and preferences UI\n- `capcap\u002FUpload\u002F` — image-host providers (Tencent COS, Qiniu Kodo, Aliyun OSS), HMAC signing, progress-tracking HTTP wrapper, and the floating upload chip\n- `capcap\u002FUtilities\u002F` — defaults, localization, and launch-at-login support\n- `scripts\u002F` — compile check, bundle, rebuild\u002Fopen, icon, DMG, and Homebrew cask helpers\n\n## Development\n\n```bash\n# Fast compile validation for Swift-affecting changes\nbash scripts\u002Fcompile-check.sh\n\n# Build, restart, and verify the local app\nbash scripts\u002Frebuild-and-open.sh\n```\n\n## Acknowledgments\n\nThanks to the [Linux.do](https:\u002F\u002Flinux.do) community for testing, feedback, and discussion.\n\n## Third-Party Licenses\n\n- [PermissionFlow](https:\u002F\u002Fgithub.com\u002Fjaywcjlove\u002FPermissionFlow) is licensed under the MIT License. See [ThirdParty\u002FPermissionFlow\u002FLICENSE](ThirdParty\u002FPermissionFlow\u002FLICENSE).\n\n## License\n\n[MIT](LICENSE)\n","capcap 是一款轻量级的 macOS 截图工具，驻留在菜单栏中。通过双击 Command 键即可快速截取屏幕任意区域，并立即复制到剪贴板或使用内置的笔和马赛克工具进行标注。其核心功能包括智能窗口捕捉、像素级区域选择、丰富的标注编辑器（支持箭头、编号标记、文本、马赛克、高亮和画笔等）、长页面滚动拼接以及自定义美化选项。此外，capcap 还提供了一键上传至用户自定义对象存储的功能。这款工具适用于需要高效截图及编辑后分享的场景，如撰写文档、制作教程或在线协作等。它完全采用 AppKit 构建，无第三方依赖，确保了应用的小巧与快速响应。",2,"2026-06-11 03:57:30","trending"]