NAME

       kanshi - configuration file

DESCRIPTION

       A  kanshi  configuration  file is a list of profiles. Each profile is delimited by brackets ({ and }) and
       contains directives.

       Example:

           {
                output LVDS-1 disable
                output "Some Company ASDF 4242" mode 1600x900 position 0,0
           }

           {
                output LVDS-1 enable scale 2
           }

DIRECTIVES

       Directives are followed by space-separated arguments. Arguments can be quoted (with ")  if  they  contain
       spaces.

       output <criteria> <output-command...>
           An  output  directive  adds  an  output to the profile. The criteria can either be an output name, an
           output description or "*". The latter can be used to match any output.

           On sway(1), output names and descriptions can be obtained via swaymsg -t get_outputs.

OUTPUT DIRECTIVES

       enable|disable
           Enables or disables the specified output.

       mode <width>x<height>[@<rate>[Hz]]
           Configures the specified output to use the specified mode. Modes  are  a  combination  of  width  and
           height (in pixels) and a refresh rate (in Hz) that your display can be configured to use.

           Examples:

               output HDMI-A-1 mode 1920x1080 output HDMI-A-1 mode 1920x1080@60Hz

       position <x>,<y>
           Places the output at the specified position in the global coordinates space.

           Example:

               output HDMI-A-1 position 1600,0

       scale <factor>
           Scales the output by the specified scale factor.

       transform <transform>
           Sets  the  output  transform.  Can  be  one  of  "90",  "180",  "270"  for  a rotation; or "flipped",
           "flipped-90", "flipped-180", "flipped-270" for a rotation and a flip; or "normal" for no transform.

AUTHORS

       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.

SEE ALSO

       kanshi(1)

                                                   2019-08-30                                          kanshi(5)