Skip to content

Latest commit

 

History

History
121 lines (74 loc) · 5.18 KB

File metadata and controls

121 lines (74 loc) · 5.18 KB

ClipDock

ClipDock app icon

Recall, preview, pin, and reuse clipboard history on macOS.

macOS 13+ Local-first Open source

中文 · Official Website

ClipDock current shelf

The ClipDock screenshots in this README are captured from a real running macOS app window with sample clipboard content on a clean desktop background.

What It Is

ClipDock is a local-first clipboard shelf for macOS. It keeps recent text, links, colors, images, and files close at hand, then opens as a compact panel at the bottom of the screen when you need something back.

The app is built around a simple habit: bring up the shelf, recognize the right item, preview it if needed, and reuse it without switching into a heavy management window.

Clipboard history is stored locally on each desktop. No account or sync server is required.

Why ClipDock

Most clipboard work is small but frequent: a paragraph from a document, a link from the browser, a color value from a design file, a screenshot, or a file path you copied a few minutes ago. macOS keeps the latest item. ClipDock keeps the useful trail.

What You Can Do

  • Open without breaking flow
    Press Command + Shift + X to open the shelf from the bottom edge of the screen.

  • Use it entirely from the keyboard
    Move with arrow keys, search with Command + F, preview with Space, copy with Command + C, use Command + 1 through Command + 9 for visible clips, delete with Delete, and close with Esc.

  • Find recent copies quickly
    Scan recent clips visually, or search when the history grows.

  • Recognize content by type
    Text, rich text, links, colors, images, and files each get a dedicated card treatment.

  • Preview before reuse
    Open a focused preview for text, links, colors, images, and files before reusing them.

  • Pin reusable material
    Save important clips into Pinboards so they do not get buried in short-lived clipboard history.

A More Natural Clipboard

Clipboard history should feel like part of the desktop, not a separate place you have to manage. ClipDock stays low, visual, and quick enough for daily use across writing, development, research, design, communication, and documentation.

The goal is not to archive everything forever. It is to make the things you just copied easy to find, easy to confirm, and easy to reuse.

Preview And Pinboards

The shelf combines search, Pinboard shortcuts, and typed content cards in one horizontal workspace. You can move through recent clips without opening a full library view, and the core flow works from the keyboard.

Preview is part of the core interaction. Text stays readable, images show the real image, files expose a document preview, colors render as swatches, and links can show page metadata. The GitHub card in the screenshot is backed by a ready Open Graph preview for https://github.com/.

ClipDock preview popover

ClipDock pinboard filter

Pinboards separate durable material from short-lived history. Product notes, design references, release text, customer documents, and team knowledge can stay one click away.

Settings support the workflow without becoming the product surface. General behavior, privacy rules, keyboard shortcuts, and about information are kept in focused pages behind the main shelf.

Privacy

Clipboard history stays on your device. Link previews and update checks may access the network; clipboard records are not uploaded for cross-device synchronization.

Install

Visit the official website for the current product introduction and release information: https://clip.run.ci/.

Download the latest release, drag ClipDock into Applications, then press Command + Shift + X to open the shelf.

If macOS says Apple cannot verify ClipDock the first time you open it, follow the ordinary-user guide: First-open help.

Public release packages will be published with the first GitHub release.

Open Source

ClipDock is open source because clipboard tools are personal infrastructure. You should be able to inspect how it works, run it locally, and help shape a tool that sits close to everyday work.

Developer Notes

Requirements

  • macOS 13.0 or later
  • Xcode command line tools
  • Swift 6.1 toolchain
  • Rust stable toolchain

Run The macOS App From Source

cd macOS
scripts/build-rust-core.sh
swift run ClipDock

The source executable and release product are both named ClipDock.

Common Verification

cd macOS && swift test
cd macOS && cargo test --manifest-path rust/Cargo.toml