📋 CopyClip

CopyClip is an open-source clipboard manager for Linux, inspired by the advanced clipboard features of Windows 10. Easily manage your clipboard history with intuitive controls and quick access to your most recent items.

✨ Features

• 🗂️ Clipboard History: Keep track of all copied items in reverse chronological order.
• 📌 Pin Important Items: Save crucial snippets by pinning them to the top of your clipboard history.
• 🎛️ Customizable Shortcuts: Easily configure shortcuts for quick access and management.
• 🔄 Auto-clear on Reboot: Automatically clear your clipboard history when you restart your computer (with an option to pin items to prevent deletion).
• 🖼️ Simple UI: Access your clipboard history through a clean and user-friendly interface.

Warning

The executable has not been compiled to the latest changes of the code, when this is done, this message will disapper.

📦 Dependencies

CopyClip requires the following packages to function properly. Install them before running the application:

Linux (Debian/Ubuntu)

sudo apt-get install xsel python3-xlib

Linux (Fedora)

sudo dnf install xsel python3-xlib

Linux (Arch/Manjaro)

sudo pacman -S xsel python-xlib

Note

These dependencies are required for clipboard operations (xsel) and hotkey detection (python3-xlib). If the app fails to start, verify they're installed correctly.

🚀 Installation

To install CopyClip, follow these steps:

1. Clone the repository:

   git clone https://github.com/Walkercito/CopyClip.git

2. Navigate to the project directory:

   cd CopyClip

3. The executable generated by PyInstaller will be located in the dist folder. To run the application, simply execute the file from that directory:

   cd dist/

   ./CopyClip

Note

We are working to optimize the size of the application to make it as lightweight as possible in future updates.

🛠️ How to Use

1. Launch CopyClip.
2. Copy text as usual using Ctrl + C.
3. Open the CopyClip UI using the assigned shortcut (Super + V by default).
4. Select items from the history or pin important snippets.
5. Manually copy items from the UI to paste them elsewhere using Ctrl + V.

🤝 Contributing

We welcome contributions! Here's how you can get involved:

1. 🍴 Fork the repository.
2. 🌿 Create a new branch (git checkout -b feature-branch).
3. 🛠️ Make your changes.
4. 💾 Commit your changes (git commit -m 'Add new feature').
5. 🚀 Push to the branch (git push origin feature-branch).
6. 🔁 Open a pull request.

🗺️ Roadmap

• 🛠️ Bug Fix: Integrate clipboard entries directly with Ctrl + V functionality. [FIXED]
• 💻 UI Improvements: Enhance UI to provide a Windows 11-like experience.
• ✒️ Feature: Add support for rich text and image copying.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

💬 Contact

If you encounter any issues or have suggestions, feel free to open an issue or reach out via GitHub.

---

We hope CopyClip helps make your clipboard management easier! ✨