NAME

       phoc.ini - Configuration file for phoc

DESCRIPTION

       Most of phoc's configuration is read from GSettings. Output and core settings are read from phoc.ini. The
       configuration  file  is  searched in phoc's current working directory. It's path can also be given on the
       command line via the -C option.

       The phoc.ini file is composed of multiple sections which can be in any order. If  values  are  not  given
       then  built  in  defaults  are  used. The main purpose of phoc.ini is to specify output configuration and
       layouts.  Each section has the form:

          [SectionHeader]
          key1 = value1
          key2 = value2

       Lines starting with # are considered comments and are ignored. The section headers might contain a  colon
       in which case the part after the colon specifies the configuration item e.g.

          [output:DSI-1]

       is the configuration section for the output DSI-1.

       The available section headers are:

       • core: core options

       • output: output configuration

       Modifications to this file require a compositor restart to take effect.

CORE SECTION

       The core section can appear only once and has a single option:

       • xwayland=[true|immediate|false]:  Whether  to  enable  XWayland.  With true XWayland is activated when,
         needed. immediate launches it immediately and false turns it off.

OUTPUT SECTION

       The output section can appear multiple times with different configuration items

          [output:ITEM]

       ITEM is either the DRM connector name like DSI-1 or DP-2 or the make, model and serial as  obtained  from
       EDID  separated by %: [output:A Vendor%The Model%Serial]. Make, model and serial can be specified as * to
       match any value. The configuration options are:

       • enable=[true|false]: Whether the output should be enabled

       • x, y: The x and y position in the output layout. This can be used to arrange outputs.  The  default  is
         to use automatic layout (new outputs are added to the right of the current layout).

       • scale: The outputs scale. The default auto calculates the scale based on the screen size.

       • rotate:  The  rotation.  Valid  values  are  normal, 90, 180, 270, flipped, flipped-90, flipped-180 and
         flipped-270. The default is to use normal orientation.

       • mode: The mode to use. The mode must be a valid mode for this output. See e.g. the output of wlr-randr.
         The default is to use the outputs preferred mode.

       • modeline: A custom video mode. This is only valid for the DRM backend

       • scale-filter: Filter to use to scale down textures. Valid values are bilinear, nearest and  auto.   The
         later  selects  bilinear  for fractional and nearest for integer scales automatically. If unset auto is
         assumed.

       • drm-panel-orientation: If  true  applies  the  panel  orientation  read  from  the  DRM  connector  (if
         available). Defaults to true.

       • phys_width, phys_height: The physical dimensions of the display in mm.

       Example:

          [output:DSI-1]
          scale = 2

          [output:Some Vendor%Some Model%*]
          scale = 1
          rotate = 90
          x = 300

SEE ALSO

       phoc(1) wlr-randr(1)

                                                                                                      PHOC.INI()