OMA Clipboard Manager

A beautiful and efficient clipboard manager for Hyprland with image preview support using kitty, fzf, and cliphist.

✨ Features

• 📋 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: Text preview with syntax highlighting via bat
• ⚡ Fast & Fuzzy Search: Quickly find what you need with fzf
• ⌨️ Easy Access: Simple keybinding (ALT+V) to access your clipboard history
• 🪟 Floating Window: Clean, minimal floating interface

📦 Dependencies

This clipboard manager requires the following tools:

• kitty - Terminal emulator with image support
• fzf - Fuzzy finder for quick searching
• cliphist - Clipboard history manager for Wayland
• wl-clipboard - Wayland clipboard utilities
• wtype - Wayland keyboard input emulator
• bat - Syntax highlighting for text preview
• imagemagick - Image manipulation (for the convert command)

🚀 Installation

Automatic Installation (Recommended)

1. Clone this repository:

git clone https://github.com/yourusername/oma-clipmanager.git
cd oma-clipmanager

2. Run the installation script:

chmod +x install.sh
./install.sh

The script will:

• Install yay (AUR helper) if not present
• Install all required dependencies
• Copy the script to ~/.config/omarchy/bin/
• Configure Hyprland bindings and window rules (if files exist)

Manual Installation

1. Install dependencies:

yay -S kitty fzf cliphist wl-clipboard wtype bat imagemagick

2. Copy the script:

mkdir -p ~/.config/omarchy/bin
cp fzf-cliphist-preview.sh ~/.config/omarchy/bin/
chmod +x ~/.config/omarchy/bin/fzf-cliphist-preview.sh

4. Add window rules to your Hyprland config (~/.config/hypr/windows.conf or hyprland.conf):

windowrulev2 = size 20% 45%,class:(fzf-clip)
windowrulev2 = float,class:(fzf-clip)

5. Enable clipboard history monitoring (add to ~/.config/hypr/autostart.conf or your Hyprland config):

exec-once = wl-paste --type text --watch cliphist store
exec-once = wl-paste --type image --watch cliphist store

6. Reload Hyprland:

hyprctl reload

🎯 Usage

1. Copy some text or images to your clipboard
2. Press ALT+V to open the clipboard manager
3. Use fuzzy search to find what you need
4. Press Enter to paste the selected item

Preview Features

• Text: Displays with syntax highlighting and line numbers
• Images: Renders directly in the terminal preview window
• Code: Automatically detects and highlights programming languages

⚙️ Configuration

Custom Keybinding

You can change the keybinding by modifying the bind line in your Hyprland config:

bind = ALT, V, exec, sh -c '...'  # Change ALT, V to your preferred keys

Window Size

Adjust the clipboard manager window size:

windowrulev2 = size 20% 45%,class:(fzf-clip)  # Modify width% height%

Font Size

kitty --class fzf-clip -o font_size=10  # Change font_size value

🔧 Troubleshooting

Images not displaying

• Ensure you're using kitty terminal
• Check if imagemagick is installed: convert --version
• Verify kitty's icat works: kitty +kitten icat /path/to/image.png

Clipboard history not working

• Make sure cliphist is running: ps aux | grep cliphist
• Verify wl-paste is monitoring clipboard:

  exec-once = wl-paste --type text --watch cliphist store
  exec-once = wl-paste --type image --watch cliphist store

Keybinding not working

• Reload Hyprland: hyprctl reload
• Check if binding is registered: hyprctl binds | grep -i clip

📝 License

MIT License - feel free to use and modify as needed!

🤝 Contributing

Contributions are welcome! Feel free to:

• Report bugs
• Suggest new features
• Submit pull requests

💡 Credits

Created for the Hyprland community. Special thanks to:

• cliphist - Clipboard history manager
• fzf - Fuzzy finder
• kitty - Terminal emulator
• bat - Syntax highlighter

---

Note: This tool is designed specifically for Wayland/Hyprland. It may not work on X11 or other window managers without modifications.