NAME

       iwgtk - Configuration file

LOCATION

       The system-wide configuration file is located at $(sysconfdir)/iwgtk.conf. $(sysconfdir)
       is usually either /etc or /usr/local/etc, depending on your build-time prefix setting.
       iwgtk.conf can be copied to ~/.config/iwgtk.conf if user-specific configuration is
       desired. If a user configuration file exists, then the system-wide configuration file will
       be ignored.

SYNTAX

       The configuration file uses the "key file" syntax, which consists of groups of key-value
       pairs. Blank lines are ignored, and lines beginning with a "#" are considered comments.

       Groups are started by a header line containing the group name enclosed in square brackets.
       A group is ended implicitly by the start of the next group or by the end of the file.
       Every option must be contained in a group. If a group contains the same option key
       multiple times, the last occurrence wins. Unrecognized group or option keys are silently
       ignored. Any option which is not explicitly specified will take on its default value.
       Group names, option keys, and values are all case-sensitive.

       Options have the form key=value. Spaces before or after the '=' character are ignored.
       Newline, tab, carriage return and backslash characters in values must be escaped as \n,
       \t, \r, and \\, respectively. To preserve leading spaces in values, these may be escaped
       as \s.

       Possible option types include strings, integers, and booleans. Boolean options must be
       specified as either "true" or "false". Although colors are technically specified as
       strings, they are regarded herein as a distinct type.

COLOR VALUES

       Color values may consist of:
       •   A standard name (Taken from the CSS specification).
       •   A hexadecimal value in the form "#rgb", "#rrggbb", "#rrrgggbbb" or "#rrrrggggbbbb"
       •   A hexadecimal value in the form "#rgba", "#rrggbbaa", or "#rrrrggggbbbbaaaa"
       •   A RGB color in the form "rgb(r,g,b)" (In this case the color will have full opacity)
       •   A RGBA color in the form "rgba(r,g,b,a)"

       Where "r", "g", "b", and "a" are respectively the red, green, blue and alpha color values.
       In the last two cases, "r", "g", and "b" are either integers in the range 0 to 255 or
       percentage values in the range 0% to 100%, and "a" is a floating point value in the range
       0 to 1.

       See: https://docs.gtk.org/gdk4/method.RGBA.parse.html

       List of standard color names:
       https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/color_keywords

OPTIONS

   [indicator.colors.station]
       Indicator icon colors: station mode

       ┌─────────────┬───────┬───────────────┐
       │   Option    │ Type  │ Default value │
       ├─────────────┼───────┼───────────────┤
       │connected    │ color │ lime          │
       ├─────────────┼───────┼───────────────┤
       │connecting   │ color │ yellow        │
       ├─────────────┼───────┼───────────────┤
       │disconnected │ color │ gray          │
       └─────────────┴───────┴───────────────┘

   [indicator.colors.ap]
       Indicator icon colors: AP mode

       ┌───────┬───────┬───────────────┐
       │Option │ Type  │ Default value │
       ├───────┼───────┼───────────────┤
       │up     │ color │ lime          │
       ├───────┼───────┼───────────────┤
       │down   │ color │ gray          │
       └───────┴───────┴───────────────┘

   [indicator.colors.adhoc]
       Indicator icon colors: ad-hoc mode

       ┌───────┬───────┬───────────────┐
       │Option │ Type  │ Default value │
       ├───────┼───────┼───────────────┤
       │up     │ color │ lime          │
       ├───────┼───────┼───────────────┤
       │down   │ color │ gray          │
       └───────┴───────┴───────────────┘

   [indicator.colors.disabled]
       Indicator icon colors: disabled device or adapter

       ┌────────┬───────┬───────────────┐
       │Option  │ Type  │ Default value │
       ├────────┼───────┼───────────────┤
       │device  │ color │ gray          │
       ├────────┼───────┼───────────────┤
       │adapter │ color │ gray          │
       └────────┴───────┴───────────────┘

   [network.colors]
       Available network list - Signal strength icon colors

       ┌───────────┬───────┬───────────────┐
       │  Option   │ Type  │ Default value │
       ├───────────┼───────┼───────────────┤
       │connected  │ color │ lime          │
       ├───────────┼───────┼───────────────┤
       │connecting │ color │ yellow        │
       ├───────────┼───────┼───────────────┤
       │known      │ color │ darkgreen     │
       ├───────────┼───────┼───────────────┤
       │unknown    │ color │ gray          │
       ├───────────┼───────┼───────────────┤
       │hidden     │ color │ gray          │
       └───────────┴───────┴───────────────┘

   [known-network]
       Known network list - last connection date/time - format string

       ┌─────────────────┬────────┬───────────────┐
       │     Option      │  Type  │ Default value │
       ├─────────────────┼────────┼───────────────┤
       │last-connection- │ string │ %x\n%l:%M %p  │
       │time.format      │        │               │
       └─────────────────┴────────┴───────────────┘

   [window]
       Dark mode and window dimensions

       ┌───────┬─────────┬───────────────┐
       │Option │  Type   │ Default value │
       ├───────┼─────────┼───────────────┤
       │dark   │ boolean │ false         │
       ├───────┼─────────┼───────────────┤
       │width  │ integer │ 440           │
       ├───────┼─────────┼───────────────┤
       │height │ integer │ 600           │
       └───────┴─────────┴───────────────┘

SEE ALSO

       iwgtk(1)

                                            2024-04-02                                   iwgtk(5)