1
0
mirror of https://github.com/emersion/kanshi synced 2024-11-22 15:51:58 +01:00
Dynamic display configuration
Go to file
Michael Aquilina 823cdb0f6f Specify correct version in meson.build
kanshi 1.0.0 has been released to github but meson.build was not updated
to reflect this yet.
2019-09-06 20:20:23 +03:00
include Apply profile 2019-06-01 13:25:09 +03:00
protocol Listen to output-management events 2019-06-01 13:25:09 +03:00
.build.yml ci: add .build.yml 2019-06-01 13:33:46 +03:00
.gitignore Add basic parser 2019-06-01 13:25:09 +03:00
kanshi.1.scd Add docs 2019-06-01 13:25:09 +03:00
kanshi.5.scd Showcase output identifiers in docs 2019-06-01 13:25:09 +03:00
LICENSE Add missing LICENSE 2019-08-12 11:45:55 +03:00
main.c Fix head matches indexing 2019-06-07 23:03:16 +03:00
meson_options.txt Generate man pages 2019-06-01 13:25:09 +03:00
meson.build Specify correct version in meson.build 2019-09-06 20:20:23 +03:00
parser.c convert refresh rate from Hz to mHz after parsing 2019-08-13 08:00:03 +02:00
README.md readme: drop mention of sway 2019-08-27 09:07:51 +03:00

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.

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

{
	output LVDS-1 enable scale 2
}

License

MIT