diff --git a/plugins/clipboard-keys/README.md b/plugins/clipboard-keys/README.md index a203b62..2363b42 100644 --- a/plugins/clipboard-keys/README.md +++ b/plugins/clipboard-keys/README.md @@ -20,9 +20,31 @@ screen is locked, or when nothing has keyboard focus, the keys pass through unchanged. Apps that inhibit compositor shortcuts (virtual machines, remote desktops) receive Super+C and Super+V themselves. +## Copies outlive their app + +On Wayland the app you copied from holds the copy, so it used to vanish when +that app quit. Wayfire now reads each copy's useful formats as soon as it is +made and, when the app quits, offers them itself: + +- one text format, offered under every usual text name; +- formatting and file lists (`text/html`, `text/uri-list`, + `x-special/gnome-copied-files`, RTF), so a table keeps its layout and copied + files still paste as files; +- one image, unless the copy also has text (a spreadsheet's cells come with a + picture of them, costly to render and not what a paste wants). + +Limits: 8 MiB per text format, 64 MiB for the image, 80 MiB per copy; formats +an app has not finished writing within 5 s are dropped. Copies a password +manager marks secret (`x-kde-passwordManagerHint`) are never read, so nothing +comes back after them, and clearing the clipboard on purpose (`wl-copy +--clear`) leaves it empty. While the app runs it keeps serving its copy +itself, with every format it offers. Nothing is written to disk. The copy of +an X11 app that quits is not kept. + | Option | Default | Meaning | | --- | --- | --- | | `copy` | ` KEY_C` | Copy in the focused app | | `paste` | ` KEY_V` | Paste in the focused app | +| `keep_copies` | `true` | Keep what you copy for when its app quits | | `cut` | `none` | Cut (Ctrl+X); in a terminal it copies. Unbound because Super+X keeps a window on top | | `terminals` | a list of terminal names | Words that mark an app id as a terminal | diff --git a/plugins/clipboard-keys/clipboard-keys.xml b/plugins/clipboard-keys/clipboard-keys.xml index f8c1960..e577491 100644 --- a/plugins/clipboard-keys/clipboard-keys.xml +++ b/plugins/clipboard-keys/clipboard-keys.xml @@ -2,7 +2,7 @@ <_short>Clipboard - <_long>Super+C and Super+V copy and paste in every app, terminals included. A terminal gets Ctrl+Shift+C and Ctrl+Shift+V, so Super+C never stops a running program; other apps get Ctrl+C and Ctrl+V. + <_long>Super+C and Super+V copy and paste in every app, terminals included. A terminal gets Ctrl+Shift+C and Ctrl+Shift+V, so Super+C never stops a running program; other apps get Ctrl+C and Ctrl+V. What you copy still pastes after its app quits. Utility +