Clipbara

mobravaGPL-3.0活跃维护

面向 macOS 和 iPhone 的开源剪贴板管理器,用卡片式历史、Pinboards 和 Quick Look 管理复制内容,可选 iCloud 同步。

Open-source clipboard manager for macOS and iPhone. Card-style history, Pinboards, Quick Look, and optional iCloud sync. Free DMG and Homebrew builds, one-time purchase on the App Store.

v1.5.2发布于 2026-11-08 01:45 UTC258star +1 / 7 天30fork同步于 2026-11-10 12:03 UTC

怎么上手

由 README 提炼,执行前请确认
brew install --cask mobrava/tap/clipbara
硬件要求按 README 说明

macOS 14 Sonoma 或更高;iPhone 应用需 iOS 26 或更高。README 未提及 GPU 或显存要求。

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

macOS 剪贴板历史管理器,卡片式历史加 Pinboards,还带 iPhone 配套应用

面向 macOS 和 iPhone 的开源剪贴板管理器,用卡片式历史、Pinboards 和 Quick Look 管理复制内容,可选 iCloud 同步。

核心能力

  • 按 ⌘⇧V 弹出面板,不抢当前应用焦点
  • 支持文本、富文本、HTML、图片、链接、文件和颜色
  • 用 Pinboards 收藏常用片段,可在面板间移动
  • 面板内按空格 Quick Look 预览,⌘E 直接编辑文本
  • 可选 iCloud 同步,历史与 Pinboards 同步到 iPhone

容易踩的坑

