4391f5c369
Changes to example keybinds to make it clear that you need to specify easymotion as the dispatcher and fix of context typo in the second example.
71 lines
2.4 KiB
Markdown
71 lines
2.4 KiB
Markdown
# hyprEasymotion
|
|
Plugin to enable 'easymotion' navigation. Inspired by Xmonad easymotion (which is in turn inspired by vim-easymotion)
|
|
|
|
https://github.com/zakk4223/hyprland-easymotion/assets/22642/9382b23e-efbd-466c-b071-127a53f0c48b
|
|
|
|
# Configuration
|
|
Easymotion is basically a single dispatcher that brings up window labels and then allows you to execute a user-defined command when one of those labels is typed.
|
|
|
|
`bind = SUPER, z, easymotion, action:hyprctl dispatch focuswindow address:{}`
|
|
|
|
This bind will bring up easymotion with SUPER-z. Once you select a window the window
|
|
will focus. If you want to change the command, the selected window's address is substituted where "{}" occurs.
|
|
|
|
|
|
You can configure the appearance of the labels. Defaults are as follows:
|
|
|
|
```
|
|
plugin {
|
|
easymotion {
|
|
#font size of the text
|
|
textsize=15
|
|
|
|
#color of the text, takes standard hyprland color format
|
|
textcolor=rgba(ffffffff)
|
|
|
|
#background color of the label box. alpha is respected
|
|
bgcolor=rgba(000000ff)
|
|
|
|
#font to use for the label. This is passed directly to the pango font description
|
|
textfont=Sans
|
|
|
|
#padding around the text (inside the label box) size in pixels, adjusted for
|
|
#monitor scaling. This is the same format as hyprland's gaps_in/gaps_out
|
|
textpadding=0
|
|
|
|
#size of the border around the label box
|
|
bordersize=0
|
|
|
|
#color of the border. takes the same format as hyprland's border (so it can be a gradient)
|
|
bordercolor=rgba(ffffffff)
|
|
|
|
#rounded corners? Same as hyprland's 'decoration:rounding' config
|
|
rounding=0
|
|
|
|
#which keys to use for labeling windows
|
|
motionkeys=abcdefghijklmnopqrstuvwxyz1234567890
|
|
}
|
|
}
|
|
```
|
|
|
|
Every one of these variables is also settable via the dispatcher, so you can create multiple dispatchers that look different based on function.
|
|
|
|
`bind = SUPER, z, easymotion, bgcolor:rgba(ff0000ff);bordersize=5;action:hyprctl dispatch closewindow address:{}`
|
|
|
|
### IMPORTANT
|
|
The easymotion arguments are separated by a semicolon, not a comma. (gap/padding format uses commas :/)
|
|
|
|
# Installing
|
|
|
|
## Hyprpm, Hyprland's official plugin manager (recommended)
|
|
1. Run `hyprpm add https://github.com/zakk4223/hyprland-easymotion` and wait for hyprpm to build the plugin.
|
|
2. Run `hyprpm enable hyprEasymotion`
|
|
|
|
|
|
# TODO
|
|
- [ ] Blur?
|
|
- [ ] Allow multi-letter labels?
|
|
- [ ] Fixed/static label box sizing
|
|
- [ ] Location of label in window (edges etc)
|
|
- [ ] Auto label placement that tries to avoid being occluded
|