A lightweight, beautiful clipboard manager for macOS
---
### ✨ Why Buffer?
- **Ultra-lightweight** — Only ~2 MB download/install, minimal RAM/CPU usage
- **100% Private & Local** — Everything stays on your Mac, no cloud, no tracking
- **Text + Images + OCR** — Copies anything; extracts searchable text from images/screenshots/memes using on-device Vision
- **Great for developers** — Handles large text snippets, JSON payloads, logs, and other verbose content with ease
- **Large-content friendly** — Lazy, chunked previews and disk-backed storage for multi‑MB text, with size indicators
- **Pins & Smart History** — Pin favorites, keep them anchored, and cycle history while prioritizing unpinned items
- **Multi-select & multi‑paste** — Select multiple items in history with clear on-screen instructions, paste them together, or bulk-delete with inline confirmation
- **Bookmarks** — Star important items with Cmd+B for quick reuse
- **Tags & Filtering** — Categorize history items with custom, color-coded tags. Quick tag items with `Cmd+T` and filter using `#` autocomplete in the search bar
- **Configurable hotkeys** — Change the global shortcut in Settings with dynamic re-registration
- **Native macOS Feel** — Clean SwiftUI + AppKit menu-bar app
- **Seamless Updates** — Built-in secure auto-updater with code signature verification and a native post-update HUD with a "What's New" link
- **Inline Text Editing** — Edit any text or code snippet directly within the clipboard history window with auto-save and macOS pasteboard sync
- **Open Source** — MIT license, actively maintained
---
### 📥 Download
1. Download the `.dmg` from the latest release
2. Drag **Buffer.app** to your **Applications** folder
3. Launch it (lives in menu bar)
---
## 🚀 Getting Started
1. **Download** the `.dmg` file from above
2. **Drag** Buffer to your Applications folder
3. **Launch** Buffer — it will appear in your menu bar
4. **Copy** anything — Buffer automatically saves it
5. Press **⇧⌘V** to access your clipboard history anytime!
---
## 🖥️ Screenshots
Beautiful split-pane interface with search and preview
#### Edit Text
#### Multi select & paste
#### Tags
#### Inline Text Editing
Click the **Pencil icon** in the preview/detail pane to open an inline text editor and modify any text item directly. While editing, global keyboard shortcuts are **temporarily bypassed** so you can type normally. Press **Escape**, click the pencil icon again, or select a different item to **auto-save** your changes and sync them to the system pasteboard.
---
## ⌨️ Keyboard Shortcuts
| Shortcut | Action |
|----------|--------|
| `⇧⌘V` | Open clipboard history |
| `↑` / `↓` | Navigate items |
| `⇧↑` / `⇧↓` | Expand selection (Multi-select) |
| `↵` Enter | Paste selected item |
| `⌘C` | Copy selected item text to clipboard |
| `⌘P` | Pin / unpin selected item |
| `⌘B` | Bookmark / unbookmark selected item |
| `⌘T` | Add tag to selected item |
| `⌘S` | Save image to disk (for image items) |
| `⌘⌫` | Delete selected item |
| `⎋` Esc | Close history window |
### 📝 Inline Text Editing
Text items can be edited directly within Buffer by clicking the **Pencil icon** in the preview/detail pane, which opens an inline text editor. While editing:
- **Global keyboard shortcuts are temporarily bypassed** so you can type normally without triggering shortcuts.
- Press **Escape**, click the **pencil icon** again, or **select a different item** in the list to **auto-save** your changes and sync them to the macOS pasteboard.
---
## 🛠️ Building from Source
```bash
# Clone the repository
git clone https://github.com/samirpatil2000/Buffer.git
cd Buffer
# Open in Xcode
open Buffer.xcodeproj
# Build and run
# Press ⌘R in Xcode
```
### Requirements
- macOS 13.0 or later
- Xcode 15.0 or later
- Swift 5.9
---
## Star History
---
## 🤝 Contributing
Contributions are welcome! Feel free to:
- Report bugs
- Suggest features
- Submit pull requests
---
## 📄 License
MIT License — feel free to use this project however you like.
---
