Buffer

A lightweight, beautiful clipboard manager for macOS

---

✨ Features

• 📋 Clipboard History — Automatically saves everything you copy (text & images)
• ⌨️ Global Hotkey — Instantly access history with ⇧⌘V (Shift + Command + V)
• 🔍 Powerful Search — Quickly find any copied item with real-time search
• 🖼️ Image Support — Copy and paste images seamlessly
• 📱 Menu Bar App — Lives in your menu bar, never in your way
• 🎨 Native macOS Design — Beautiful, minimal interface that feels right at home
• ⚡ Lightweight — Uses minimal system resources
• 🔒 Privacy First — All data stored locally, nothing leaves your Mac

---

📥 Download

Note: Buffer is not notarized with Apple Developer ID. On first launch:

1. Right-click on Buffer.app
2. Click Open
3. Click Open in the 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