Provided by: iwgtk_0.9-1_amd64 
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-time.format │ string │ %x\n%l:%M %p │
└─────────────────────────────┴────────┴───────────────┘
[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)