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 directives delimited by brackets ({ and }).
Example:
profile { output LVDS-1 disable output "Some Company ASDF 4242" mode 1600x900 position 0,0 } profile nomad { output LVDS-1 enable scale 2 }
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:
multihead { output eDP-1 enable output DP-1 enable transform 270 exec swaymsg workspace 1, move workspace to eDP-1 }
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:
position <x>,<y>
Example:
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://github.com/emersion/kanshi.
2020-04-05 |