Skip to content
master
Switch branches/tags
Go to file
Code

Latest commit

assert(0) has no effect on NDEBUG builds, and means the program will
continue running in an unexpected state.
dabd7a2

Git stats

Files

Permalink
Failed to load latest commit information.

kanshi

kanshi allows you to define output profiles that are automatically enabled and disabled on hotplug. For instance, this can be used to turn a laptop's internal screen off when docked.

This is a Wayland equivalent for tools like autorandr. kanshi can be used on Wayland compositors supporting the wlr-output-management protocol.

Join the IRC channel: ##emersion on Freenode.

Building

Dependencies:

  • wayland-client
  • scdoc (optional, for man pages)
meson build
ninja -C build

Usage

mkdir -p ~/.config/kanshi && touch ~/.config/kanshi/config
kanshi

Configuration file

Each output profile is delimited by brackets. It contains several output directives (whose syntax is similar to sway-output(5)). A profile will be enabled if all of the listed outputs are connected.

profile {
	output LVDS-1 disable
	output "Some Company ASDF 4242" mode 1600x900 position 0,0
}

profile {
	output LVDS-1 enable scale 2
}

License

MIT