mirror/kanshi
1
0
Fork 0
mirror of https://github.com/emersion/kanshi synced 2024-09-18 09:51:36 +02:00
Code Issues Releases Activity
Dynamic display configuration
73 Commits 2 Branches 3 Tags 314 KiB
C 92.7%
Meson 7.3%
823cdb0f6f
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

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 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