| kanshi(5) | File Formats Manual | kanshi(5) |
kanshi - configuration file
A kanshi configuration file is a list of profiles. Each profile has an optional name and contains profile directives delimited by brackets ({ and }).
Example:
include /etc/kanshi/config.d/*
profile {
output LVDS-1 disable
output "Some Company ASDF 4242" mode 1600x900 position 0,0
}
profile nomad {
output LVDS-1 enable scale 2
}
profile [<name>] { <profile directives...> }
include <path>
Profile directives are followed by space-separated arguments. Arguments can be quoted (with ") if they contain spaces.
output <criteria> <output-command...>
On sway(1), output names and descriptions can be obtained via swaymsg -t get_outputs.
exec <command>
Commands are executed asynchronously and their order may not be preserved. If you need to execute sequential commands, you should collect in one exec statement or in a separate script.
On sway(1) for example, exec can be used to move workspaces to the right output:
profile multihead {
output eDP-1 enable
output DP-1 enable transform 270
exec swaymsg workspace 1, move workspace to eDP-1
}
profile complex {
output "Some Other Company GTBZ 2525" mode 1920x1200
exec swaymsg workspace 1, move workspace to output '"Some Other Company GTBZ 2525"'
}
enable|disable
mode <width>x<height>[@<rate>[Hz]]
Examples:
output HDMI-A-1 mode 1920x1080 output HDMI-A-1 mode 1920x1080@60Hz
position <x>,<y>
Example:
output HDMI-A-1 position 1600,0
scale <factor>
transform <transform>
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.
| 2022-12-20 |