mirror of https://github.com/ericonr/kanshi.git
Érico Nogueira
f2781d5223
|
||
|---|---|---|
| include | ||
| protocol | ||
| .build.yml | ||
| .gitignore | ||
| LICENSE | ||
| README.md | ||
| ctl.c | ||
| event-loop.c | ||
| ipc-addr.c | ||
| ipc.c | ||
| kanshi.1.scd | ||
| kanshi.5.scd | ||
| kanshictl.1.scd | ||
| main.c | ||
| meson.build | ||
| meson_options.txt | ||
| parser.c | ||
README.md
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 Libera Chat.
Building
Dependencies:
- wayland-client
- scdoc (optional, for man pages)
- libvarlink (optional, for remote control functionality)
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