App Store 版与 DMG 版 bundle ID 不同、历史各自独立,需用导出/导入迁移;两版不要同时运行,否则 ⌘⇧V 会注册两次并弹出两个面板;粘贴到当前应用仅 DMG 版支持,且需授予辅助功能权限。

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v1.5.2
  1. v1.5.2最新正式版2026-11-08 · 2026-11-08 01:45 UTC

    Clipbara v1.5.2

    Install

    Homebrew:

    brew install --cask mobrava/tap/clipbara
    

    Manual: Download Clipbara-1.5.2.dmg below.


    SHA256: f951f39384b8b5555d634e3c7ab2814d6acfcaf5e83ff8197e8b3bd83d86085d

    Full Changelog: https://github.com/mobrava/Clipbara/compare/v1.5.1...v1.5.2

  2. v1.5.12026-10-23 · 2026-10-23 09:39 UTC
    查看更新说明

    Clipbara v1.5.1

    Install

    Homebrew:

    brew install --cask mobrava/tap/clipbara
    

    Manual: Download Clipbara-1.5.1.dmg below.


    SHA256: 01ef08ec5d4198ec0496983d0f1ba7dacfa57fa44cc9efc8680556d4dfa951c5

    Full Changelog: https://github.com/mobrava/Clipbara/compare/v1.5...v1.5.1

  3. v1.52026-10-05 · 2026-10-05 23:50 UTC
    查看更新说明

    Clipbara v1.5

    Install

    Homebrew:

    brew install --cask mobrava/tap/clipbara
    

    Manual: Download Clipbara-1.5.dmg below.


    SHA256: 063951edb5fc7f5d3a863e3d2fc537d885d258965085f7ce806a8a5c69fd9806

    What's Changed

    Full Changelog: https://github.com/mobrava/Clipbara/compare/v1.3.2...v1.5

  4. v1.3.22026-09-24 · 2026-09-24 07:55 UTC
    查看更新说明

    Clipbara v1.3.2

    Install

    Homebrew:

    brew install --cask mobrava/tap/clipbara
    

    Manual: Download Clipbara-1.3.2.dmg below.


    SHA256: 7a1edd3b21353c5fa3d87454c83bacef008c6ef0e5f79f95ec51ebd05614d942

    What's Changed

    Full Changelog: https://github.com/mobrava/Clipbara/compare/v1.3.1...v1.3.2

  5. v1.3.12026-09-02 · 2026-09-02 14:38 UTC
    查看更新说明

    Bug fix release.

    • The panel now opens on the display you are working on. On multi-display setups it could slide in on whichever screen last held focus, and with a display stacked below the primary one it could stay stuck there. Thanks to @tnaseem for the report (#20).
    • The first shortcut press after launch opens the panel. It used to take up to three presses, because the panel and its view were still being built when the first press arrived.
    • The reveal animation now plays from the start instead of appearing part way through.
    • Pinboard tabs no longer show a horizontal scrollbar.

    Install

    brew install --cask mobrava/tap/clipbara
    

    Or download Clipbara-v1.3.1.dmg below. Existing users will be offered the update automatically.

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    https://github.com/user-attachments/assets/60db2f4c-fbe4-41d0-9bda-416b791c5c46

    Clipbara keeps a history of what you copy. Press ⌘ ⇧ V and a panel slides up at the bottom of the screen without pulling focus from the app you are in. Click a clip once and it is back on your clipboard.

    It runs on macOS 14 Sonoma or later. The DMG and Homebrew builds are free. The Mac App Store build is free to try for 7 days, then a one-time purchase that also unlocks Clipbara for iPhone. With iCloud sync turned on, your history and Pinboards follow you to the iPhone.

    Install

    Mac App Store

    Download Clipbara on the Mac App Store

    Homebrew

    brew install --cask mobrava/tap/clipbara
    

    Direct download

    Download the latest .dmg from Releases, open it, and drag the app into Applications. The DMG is signed with an Apple Developer ID and notarized by Apple as of v1.1.11, so it opens without a security warning.

    Both are built from this repository. The App Store build is free to try for 7 days and then a one-time purchase, is sandboxed, and updates through the App Store. If you bought it before version 1.5 or got it during the free week, it stays unlocked. The DMG build is free and updates itself through Sparkle. Both get each release on the same day.

    The two differ in a few features:

    • iCloud sync, and with it the iPhone app, is in the App Store build only.
    • Pasting into the active app is in the DMG build only. It needs Accessibility permission, which Apple does not allow App Store apps to use for this.

    The two use different bundle identifiers, so they keep separate histories. To carry your clips across, open Settings > General > Backup > Export in one build and Import in the other. Existing clips are kept and duplicates are skipped.

    Run only one of them. Two copies register ⌘ ⇧ V twice and open two panels.

    Usage

    1. Copy anything with ⌘ C as usual.
    2. Press ⌘ ⇧ V to open the history panel.
    3. Type to search, or move between clips with ← and →.
    4. Click a clip once, or press Return. The clip goes to your clipboard and the panel closes.
    5. Press ⌘ V in the app you were using.

    In the DMG build you can skip step 5: turn on Settings > Pasting > Paste into the Active App. See the FAQ for the permission it needs.

    Inside the panel:

    • Space opens and closes Quick Look for the clip under the pointer, or the selected one
    • ⌘ E edits the text of a text clip
    • Delete removes the selected clip (on a Pinboard tab, from that Pinboard only), and ⌘ Z brings it back
    • ⌘ 1 to ⌘ 9 switch between History and Pinboards. Hold ⌘ to see the numbers
    • ⌘ , opens Settings
    • Esc clears the search, steps back, or closes the panel
    • ⌘ ⇧ ⌫ clears unpinned history
    • Holding ⇧ while pasting flips plain-text pasting for that one paste
    • Right-clicking a clip lets you rename it, edit its text, add it to or move it between Pinboards, or delete it
    • Dragging a Pinboard tab reorders it

    Both global shortcuts and the Quick Look key can be changed in Settings > Shortcuts.

    iPhone

    Clipbara for iPhone is the same App Store purchase as the Mac app. It needs iOS 26 or later.

    • Sync. Turn on iCloud Sync in Settings on both: under General on the Mac, and in the Sync section on the iPhone. Clips, titles, and Pinboards sync both ways through your own iCloud. Pull the list down to sync right away.
    • Keyboard. Add the Clipbara keyboard in Settings > Apps > Clipbara > Keyboards, then switch to it with the globe key and tap a clip to insert it in any app. It has no letter keys. It works without Full Access, which it uses only to fetch the newest clips from iCloud while the app is closed.
    • Saving on the iPhone. iOS does not let apps read the clipboard in the background, so the iPhone saves a clip when you tap the Paste button in Clipbara, or when you share something to Clipbara from another app.

    Features

    • Text, rich text, HTML, images, links, files, and colors
    • Optional iCloud sync with Clipbara for iPhone (App Store build)
    • Search by content or title, with filters for type and date
    • Pinboards for the clips you keep reusing, with clips movable between them
    • Quick Look preview without leaving the panel, and text editing inside it
    • Paste as plain text, always or per paste
    • Optional pasting into the active app (DMG build)
    • Clip Queue: copy several things, then paste them back in order with ⌘ V
    • clipbara://open, clipbara://toggle, and clipbara://queue links for launchers such as Raycast, Alfred, or Shortcuts
    • A hideable menu bar icon, and a panel that can open without animation
    • English, Korean, and Simplified Chinese
    • Excluded apps, so a password manager never reaches the history
    • History limit by count or age, appearance, and launch at login
    • JSON export and import for moving between machines or builds

    Screenshots

    Privacy

    History is stored on your Mac with SwiftData. It leaves the Mac only if you turn on iCloud sync in the App Store build, and then it goes to your own private iCloud database, not to a server of ours. Sync is off until you turn it on. No account, no server, no analytics.

    Everything except sync works offline. The DMG build reaches the network for one thing, Sparkle update checks, and the App Store build ships without an updater.

    Add a password manager, or any other app, under Settings > Privacy > Excluded Apps and nothing copied from it is recorded.

    The DMG build needs Accessibility permission only if you turn on pasting into the active app, which presses ⌘ V in other apps. Nothing else uses it. Clip Queue needs no permission: it notices a paste when the other app reads the clipboard.

    FAQ

    Why doesn't Clipbara paste into the app for me?

    By default, picking a clip puts it on the clipboard and closes the panel, and you press ⌘ V yourself. In the DMG build, turn on Settings > Pasting > Paste into the Active App and Clipbara presses ⌘ V for you. That needs Accessibility permission in System Settings > Privacy & Security > Accessibility, and Settings shows whether it is on.

    The App Store build doesn't have this option. Pressing a key in another app needs Accessibility permission, and App Review does not allow App Store apps to use it for anything other than accessibility.

    I hid the menu bar icon. How do I get back to Settings?

    Open Clipbara again from Applications or Spotlight while it runs, and Settings opens. You can also press ⌘ , in the panel, or choose Settings… from its … menu.

    If the icon doesn't reappear after you turn it back on, check the hidden section of your menu bar manager (Bartender, Ice, Thaw, and similar). A returning icon can land there.

    Can I sync with the DMG build?

    No. Sync is part of the App Store build only. To move your history from the DMG build into the App Store build, use Settings > General > Backup > Export and Import.

    Why does iOS warn about Full Access for the keyboard?

    iOS shows the same warning for every keyboard that asks for Full Access, because a keyboard with it could send what you type somewhere. The Clipbara keyboard has no letter keys, so you never type with it. Full Access only lets it read your own clips from iCloud while the app is closed, and the keyboard works without it.

    The shortcut does not open the panel

    Another app may already hold ⌘ ⇧ V. Record a different combination in Settings > Shortcuts.

    Images do not paste in my terminal

    Selecting an image clip puts the image back on the macOS clipboard, but a shell prompt cannot accept image data. The program running inside the terminal has to support it, and the shortcut is often not ⌘ V. Codex CLI, for example, attaches the clipboard image with Control V: press ⌘ ⇧ V, pick the image, go back to Codex without copying anything else, then press Control V.

    Where does the history live, and how do I remove it?

    The DMG build stores it in ~/Library/Application Support/com.minsang.PasteClip. The App Store build is sandboxed, so it stores it in ~/Library/Containers/com.minsang.Clipbara. Deleting that folder deletes the history. If sync is on, Delete iCloud Data… in the Sync settings removes the copy in iCloud as well.

    To uninstall, drag the app to the Trash, or run brew uninstall --cask mobrava/tap/clipbara if you installed it with Homebrew.

    Wasn't this called PasteClip?

    It was, until August 2026. An unrelated app on the Mac App Store already used that name. Releases up to v1.1.11 still ship as PasteClip, and old links redirect on their own.

    Build from source

    Requires macOS 14 or later, Xcode 16 or later, and XcodeGen.

    git clone https://github.com/mobrava/Clipbara.git
    cd Clipbara
    brew install xcodegen
    xcodegen generate
    open Clipbara.xcodeproj
    

    Build and run the Clipbara scheme with ⌘ R. The iPhone app is the ClipbaraiOS scheme and needs Xcode 26. The app is Swift 6 with strict concurrency on, SwiftUI hosted inside an AppKit NSPanel, and SwiftData for storage. Global shortcuts come from KeyboardShortcuts, and DMG updates from Sparkle.

    Motivation

    I wanted the card-style clipboard history that Paste has, without the subscription. The code and the DMG build stay free here. The App Store build is a one-time purchase, after a 7-day trial, for anyone who wants iPhone sync and updates through the App Store, or who wants to support the work.

    A clipboard manager sees everything you copy, including the things you would rather it did not. That is reason enough to be able to read the code that touches it.

    Contributing

    Issues and pull requests are welcome. CONTRIBUTING.md covers the CLA that the dual licensing requires, and CODE_OF_CONDUCT.md applies.

    License

    Clipbara is available under the GNU General Public License v3.0.

    The Mac App Store edition is distributed by the copyright holder under a separate proprietary license (dual licensing). The source code for both editions lives in this repository.