Stash

A lightweight clipboard history manager for macOS, inspired by Windows' Win+V. Quickly access your clipboard history and emoji picker from a floating panel.

Features

Clipboard History — Automatically saves text, images (screenshots, photos), and files you copy
Global Hotkey — Press ⌘⇧V to open the clipboard panel from any app
Emoji Picker — Browse and search emojis by keyword
Search — Filter clipboard history by content
Pin Items — Pin frequently used clips so they're never pruned
Keyboard Navigation — Arrow keys to browse, Enter to paste, Esc to close
Menu Bar App — Lives in your menu bar, no dock icon
Launch at Login — Optional auto-start via Preferences
Persistent History — Clipboard history saved to disk across app restarts
Auto-Update — Checks GitHub Releases for new versions with one-click install

Requirements

macOS 14.0+

Installation

Download Stash.app.zip from the latest release, unzip it, and move Stash.app to /Applications.

Note: macOS will block unsigned apps the first time — see Gatekeeper Notice below. You'll also need to grant Accessibility permission.

Building from Source

If you'd prefer to build locally, see CONTRIBUTING.md for instructions. Requires Swift 5.9+ / Command Line Tools.

Gatekeeper Notice

Since Stash is ad-hoc signed (not notarized with an Apple Developer ID), macOS will block it the first time you open it. To allow it, run this in Terminal:

xattr -cr /Applications/Stash.app

Then open Stash normally. You only need to do this once (and again after each update).

Permissions

Stash requires Accessibility permission to paste into other apps:

Open System Settings > Privacy & Security > Accessibility
Click + and add /Applications/Stash.app
Toggle it on
Restart Stash if needed

Note: After an update, you may need to re-grant Accessibility permission since macOS ties it to the specific app binary. To do this, go to Accessibility settings, select Stash, click − to remove it, then click + to re-add Stash.app, and restart Stash.

Usage

Action	Shortcut
Open/close clipboard panel	`⌘⇧V`
Navigate items	`↑` / `↓`
Paste selected item	`Enter` or click
Close panel	`Esc`
Search	Start typing in the search field
Pin/Delete items	Right-click for context menu

Access Preferences and Quit from the menu bar icon.

Contributing

Found a bug or have a feature idea? Open an issue. Pull requests are welcome too — see CONTRIBUTING.md for details.

License

MIT

seligj95/stash