Skip to content

Clipboard

Neclonesoul edited this page Aug 27, 2026 · 1 revision

Clipboard

ARCHMAC uses the Wayland clipboard stack:

  • wl-clipboard
  • cliphist
  • an application launcher/menu pipeline
  • Hyprland binding: Super + Shift + V

Behaviour

Normal application copy/paste remains:

Ctrl + C
Ctrl + V

Clipboard history is opened with:

Super + Shift + V

Wayland clipboard persistence

Wayland applications do not necessarily keep clipboard data alive after the source application exits.

A clipboard history service solves this by watching clipboard changes and storing entries.

The ArchWiki Hyprland guidance uses wl-paste --watch with cliphist store and a launcher pipeline that decodes the selected item back into wl-copy.

ARCHMAC follows that architecture while using its own binding.

Inspect

command -v wl-copy
command -v wl-paste
command -v cliphist
cliphist list | head
pgrep -af 'wl-paste|cliphist'

Manual text test

printf 'ARCHMAC clipboard test\n' | wl-copy
wl-paste

Expected:

ARCHMAC clipboard test

Clear history

Before clearing anything important, inspect it:

cliphist list

If you deliberately want to wipe clipboard history:

cliphist wipe

Troubleshooting

If Super + Shift + V opens nothing:

  1. confirm Hyprland saw the binding
  2. confirm cliphist is installed
  3. confirm one or more wl-paste --watch ... cliphist store watchers are running
  4. confirm the menu/launcher used by ARCHMAC is installed
  5. test the pipeline manually
  6. only then edit the config

Do not change the binding to Super + V merely because that is used in upstream examples.

Clone this wiki locally