A GTK3 GUI for the clipse clipboard manager.

• Browse, search, and filter clipboard history
• Pin important items
• Image thumbnails and text preview with zoom
• Keyboard navigation (? for shortcuts)
• Compact mode, hover-to-select
• Multi-select mode
• Auto-paste on Enter (optional)
• System tray with quick-paste menu

Full docs live in docs/:

• Installation — dependencies, AUR, source build
• Getting Started — daemon setup, first launch, core workflow
• Keybindings — every shortcut grouped by context
• Configuration — every settings.ini option explained
• Theming — colors, radius, CSS customization
• Tray Integration — tray menu, quick-paste, troubleshooting
• Window Manager Setup — Hyprland, Sway, Niri, GNOME, KDE, XMonad
• Troubleshooting — paste issues, GTK errors, log capture

yay -S clipse-gui

git clone https://github.com/d7omdev/clipse-gui
cd clipse-gui

just install      # Build and install
just build       # Just build
just run         # Run without installing
just uninstall   # Remove

• clipse CLI (running with clipse -listen)
• GTK3, wl-clipboard, wtype (Wayland) or xdotool (X11)

clipse-gui

Add to hyprland.conf:

windowrule = size 600 800,title:(Clipse GUI)
windowrule = center, title:(Clipse GUI)
windowrule = float, title:(Clipse GUI)

Settings file: ~/.config/clipse-gui/settings.ini (created on first run).

[General]
clipse_dir = ~/.config/clipse        # Clipse history location
enter_to_paste = False              # Auto-paste after copy
compact_mode = False                # Minimal UI
hover_to_select = False             # Select on hover
protect_pinned_items = False        # Prevent deleting pinned

[Commands]
copy_tool_cmd = wl-copy            # Copy command (Wayland)
paste_simulation_cmd_wayland = wtype -M ctrl -P v -p v -m ctrl

Ensure clipse is running:

clipse -listen

Add to window manager config to start on boot:

exec-once = clipse -listen  # Hyprland

• Install wtype (Wayland) or xdotool (X11)
• Enable enter_to_paste = True in settings

MIT - See LICENSE