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
107 Commits 2 Branches 3 Tags 314 KiB
C 92.7%
Meson 7.3%
992c1954a6
Go to file
Simon Ser 992c1954a6 readme: finish migration to SourceHut
2021-09-15 10:32:14 +02:00
include Add optional varlink interface. 2021-07-24 08:34:35 +02:00
protocol
.build.yml Add CI step to test build without varlink. 2021-07-24 08:34:35 +02:00
.gitignore
ctl.c Add kanshictl utility. 2021-07-24 08:34:35 +02:00
event-loop.c Add optional varlink interface. 2021-07-24 08:34:35 +02:00
ipc-addr.c Add optional varlink interface. 2021-07-24 08:34:35 +02:00
ipc.c Add optional varlink interface. 2021-07-24 08:34:35 +02:00
kanshi.1.scd man: fix wrong section headers 2021-08-22 20:55:26 +02:00
kanshi.5.scd
kanshictl.1.scd Add kanshictl utility. 2021-07-24 08:34:35 +02:00
LICENSE
main.c Add optional varlink interface. 2021-07-24 08:34:35 +02:00
meson_options.txt Add optional varlink interface. 2021-07-24 08:34:35 +02:00
meson.build Add kanshictl utility. 2021-07-24 08:34:35 +02:00
parser.c
README.md readme: finish migration to SourceHut 2021-09-15 10:32:14 +02: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 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
}

Contributing

The upstream repository can be found on SourceHut. Open tickets on the SourceHut tracker, send patches on the mailing list.

License

MIT