Smart Clipboard History Manager (CopyNest)

Your clipboard, evolved — capture, search, and reuse everything you copy.

CopyNest is a modern, feature-rich clipboard manager built with Python. It monitors your clipboard in real-time, saving both text and images for easy access, search, and management. With a sleek CustomTkinter GUI, it supports favorites, tags, date filtering, and more. Ideal for productivity enthusiasts who need quick recall of copied content.

Features

• Automatic Clipboard Monitoring: Captures text and images from your clipboard as you copy them.
• Text & Image Support: Stores and previews text snippets and images (with thumbnail previews).
• Advanced Search & Filtering:
  • Search by content, date, type (text/image), or tags.
  • Date range filtering (From/To dates).
  • Favorites-only view.
  • Type filtering (All/Text/Image).
  • Sorting by date (ascending/descending).
• Favorites & Tags: Mark items as favorites or add custom tags for organization.
• Export & Import: Save history as JSON (text-only) or ZIP (with images). Import back seamlessly.
• Customizable Settings:
  • Dark/Light theme toggle.
  • Enable/disable clipboard monitoring.
  • Set maximum items to keep (auto-deletes oldest when exceeded).
  • Custom hotkey (e.g., Ctrl+Alt+H) to show/hide the window.
• Hotkey Activation: Hide the window and summon it with a configurable hotkey.
• Performance Optimizations: Limits display to last 100 items for smooth UI; enforces max items to prevent bloat.

Installation

1. Clone the Repository:

   git clone https://github.com/BengalEmpire/copynest.git
   cd copynest
   

2. Set Up a Virtual Environment (Recommended):

   python -m venv venv
   source venv/bin/activate  # On Unix/Mac
   venv\Scripts\activate     # On Windows
   

3. Install Dependencies:

   pip install -r requirements.txt
   

   Requirements include:

   • customtkinter (>=5.2.2)
   • pyperclip (>=1.9.0)
   • Pillow (>=10.4.0)
   • pynput (>=1.7.7)
   • pyinstaller (>=6.10.0) (optional, for building executables)

4. Run the App:

   py main.py
   

   The app will start monitoring (if enabled) and print the hotkey in the console.

Usage

• Launch: Run main.py. The window may hide initially—use the hotkey (default: Ctrl+Alt+H) to show it.
• Copy Content: Copy text or images as usual; they'll appear in the history.
• View & Manage:
  • Search and filter items in the UI.
  • Click "Copy" to paste an item back to clipboard.
  • Toggle favorites, edit tags, or delete items.
  • Use "View Full" for long text or full-size images.
• Settings: Access via the ⚙️ button to customize theme, monitoring, max items, and hotkey (restart required for hotkey changes).
• Export/Import: Use buttons to save/load history. ZIP includes images.
• Clear History: Removes all items and associated images.

Note: Image copying back to clipboard is Windows-only due to win32clipboard dependency.

Configuration

Edit data/config.json manually or via the Settings UI:

• hotkey: List of keys (e.g., ["ctrl_l", "alt_l", "h"]).
• theme: "dark" or "light".
• autosave: true to enable monitoring.
• max_items: Integer limit (default: 1000).

Changes via UI save automatically; hotkey requires app restart.

Building an Executable (Optional)

Use PyInstaller:

pyinstaller --onefile --windowed --icon=icon.ico main.py --name=CopyNest

This creates a standalone .exe file located in the dist folder. You can also visit the GitHub release page for the download.

Contributing

Contributions welcome! Fork the repo, create a feature branch, and submit a pull request or create a issues. Please include tests and update documentation.

© Bengal Empire