clipsy 1.8.0__py3-none-any.whl → 1.9.0__py3-none-any.whl

clipsy/__init__.py

@@ -1,2 +1,2 @@
-__version__ = "1.8.0"
+__version__ = "1.9.0"
 __app_name__ = "Clipsy"

clipsy/app.py

@@ -5,7 +5,7 @@ from pathlib import Path
 import rumps
 
 from clipsy import __version__
-from clipsy.config import DB_PATH, IMAGE_DIR, MENU_DISPLAY_COUNT, POLL_INTERVAL, REDACT_SENSITIVE, THUMBNAIL_SIZE
+from clipsy.config import DB_PATH, IMAGE_DIR, MAX_PINNED_ENTRIES, MENU_DISPLAY_COUNT, POLL_INTERVAL, REDACT_SENSITIVE, THUMBNAIL_SIZE
 from clipsy.models import ClipboardEntry, ContentType
 from clipsy.monitor import ClipboardMonitor
 from clipsy.storage import StorageManager
@@ -34,10 +34,24 @@ class ClipsyApp(rumps.App):
             None,  # separator
         ]
 
-        entries = self._storage.get_recent(limit=MENU_DISPLAY_COUNT)
         self._entry_ids.clear()
 
-        if not entries:
+        # Add pinned submenu if there are pinned entries
+        pinned_entries = self._storage.get_pinned()
+        if pinned_entries:
+            pinned_menu = rumps.MenuItem("📌 Pinned")
+            for entry in pinned_entries:
+                pinned_menu.add(self._create_entry_menu_item(entry))
+            pinned_menu.add(None)  # separator
+            pinned_menu.add(rumps.MenuItem("Clear Pinned", callback=self._on_clear_pinned))
+            self.menu.add(pinned_menu)
+            self.menu.add(None)  # separator
+
+        entries = self._storage.get_recent(limit=MENU_DISPLAY_COUNT)
+        # Filter out pinned entries from recent list
+        entries = [e for e in entries if not e.pinned]
+
+        if not entries and not pinned_entries:
             self.menu.add(rumps.MenuItem("(No clipboard history)", callback=None))
         else:
             for entry in entries:
@@ -118,6 +132,17 @@ class ClipsyApp(rumps.App):
         if entry is None:
             return
 
+        # Check if Option key is held (for pin toggle)
+        try:
+            from AppKit import NSAlternateKeyMask, NSEvent
+
+            modifier_flags = NSEvent.modifierFlags()
+            if modifier_flags & NSAlternateKeyMask:
+                self._on_pin_toggle(entry)
+                return
+        except Exception:
+            pass  # If we can't check modifiers, proceed with normal copy
+
         try:
             from AppKit import NSPasteboard, NSPasteboardTypePNG, NSPasteboardTypeString
             from Foundation import NSData
@@ -161,6 +186,32 @@ class ClipsyApp(rumps.App):
         except Exception:
             logger.exception("Error copying entry to clipboard")
 
