XWayClipSync

Sync clipboard between X11 (xclip) and Wayland (wl-clipboard) for text, images, and file lists.

Requirements

• System utilities: xclip, wl-clipboard (provides wl-paste/wl-copy)
• Python package: python-xlib

To install the system utilities, use your package manager:

• Debian/Ubuntu

  sudo apt update
  sudo apt install xclip wl-clipboard

• Arch Linux

  sudo pacman -S xclip wl-clipboard

For the Python package:

• If you use uv:

  uv tool install .

  This will handle python dependency automatically and install the xwayclipsync executable in your PATH.

• Otherwise, install via pip:

  pip install python-xlib

Usage

If you used uv to install, simply run:

xwayclipsync

Otherwise, manually run the script:

python -m xwayclipsync

• Use -l DEBUG to enable debug logging.
• Use --help to see all options.