A modern Wayland clipboard manager built with Rust, GTK4, Libadwaita, and Wayland Layer Shell that makes clipboard handling more reliable. Features a Windows 11–style clipboard history interface with native GNOME design, which is always positioned at the current mouse pointer location.

• The backend supports both zwlr_data_control_manager_v1 (wlroots) and ext_data_control_manager_v1 (standard) protocols for clipboard access, automatically selecting the available protocol.

• The frontend uses zwlr_layer_shell_v1 to retrieve pointer coordinates and show the overlay.

• Supported compositors:

  • KDE Plasma 6 (Wayland session) - uses ext_data_control_manager_v1
  • Hyprland - uses zwlr_data_control_manager_v1
  • Sway - uses zwlr_data_control_manager_v1
  • niri - uses zwlr_data_control_manager_v1
  • Labwc - uses zwlr_data_control_manager_v1
  • Other wlroots-based compositors - uses zwlr_data_control_manager_v1

• Although the application uses GNOME styling and follows the GNOME HIG, GNOME Shell is unfortunately NOT SUPPORTED. It does not implement the required Wayland protocols (zwlr_layer_shell_v1 and clipboard access protocols) needed for Cursor Clip's key features. Future support is not impossible but will require major code and workflow changes and a separate GNOME Extension.

• Wayland compositor, GTK4, gtk4-layer-shell, libadwaita, Rust

You can install Cursor Clip from the AUR using an AUR helper like yay:

yay -S cursor-clip-git

sudo pacman -S gtk4 libadwaita gtk4-layer-shell

sudo apt update
sudo apt install build-essential pkg-config libgtk-4-dev libadwaita-1-dev gtk4-layer-shell

sudo dnf install gtk4-devel libadwaita-devel gtk4-layer-shell

# Clone the repository
git clone https://github.com/Sirulex/cursor-clip
cd cursor-clip

# Build in release mode
cargo build --release

1. Start Background Daemon: cursor-clip --daemon
2. Launch Overlay: Run cursor-clip without any arguments (ideally bind it to a hotkey, e.g., Super+V)
3. Trigger: Your mouse position is automatically captured
4. View History: The clipboard history window will appear at your cursor position, showing:
   • Recent clipboard items with content previews
   • Content type icons (text, URL, code, password, file)
   • Timestamps showing when items were copied
   • Quick actions: Clear All and Close
5. Interact:
   • Click any item to copy it back to the clipboard
   • Scroll through your clipboard history
   • Clear All to remove all history items
   • Keyboard navigation: Use arrow keys or J/K to navigate, Enter to select, Esc to close

┌─────────────────────────────────────────────────┐
│                 Cursor Clip                     │
├─────────────────────────────────────────────────┤
│  GTK4 + Libadwaita UI Layer                     │
│  ├── Modern styling with CSS                    │
│  ├── Responsive layouts                         │
│  └── Accessibility features                     │
├─────────────────────────────────────────────────┤
│  Wayland Layer Shell Integration                │
│  ├── zwlr_layer_shell_v1 protocol               │
│  ├── Positioning and anchoring                  │
│  └── Overlay layer management                   │
├─────────────────────────────────────────────────┤
│  Clipboard Management                           │
│  ├── Data Control Manager for privileged access │
│  ├── IPC communication via UNIX domain sockets  │
│  └── IndexMap for clipboard history storage     │
└─────────────────────────────────────────────────┘

• GTK4 (0.10): Modern UI toolkit
• Libadwaita (0.8): GNOME's design system
• gtk4-layer-shell (0.6): Wayland layer shell integration
• wayland-client (0.31): Wayland protocol bindings
• wayland-protocols (0.32): Extended Wayland protocols
• wayland-protocols-wlr (0.3.9): wlroots-specific Wayland protocols
• Tokio runtime (1.47): Asynchronous runtime
• serde (1.0): Serialization framework
• indexmap (2.11): Ordered map for clipboard history
• env_logger (0.11): Logging framework

Built with ❤️ using Rust, GTK4, Libadwaita, and Wayland Layer Shell

If you find this project useful and would like to support its development, consider sponsoring me on GitHub or Ko-fi. Your support helps me dedicate more time to improving and maintaining Cursor Clip.

• GitHub Sponsors: https://github.com/sponsors/Sirulex
• Ko-fi: https://ko-fi.com/sirulex

This project is licensed under the GNU General Public License v3.0 (GPL-3.0). See LICENSE for the full text.