hyprland-wiki/pages/Useful Utilities/Clipboard-Managers.md

112 lines
2.9 KiB
Markdown
Raw Normal View History

---
weight: 9
title: Clipboard managers
---
_Starting method:_ manual (`exec-once`)
Clipboard Managers provide a convenient way to organize and access previously
copied content, including both text and images.
Some common ones used are `copyq`, `clipman` and `cliphist`.
`clipman` - Utilizes Wayland with `wl-clipboard` support and stores text only
[Github](https://github.com/chmouel/clipman)
`cliphist` - Utilizes Wayland with `wl-clipboard` and can store both images and
text [Github](https://github.com/sentriz/cliphist)
`wl-clip-persist` - When copying something on Wayland, the copied data remains
in the clipboard until the application that was copied from is closed.
After that, the data disappears and can no longer be pasted.
To fix this problem, you can use `wl-clip-persist` which will preserve the data
in the clipboard after the application is closed.
[Github](https://github.com/Linus789/wl-clip-persist)
## copyq
Start by adding the following lines to your `~/.config/hypr/hyprland.conf`
```ini
exec-once = copyq --start-server
```
If the main window of `copyq` cannot close/hide properly, try to enable its
"Hide main window" option in the Layout configuration tab in the Preferences dialog.
## cliphist
Start by adding the following lines to your `~/.config/hypr/hyprland.conf`
```ini
exec-once = wl-paste --type text --watch cliphist store #Stores only text data
exec-once = wl-paste --type image --watch cliphist store #Stores only image data
```
Note that any of the above lines can be disabled based on your needs.
To bind `cliphist` to a hotkey and display it under `rofi` or `dmenu` or `wofi`,
you can edit it in `~/.config/hypr/hyprland.conf`.
2023-04-17 01:13:48 +02:00
### For `rofi` users
```ini
bind = SUPER, V, exec, cliphist list | rofi -dmenu | cliphist decode | wl-copy
```
2023-04-17 01:13:48 +02:00
### For `dmenu` users
```ini
bind = SUPER, V, exec, cliphist list | dmenu | cliphist decode | wl-copy
```
### For `wofi` users
```ini
bind = SUPER, V, exec, cliphist list | wofi --dmenu | cliphist decode | wl-copy
```
The binds above allow `SUPER + V` to be used to access the clipboard history.
For further info, please refer to the repository mentioned above.
## clipman
Start by adding the following line to your `~/.config/hypr/hyprland.conf`
```ini
exec-once = wl-paste -t text --watch clipman store --no-persist
```
If you wish to use it as a primary clipboard manager, use this instead:
```ini
exec-once = wl-paste -p -t text --watch clipman store -P --histpath="~/.local/share/clipman-primary.json"
```
Ensure that `~/.local/share/clipman-primary.json` is already created.
Now you can bind `clipman` like this:
2023-04-17 01:13:48 +02:00
### For `rofi` users
```ini
bind = SUPER, V, exec, clipman pick -t rofi
```
2023-04-17 01:13:48 +02:00
### For `dmenu` users
```ini
bind = SUPER, V, exec, clipman pick -t dmenu
```
### For `wofi` users
```ini
bind = SUPER, V, exec, clipman pick -t wofi
```
...and so on. For further information, please refer to the repository
mentioned above.