kanshi1
Dynamic output configuration
Usage
kanshi [options ...]
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.
Overview
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.
Configuration
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).
Releases
4 releases since Debian 11 (Bullseye); the text changed 3 times.
--config since Debian 12 (Bookworm);
--help since Debian 12 (Bookworm);
--listen-fd since Debian 13 (Trixie);
-c since Debian 12 (Bookworm);
-h since Debian 12 (Bookworm);
-l since Debian 13 (Trixie).