![nwg-shell logo](https://private-user-images.githubusercontent.com/20579136/300184187-7ed28176-9dba-4897-a46a-f373891b7d18.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjQ4MDcwODYsIm5iZiI6MTcyNDgwNjc4NiwicGF0aCI6Ii8yMDU3OTEzNi8zMDAxODQxODctN2VkMjgxNzYtOWRiYS00ODk3LWE0NmEtZjM3Mzg5MWI3ZDE4LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA4MjglMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwODI4VDAwNTk0NlomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWVkZDgyODkyZGQ5ZmE4ODE0ZDVkZDM3MDY2YTllODkwOWM4MTc5NjZlY2Y2ZTZkMTgyZTZjOGM5ZGIwOWJmNjEmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.XNO2QHz9WAklUiVFotffI_Fc66A2bM0ibHHoNtcq6qo)
This program is a part of the nwg-shell project.
Nwg-clipman is a GTK3-based GUI for Senan Kelly's cliphist. It provides access to previously copied items, as well as management of the clipboard history from a window opened on gtk-layer-shell. The program is intended for use with sway, Hyprland and other wlroots-based Wayland compositors.
- image & text history item preview;
- searching clipboard history by a textual phrase;
- deleting selected history item;
- clearing clipboard history.
- python >= 3.6;
- python-gobject;
- gtk3;
- gtk-layer-shell;
- wl-clipboard;
- cliphist;
- xdg-utils.
The program may be installed by cloning this repository and executing the install.sh
script (make sure you installed
dependencies first). Then you need to edit your compositor config file, to enable storing clipboard history to cliphist.
Example for sway:
exec wl-paste --type text --watch cliphist store
exec wl-paste --type image --watch cliphist store
Example for Hyprland:
exec-once = wl-paste --type text --watch cliphist store
exec-once = wl-paste --type image --watch cliphist store
You may omit the second line if you don't want images to be remembered.
Then create a key binding to launch nwg-clipman:
Example for sway:
bindsym Mod1+C exec nwg-clipman
Example for Hyprland:
bind = ALT, C, exec, nwg-clipman
❯ nwg-clipman -h
usage: nwg-clipman [-h] [-v] [-n] [-w]
options:
-h, --help show this help message and exit
-v, --version display Version information
-n, --numbers show item Numbers in the list
-w, --window run in regular Window, w/o layer shell
- To see numbers in the cliboard history use the
nwg-clipman -n
command. - If you'd like the window to open normally, not on the layer shell, use the
nwg-clipman -w
command. - You may clear the search entry / close the program window with the
Esc
key.