https://github.com/zakk4223/hyprland-easymotion

Easymotion, for hyprland
https://github.com/zakk4223/hyprland-easymotion

Last synced: 2 months ago
JSON representation

Easymotion, for hyprland

• Host: GitHub
• URL: https://github.com/zakk4223/hyprland-easymotion
• Owner: zakk4223
• License: bsd-3-clause
• Created: 2024-04-06T01:13:00.000Z (2 months ago)
• Default Branch: main
• Last Pushed: 2024-04-12T17:49:01.000Z (2 months ago)
• Last Synced: 2024-04-13T00:49:21.124Z (2 months ago)
• Language: C++
• Size: 19.5 KB
• Stars: 2
• Watchers: 2
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-hyprland - hyprland-easymotion

README

        
# 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 gapsin/gapsout workspace layout rule

    #example: textpadding=2 5 5 2 (spaces not commas)

    textpadding=0

    #size of the border around the label box. A border size of zero disables border rendering.

    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:{}`

# 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