Buffer

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
• Instant Access — Global hotkey ⇧⌘V opens history in a flash
• Native macOS Feel — Clean SwiftUI + AppKit menu-bar app
• Bookmarks — Star important items with Cmd+B for quick reuse
• 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)
4. Note (not yet notarized): Right-click → Open → confirm in security dialog

---

🚀 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

---

⌨️ Keyboard Shortcuts

Shortcut	Action
⇧⌘V	Open clipboard history
↑ / ↓	Navigate items
↵ Enter	Paste selected item
⎋ Esc	Close history window

---

🛠️ Building from Source

# 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

---

📁 Project Structure

Buffer/
├── BufferApp.swift          # App entry point
├── AppDelegate.swift        # App lifecycle & hotkey setup
├── Models/
│   └── ClipboardItem.swift  # Clipboard item data model
├── Services/
│   ├── ClipboardStore.swift    # Persistent storage
│   ├── ClipboardWatcher.swift  # Monitors clipboard changes
│   ├── HotkeyManager.swift     # Global keyboard shortcuts
│   └── PasteController.swift   # Paste functionality
└── Views/
    ├── HistoryWindow.swift      # Main history window
    ├── ClipboardListView.swift  # List of clipboard items
    ├── ClipboardItemRow.swift   # Individual item row
    ├── SearchField.swift        # Search component
    └── StatusBarController.swift # Menu bar controller

---

🤝 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.

---

Made with ❤️ for macOS