Clippy

Never lose copied text again.
A powerful clipboard manager for Chrome that automatically saves everything you copy.

Features • Installation • Usage • Shortcuts • Privacy

---

✨ Features

Core Functionality

• Automatic Clipboard Capture — Everything you copy is saved automatically
• Instant Search — Find any clip with fuzzy search
• One-Click Copy — Click any item to copy it back to your clipboard
• Context Menu Integration — Right-click in any text field to paste from history

Organization

• Smart Folders — Auto-sort clips by type (text, links, code, emails)
• Custom Folders — Create your own folders with color coding
• Tags — Add custom tags to organize and filter clips
• Favorites — Star important clips for quick access
• Drag & Drop — Easily move items between folders

Templates

• Reusable Templates — Save frequently used text snippets
• Dynamic Variables — Use placeholders like {{date}}, {{time}}, {{clipboard}}
• Quick Insert — Access templates from the dedicated panel

Productivity

• Bulk Operations — Select multiple items to move, delete, or favorite
• Text Transformations — Convert to uppercase, lowercase, title case, and more
• Multiple View Modes — Switch between default, compact, and grid views
• Statistics — Track your clipboard usage with detailed stats

Privacy & Security

• PIN Protection — Lock your clipboard history with a PIN
• Incognito Mode — Temporarily pause clipboard capture
• Sensitive Data Detection — Auto-detect and flag sensitive content
• Excluded Domains — Block specific websites from being captured
• Auto-Expire — Automatically delete old clips after a set period

Import & Export

• Multiple Formats — Export to JSON, CSV, or Markdown
• Backup & Restore — Import your clipboard history from backups

Customization

• Dark Mode — Easy on the eyes with an automatic dark theme
• Collapsible Sidebar — Hide folders when you need more space
• Configurable Storage — Set maximum items and auto-expire duration

---

🚀 Installation

From Chrome Web Store

1. Visit the Chrome Web Store listing (coming soon)
2. Click "Add to Chrome"
3. Click "Add extension" to confirm

Manual Installation (Developer Mode)

1. Download or clone this repository
2. Open Chrome and go to chrome://extensions/
3. Enable "Developer mode" in the top right
4. Click "Load unpacked"
5. Select the clippy folder

---

📖 Usage

Basic Usage

1. Copy text from any webpage using Ctrl+C (or Cmd+C on Mac)
2. Click the extension icon in your browser toolbar to view history
3. Click any item to copy it back to your clipboard
4. Right-click in any text field to paste directly from history

Organizing Clips

• Create folders: Click the + button in the sidebar
• Move items: Drag and drop clips to folders
• Add tags: Click the tag icon on any clip
• Star favorites: Click the star icon on any clip

Using Templates

1. Open the Templates panel from settings
2. Click "Create Template"
3. Enter a name and content (use {{variables}} for dynamic content)
4. Click any template to use it

Bulk Operations

1. Ctrl+Click items to select multiple
2. Use the bulk action bar to move, delete, or favorite selected items

---

⌨️ Keyboard Shortcuts

Shortcut	Action
Ctrl+Shift+V	Open Clippy popup
Ctrl+Shift+1	Copy most recent clip
Ctrl+Shift+2	Copy 2nd most recent clip
Ctrl+Shift+3	Copy 3rd most recent clip

Note: On Mac, use Cmd instead of Ctrl

To customize shortcuts, go to chrome://extensions/shortcuts

---

🔒 Privacy

Clippy takes your privacy seriously:

• Local Storage Only — All data is stored locally on your device
• No Cloud Sync — Your clipboard history never leaves your computer
• No Analytics — We don't track or collect any usage data
• No Third-Party Services — No external connections are made
• Open Source — Review the code yourself

Permissions Explained

Permission	Why We Need It
storage	Save your clipboard history locally
activeTab	Capture clipboard from the current page
clipboardRead/Write	Read and write to clipboard
contextMenus	Add "Paste from Clippy" to right-click menu
tabs	Track which site clips came from

---

🛠️ Development

Project Structure

clippy
├── manifest.json        # Extension manifest
├── popup.html          # Main popup UI
├── popup.js            # Popup logic
├── background.js       # Service worker
├── content.js          # Content script for clipboard capture
├── browser-polyfill.js # Cross-browser compatibility
├── icons/              # Extension icons
└── _locales/           # Internationalization

Building

No build step required! The extension runs directly from the source.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

---

📄 License

MIT License — feel free to use, modify, and distribute.

---

💬 Support

Having issues or suggestions?

• Open an issue on GitHub
• Email: dev@bakarimustafa.com

---

☕ Buy Me a Coffee

If you find Clippy useful, consider supporting its development!

---

Made with ❤️ for productivity enthusiasts