Linux·Updated

Clipboard history on Wayland not working? What works and why

On Wayland a clipboard manager can't read copies or catch keys the way it can on X11. Which desktops allow it, and how to set up Pastezo there.

Step by step

  1. Check that you are on Wayland

    Run echo $XDG_SESSION_TYPE in a terminal. It prints wayland on Wayland and x11 on X11.

  2. Install Pastezo

    Download the Linux build (x64 or ARM), unpack it and run ./install.sh. It installs into ~/.local, no root needed.

  3. Add the shortcut in your desktop

    Create a custom shortcut, for example Ctrl+Shift+V, with the command ~/.local/bin/Pastezo. In KDE Plasma it is under System Settings → Keyboard → Shortcuts; in Sway, add a bindsym line to your config.

  4. Copy something and open the history

    Copy a line of text, press your shortcut and check that it is at the top. Enter pastes it; Ctrl+1…9 paste the first nine clips.

X11 or Wayland: what changes

On X11 any app can read the clipboard and listen for keys, which is simple and not very private. Wayland closes both doors by default and opens them only through the desktop. Copies still reach Pastezo on desktops that open the clipboard door for clipboard managers; for keys, your desktop starts Pastezo with the shortcut you give it. Everything else, from search to pins, works the same. See also how to see clipboard history on Linux and how to open your clipboard history with a shortcut.

Questions

Why can't a clipboard manager see my copies on Wayland?

For privacy, Wayland lets only the focused window read the clipboard. A clipboard manager needs the desktop's data-control protocol to watch copies in the background, and not every desktop offers it.

Why can't Pastezo set a global shortcut on Wayland?

On Wayland, apps can't simply listen for keys in other windows, and Pastezo doesn't register a shortcut there. Add a shortcut that runs ~/.local/bin/Pastezo in your desktop's keyboard settings instead.

Does Pastezo work on X11 too?

Yes. On X11 it sees copies and sets its own global shortcut in Settings → General.

What about GNOME on Wayland?

GNOME's built-in clipboard keeps only the last item. Clipboard history on GNOME usually comes from GNOME Shell extensions such as Clipboard Indicator or GPaste, which run inside the desktop itself.

Try Pastezo

Free on macOS, Windows and Linux. No account, and your history stays on your computer.

Download for macOS

Free · version 1.0.0 · Intel Mac · All downloads