kanshi(5)                     File Formats Manual                    kanshi(5)

<?><?><?> (NAME)
       kanshi - <?><?><?><?> <?><?><?><?><?><?><?><?> kanshi

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> kanshi <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?> (<?><?><?><?><?><?><?><?><?><?>)
       <?><?><?>. <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?> <?><?> <?><?><?><?><?><?> ({ <?> }) <?><?><?><?><?>
       <?><?><?><?><?><?><?>.

       <?><?><?><?>:

           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
           }

<?><?><?><?><?><?><?><?><?><?><?><?><?> (DIRECTIVES)
       profile [<name>] { <<?><?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?>..> }
           <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>. <?><?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.

       output <<?><?><?><?><?>> <<?><?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?>..>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>.

           <?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
           <?><?><?> <?><?><?> <?><?><?> <?><?><?><?>. <?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?>:

               output eDP-1 scale 2

               profile manual {
                    output eDP-1 scale 2
               }

               profile uses-defaults {
                    output eDP-1
               }

           <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?>.

       include <path>
           <?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?> path.
           <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> (<?><?><?><?> <?><?><?><?><?><?> <?><?>
           wordexp(3) <?><?><?><?><?><?> <?><?><?><?><?><?><?>).

<?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> (PROFILE
       DIRECTIVES)
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>.
       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> (<?><?> ") <?><?><?><?> <?><?><?><?><?>.

       output <<?><?><?><?><?>> <<?><?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?>..>
           <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?> (<?><?><?><?><?>) <?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

           <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?> <?><?><?><?>:

           o   <?><?><?> <?><?> <?><?><?><?><?> (<?><?><?><?><?> "DP-1").
               <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
               <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
               <?><?><?><?><?><?> <?><?><?><?><?><?>: <?><?><?><?><?>
               <?><?><?><?> <?><?><?> <?><?> <?><?><?>
               <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
               <?><?><?><?><?> (<?><?><?><?> <?><?> <?><?><?><?><?>
               <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>) <?><?>
               <?><?><?><?><?> <?><?><?><?><?> (<?><?><?><?><?><?><?>
               <?><?><?><?> <?><?><?><?><?><?><?> USB-C) <?><?><?><?><?>
               <?><?><?><?>.
           o   <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
               <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
               <?> <?><?><?><?><?> <?><?><?><?><?> (<?><?><?><?><?> "Foocorp
               ASDF 1234"). <?><?><?><?><?><?><?> <?><?> <?><?>
               <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> (wildcard)
               <?><?><?><?><?><?><?> <?><?><?> (<?><?><?><?><?> "Foocorp ASDF
               *")<?> <?><?> glob(7) <?><?><?><?><?><?> <?><?><?><?>.
               <?><?><?> <?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?>
               <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
               <?><?><?><?> "Unknown" <?><?> <?><?><?> (<?><?><?><?><?>
               "Foocorp ASDF Unknown").
           o   <?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
               (<?><?><?><?><?> "$work-desk3") <?><?> <?><?><?><?>
               <?><?><?><?><?><?><?><?><?><?> alias <?><?><?><?><?> <?><?><?>
               <?><?><?><?>. <?><?><?><?><?><?><?> <?><?><?><?><?><?>
               <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
               <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>.
           o   <?><?> <?><?><?><?><?> <?><?><?><?><?> "*"<?> <?><?><?><?>
               <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>.
               <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?>
               <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
               <?><?><?><?><?> <?> <?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
               <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>.

           <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?>.

           <?><?> sway(1)<?> <?><?><?><?><?><?> <?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> "swaymsg
           -t get_outputs" <?><?> <?><?><?> <?><?><?><?>.

       ...output <<?><?><?><?><?>> <<?><?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?>..>
           <?><?><?><?><?> output<?> <?><?><?> <?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?>.

       exec <<?><?><?><?><?>>
           <?><?> <?><?><?><?><?><?><?><?><?><?> exec <?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?>. <?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>.

           <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> <?> <?><?><?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?>. <?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?> exec
           <?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

           <?><?> <?><?><?><?><?> <?><?><?><?> <?><?> sway(1)<?>
           <?><?><?><?><?><?><?> <?><?> exec <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?>:

               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"'
               }

<?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> (OUTPUT DIRECTIVES)
       enable|disable
           <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       mode preferred
           <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       mode [--custom] <width>x<height>[@<rate>[Hz]]
           <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?>. <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?> <?> <?><?><?><?><?><?> (<?><?> <?><?><?><?><?>) <?>
           <?><?><?> <?><?><?><?><?><?> (<?><?> <?><?><?><?>) <?><?><?><?><?>
           <?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?>.

           <?><?><?><?><?><?><?>:

               output HDMI-A-1 mode 1920x1080
               output HDMI-A-1 mode 1920x1080@60Hz
               output HDMI-A-1 mode --custom 1280x720@60Hz

       position <x>,<y>
           <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

           <?><?><?><?>:

               output HDMI-A-1 position 1600,0

       scale <<?><?><?><?>>
           <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?>.

       transform <<?><?><?><?><?>>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?><?><?><?>
           <?><?><?> <?><?> <?><?><?><?><?><?> "90"<?> "180"<?> "270"
           <?><?><?><?> <?><?><?><?><?> <?><?> "flipped"<?> "flipped-90"<?>
           "flipped-180"<?> "flipped-270" <?><?><?><?> <?><?><?><?> <?>
           <?><?><?><?><?><?><?> <?><?> "normal" <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?>.

       adaptive_sync on|off
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> (<?><?>
           <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> / VRR)
           <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?>.

       alias $<name>
           <?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
           <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?>.

<?><?><?><?><?><?><?><?><?> (AUTHORS)
       <?><?><?><?><?><?><?> <?><?><?><?> Simon Ser <contact@emersion.fr>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> kanshi<?>
       <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?>:
       <https://gitlab.freedesktop.org/emersion/kanshi>.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       kanshi(1)

                                  2026-02-01                         kanshi(5)