Shelf/README.md

1.5 KiB

Shelf

A clipboard manager for macOS. Hit Cmd+Shift+V or click the tray icon.

I just didn't feel like this was a thing that should cost money. Now it doesn't anymore.

Preview

B39A5D5D-60D0-4B77-AA18-BACEC7DA2C42

What it does

  • Monitors your clipboard — text, URLs, images
  • Cards show a preview, a title (file path with the filename bolded), and a timestamp
  • Re-copying something moves it to the front instead of duplicating it
  • Tracks where items were displaced from, so you can peek at old neighbors (click twice - not exactly double click, just... twice.)
  • Space bar opens native Quick Look on the selected card
  • Arrow keys to navigate, Return to paste, Delete to remove
  • Starts on login automatically
  • Lives in the menu bar, stays out of your way

Building

Needs Rust and Xcode command line tools.

bash build.sh

App lands in build/Shelf.app.

Installing

bash install.sh

Builds, kills any running instance, drops it into /Applications, opens it.

Debug build

bash debug.sh

Structure

core/       Rust — clipboard monitoring, SQLite storage, FFI exports
bridge/     C header bridging Rust to Swift
src/        Swift — UI, panel, app lifecycle
resources/  Icon SVG, Info.plist

Author

pszsh - My Half-Assed blog. Email: jess@else-if.org