kanshi(1)
Kanshi is a dynamic output configuration manager for Wayland compositors that automatically applies display profiles based on connected outputs.
Synopsis
kanshi [OPTION]...Description
Kanshi monitors for changes in connected displays and automatically applies pre-configured output layouts and settings. It reads profiles from a configuration file and switches between them when displays are plugged in or unplugged, eliminating manual display configuration on laptops.
Kanshi works with Wayland compositors that support the wlr-output-management protocol, such as Sway, Hyprland, and other wlroots-based compositors. Each profile specifies display resolution, refresh rate, position, scale, and transform settings.
Common options
| Flag | What it does |
|---|---|
-c, --config FILE | Path to configuration file (default: ~/.config/kanshi/config) |
-l, --log LEVEL | Set logging level: quiet, error, warning, info, or debug |
-h, --help | Show help message and exit |
-v, --version | Show version information |
Examples
Start kanshi daemon with default config file from ~/.config/kanshi/config
kanshiStart kanshi using a custom configuration file location
kanshi -c /etc/kanshi/configRun kanshi with debug logging to troubleshoot profile matching issues
kanshi -l debugReload kanshi configuration by restarting the daemon
pkill kanshi && kanshi &Run kanshi with info logging and save output to a file for debugging
kanshi -l info 2>&1 | tee kanshi.log