+    def _on_pin_toggle(self, entry: ClipboardEntry) -> None:
+        """Toggle pin status for an entry."""
+        if entry.pinned:
+            # Unpin
+            self._storage.toggle_pin(entry.id)
+            rumps.notification("Clipsy", "", "Unpinned", sound=False)
+        else:
+            # Check if we can pin (not sensitive, under limit)
+            if entry.is_sensitive:
+                rumps.notification("Clipsy", "", "Cannot pin sensitive data", sound=False)
+                return
+
+            if self._storage.count_pinned() >= MAX_PINNED_ENTRIES:
+                rumps.notification("Clipsy", "", f"Maximum {MAX_PINNED_ENTRIES} pinned items", sound=False)
+                return
+
+            self._storage.toggle_pin(entry.id)
+            rumps.notification("Clipsy", "", "Pinned", sound=False)
+
+        self._refresh_menu()
+
+    def _on_clear_pinned(self, _sender) -> None:
+        """Clear all pinned entries."""
+        self._storage.clear_pinned()
+        self._refresh_menu()
+
     def _on_search(self, _sender) -> None:
         response = rumps.Window(
             message="Search clipboard history:",

clipsy/config.py

@@ -25,3 +25,4 @@ def _parse_menu_display_count() -> int:
 MENU_DISPLAY_COUNT = _parse_menu_display_count()
 THUMBNAIL_SIZE = (32, 32)  # pixels, for menu icon display
 REDACT_SENSITIVE = True  # mask sensitive data in preview (API keys, passwords, etc.)
+MAX_PINNED_ENTRIES = 5  # maximum number of pinned entries allowed

clipsy/storage.py

@@ -211,6 +211,21 @@ class StorageManager:
         row = self._conn.execute("SELECT COUNT(*) as cnt FROM clipboard_entries").fetchone()
         return row["cnt"]
 
+    def get_pinned(self) -> list[ClipboardEntry]:
+        rows = self._conn.execute(
+            "SELECT * FROM clipboard_entries WHERE pinned = 1 ORDER BY created_at DESC"
+        ).fetchall()
+        return [self._row_to_entry(r) for r in rows]
+
+    def count_pinned(self) -> int:
+        row = self._conn.execute("SELECT COUNT(*) as cnt FROM clipboard_entries WHERE pinned = 1").fetchone()
+        return row["cnt"]
+
+    def clear_pinned(self) -> None:
+        """Unpin all pinned entries."""
+        self._conn.execute("UPDATE clipboard_entries SET pinned = 0 WHERE pinned = 1")
+        self._conn.commit()
+
     def close(self) -> None:
         self._conn.close()
 

{clipsy-1.8.0.dist-info → clipsy-1.9.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clipsy
-Version: 1.8.0
+Version: 1.9.0
 Summary: Lightweight clipboard history manager for macOS
 Author-email: Brendan Conrad <brendan.conrad@gmail.com>
 License: MIT
@@ -46,6 +46,8 @@ A lightweight clipboard history manager for macOS. Runs as a menu bar icon — n
 - **Image thumbnails** — Visual previews for copied images in the menu
 - **Sensitive data masking** — Auto-detects API keys, passwords, SSNs, credit cards, private keys, and tokens; displays masked previews with 🔒 icon
 - **Search** — Full-text search across all clipboard entries (SQLite FTS5)
+- **Rich text preservation** — Preserves RTF and HTML formatting when re-copying from history (e.g., bold, italic, links from web pages)
+- **Pin favorites** — Option-click to pin up to 5 frequently-used snippets (sensitive data cannot be pinned)
 - **Click to re-copy** — Click any entry in the menu to put it back on your clipboard
 - **Deduplication** — Copying the same content twice bumps it to the top instead of creating a duplicate
 - **Auto-purge** — Keeps the most recent 500 entries, automatically cleans up old ones
@@ -103,11 +105,15 @@ Then just use your Mac normally. Every time you copy something, it shows up in t
 ├── ──────────────────
 ├── Search...
 ├── ──────────────────
+├── 📌 Pinned ►
+│   ├── "my-api-endpoint.com/v1..."
+│   └── "SELECT * FROM users..."
+├── ──────────────────
 ├── "Meeting notes for Q3 plan..."
 ├── "https://github.com/example..."
 ├── 🔒 "password=••••••••"
 ├── [thumbnail] "[Image: 1920x1080]"
-├── ... (up to 10 items)
+├── ... (up to 10 items, configurable)
 ├── ──────────────────
 ├── Clear History
 ├── ──────────────────
@@ -116,6 +122,8 @@ Then just use your Mac normally. Every time you copy something, it shows up in t
 └── Quit Clipsy
 ```
 
+**Tip:** Hold **Option (⌥)** while clicking an entry to pin/unpin it.
+
 ## Commands
 
 ```bash
@@ -125,6 +133,17 @@ clipsy uninstall  # Remove from login items
 clipsy run        # Run in foreground (for debugging)
 ```
 
+## Configuration
+
+| Variable | Default | Range | Description |
+|----------|---------|-------|-------------|
+| `CLIPSY_MENU_DISPLAY_COUNT` | `10` | 5–50 | Number of entries shown in the menu |
+
+```bash
+# Example: show 20 entries in the menu
+export CLIPSY_MENU_DISPLAY_COUNT=20
+```
+
 ## Data Storage
 
 All data is stored in `~/.local/share/clipsy/`:

clipsy-1.9.0.dist-info/RECORD

@@ -0,0 +1,15 @@
+clipsy/__init__.py,sha256=AnsrZyNwA76HMWFc_Q7iDYH8Citiqm2lXLiZFzPs7uQ,46
+clipsy/__main__.py,sha256=AzUjrEhnuVX5Mkk3QhfmAO17cyvIYOABsz7QWYmw1r8,4991
+clipsy/app.py,sha256=scM-po0Kw1SOg_pDlMxsgbzhDQWS4BAvv5Iq64GLJEc,9861
+clipsy/config.py,sha256=NOElM7jJ73AWQ1sf09dxg82-1nGErXd1zT63v2MPGpA,980
+clipsy/models.py,sha256=9wuaq1t9HhaH8QYuieN7fEVM_RTYEvv6ZUCM_InOMKk,632
+clipsy/monitor.py,sha256=PBTxK53arFm5VVCHIYlxz8eoYQrgTwWsIWNE49IE7oU,6904
+clipsy/redact.py,sha256=EU2nq8oEDYLZ_I_9tX2bXACIF971a0V_ApKdvpN4VGY,7284
+clipsy/storage.py,sha256=WE3EeOLcSgw-0it1qPk5rS-vDRC3-XDILaMZquBFR5Y,10659
+clipsy/utils.py,sha256=rztT20cXYJ7633q3oLwt6Fv0Ubq9hm5bPPKDkWyvxdI,2208
+clipsy-1.9.0.dist-info/licenses/LICENSE,sha256=bZ7uVihgPnLGryi5ugUgkVrEoho0_hFAd3bVdhYXGqs,1071
+clipsy-1.9.0.dist-info/METADATA,sha256=tJ8uQW6-pRU2JAyAnO3dpr_ix9zFUpS6NvizCYZAD4Y,6680
+clipsy-1.9.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+clipsy-1.9.0.dist-info/entry_points.txt,sha256=ISIoWU3Zj-4NEuj2pJW96LxpsvjRJJH73otv9gA9YSs,48
+clipsy-1.9.0.dist-info/top_level.txt,sha256=trxprVJk4ZMudCshc7PD0N9iFgQO4Tq4sW5L5wLduns,7
+clipsy-1.9.0.dist-info/RECORD,,

clipsy-1.8.0.dist-info/RECORD

@@ -1,15 +0,0 @@
-clipsy/__init__.py,sha256=2M96CO-qBjhCYnYgi1FZuen5WyQOvlbtLUIIPCDsES0,46
-clipsy/__main__.py,sha256=AzUjrEhnuVX5Mkk3QhfmAO17cyvIYOABsz7QWYmw1r8,4991
-clipsy/app.py,sha256=e987geHCfDs3_9GulTZaS2iJT-BUL_iwpNtAmt6kPW8,7786
-clipsy/config.py,sha256=YetSNZkSkSOHYnCZpty6sGeG99MajbN4goL8UkzJ62A,913
-clipsy/models.py,sha256=9wuaq1t9HhaH8QYuieN7fEVM_RTYEvv6ZUCM_InOMKk,632
-clipsy/monitor.py,sha256=PBTxK53arFm5VVCHIYlxz8eoYQrgTwWsIWNE49IE7oU,6904
-clipsy/redact.py,sha256=EU2nq8oEDYLZ_I_9tX2bXACIF971a0V_ApKdvpN4VGY,7284
-clipsy/storage.py,sha256=ZcuW2uFvJM0Cd3UQEWIMSZYH2DYWM6lD6yol6VpM5io,10047
-clipsy/utils.py,sha256=rztT20cXYJ7633q3oLwt6Fv0Ubq9hm5bPPKDkWyvxdI,2208
-clipsy-1.8.0.dist-info/licenses/LICENSE,sha256=bZ7uVihgPnLGryi5ugUgkVrEoho0_hFAd3bVdhYXGqs,1071
-clipsy-1.8.0.dist-info/METADATA,sha256=UMKIznK4wUar5eV0ic7QVLuoRdZN4fMT6AL34BbuHdE,5884
-clipsy-1.8.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-clipsy-1.8.0.dist-info/entry_points.txt,sha256=ISIoWU3Zj-4NEuj2pJW96LxpsvjRJJH73otv9gA9YSs,48
-clipsy-1.8.0.dist-info/top_level.txt,sha256=trxprVJk4ZMudCshc7PD0N9iFgQO4Tq4sW5L5wLduns,7
-clipsy-1.8.0.dist-info/RECORD,,