Skip to content

ralphptorres/waybound

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

waybound

hot boundaries (corners and edges) for wayland. a small util that triggers commands when the pointer enters configured boundaries. it should work with wlroots-based compositors like sway and river, as well as non-wlroots ones like niri. tested on sway, river, and niri so far

waybound demo

usage

waybound is meant to run in the background, so start it like this:

waybound &

configure it either with cli flags or with a config file. the default config path is ${XDG_CONFIG_HOME:-$HOME/.config}/waybound/waybound.toml

flags example:

waybound -s 15 \
  --rule top=alacritty \
  --rule top-right=swaylock \
  --rule right="notify-send hello $HOME"

config example (equivalent to the flags example, except for debug = true):

debug = true
size = 15

[[boundaries]]
boundary = "top"
command = "alacritty"

[[boundaries]]
boundary = "top-right"
command = "swaylock"

[[boundaries]]
boundary = "right"
command = "notify-send hello $HOME"

cli flags override config rules for the same boundary. default boundary size is 5 px. supported boundaries include top-left, top-right, bottom-left, bottom-right, top, bottom, left, and right

install and build

  • archlinux aur: paru -S waybound
  • manual build: cargo build --release

release builds are tuned to stay smaller, and the implementation uses direct wayland client bindings rather than a larger ui toolkit like smithay

license

MIT

About

hot boundaries (corners and edges) for wayland

Resources

License

Stars

5 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages