Your company here — click to reach over 10,000 unique daily visitors

kanshi - Man Page

dynamic output configuration


kanshi [options...]


-h,  --help

Show help message and quit.

-c,  --config <config>

Specifies a config file.

-l,  --listen-fd <fd>

Listen on the specified file descriptor for IPC.


kanshi is a Wayland daemon that automatically configures outputs.

kanshi is configured with a list of output profiles. Each profile contains a set of outputs. A profile will be automatically activated if all specified outputs are currently connected. A profile contains configuration for each output.

If kanshi receives a SIGHUP signal, it will reread its config file.


kanshi reads its configuration from $XDG_CONFIG_HOME/kanshi/config. If unset, $XDG_CONFIG_HOME defaults to ~/.config.

An error is raised if no configuration file is found.

For information on the configuration file format, see kanshi(5).


Maintained by Simon Ser <contact@emersion.fr>, who is assisted by other open-source contributors. For more information about kanshi development, see <https://git.sr.ht/~emersion/kanshi>.

See Also

kanshi(5) kanshictl(1)

Referenced By

kanshi(5), kanshictl(1).