🗂️ oma-clipmanager - Simplify Your Clipboard Management

👋 Introduction

Welcome to the OMA Clipboard Manager! This tool makes managing your clipboard easy and efficient. It works great with Hyprland and offers handy features like image previews right in your terminal.

🚀 Getting Started

Follow these steps to download and set up the OMA Clipboard Manager.

Step 1: Visit the Releases Page

Go to the Releases page. Here, you will find the latest version available for download.

Step 2: Download the Latest Release

On the Releases page, find the latest version of oma-clipmanager. Click on it to view the release details. Look for the file specific to your operating system and click the download link.

Step 3: Install Dependencies

To use OMA Clipboard Manager, you will need to install a few tools.

• kitty: This is a terminal emulator that supports images. You can find it here.
• fzf: This is a command-line fuzzy finder. You can install it from here.
• cliphist: This tool manages your clipboard history efficiently. Install it from here.

Ensure you have these tools installed before running oma-clipmanager.

Step 4: Run oma-clipmanager

After downloading the appropriate file and installing the dependencies, you can run the application. This is typically done from your terminal. Use the following command, replacing the path with the location you downloaded the file to:

./path/to/oma-clipmanager

You can also set up a shortcut for easier access. Consider using a hotkey like ALT+V to quickly bring up the clipboard history.

📦 Key Features

OMA Clipboard Manager comes with several features designed to enhance your experience:

• 📋 Clipboard History: Keep track of all your copied text and images.
• 🖼️ Image Preview: View images directly in the terminal using kitty's icat.
• 🎨 Syntax Highlighting: Enjoy text previews with syntax highlighting via bat.
• ⚡ Fast & Fuzzy Search: Quickly find what you need with fzf.
• ⌨️ Easy Access: Use the simple keybinding (ALT+V) to access your clipboard history.
• 🪟 Floating Window: Experience a clean and minimalistic floating interface.

📥 Download & Install

To get started, download the latest version from the Releases page. Once downloaded, follow the installation guidelines provided above.

🛠️ System Requirements

While oma-clipmanager aims for broad compatibility, ensure you have:

• A modern operating system (Linux preferred for optimal functionality with Hyprland).
• Sufficient RAM (a minimum of 2GB is recommended).
• The installed dependencies as mentioned earlier.

📄 User Documentation

How to Use OMA Clipboard Manager

1. Open Your Terminal: Make sure you have kitty set as your terminal emulator.
2. Run the Application: Use the command provided earlier to start the clipboard manager.
3. Access Your History: Press ALT+V to access your clipboard history.
4. Search Your Clips: Use the search function to quickly find what you need.
5. Preview Images: Enjoy image previews directly in your terminal.

🚧 Troubleshooting

If you run into issues, consider the following:

• Dependency Not Found: Ensure all required tools (kitty, fzf, cliphist) are installed and accessible from your path.
• Terminal Compatibility: Use the latest version of kitty for the best experience.
• Clipboard History Not Showing: Make sure cliphist is running and capturing clipboard data.

🤝 Community and Support

Feel free to open issues on the GitHub repository for any features or bugs. Join our community discussions to share your experiences and suggestions.

📝 License

OMA Clipboard Manager is open-source software. You can view the license details in the repository.

Visit the Releases page to download and start using oma-clipmanager today!