iwgtk(5)

✨ NAME ✨

okay so bestie, this is the iwgtk(5) page πŸ’– it's filed under the File Formats Manual, and it's literally just about the configuration file for iwgtk. that's it. that's the whole vibe. no cap.


πŸ“ LOCATION πŸ“

where does this config file even live?? good question, here we go 🫢

  • The system-wide config file sits at $(sysconfdir)/iwgtk.conf.
  • $(sysconfdir) is usually either /etc or /usr/local/etc, depending on your build-time prefix setting.
  • Want your own personal one? copy iwgtk.conf over to ~/.config/iwgtk.conf ✨
  • IMPORTANT 🚨 if a user configuration file exists, then the system-wide configuration file will be ignored. like, fully ghosted. so don't be out here editing the system one and wondering why nothing changed 😭

πŸ“ SYNTAX πŸ“

so the config file uses the "key file" syntax, which is basically groups of key-value pairs. iconic format honestly πŸ’…

  • Blank lines are ignored. they're giving nothing and we respect that.
  • Lines beginning with a # are considered comments. yap freely πŸŽ€
  • 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. no closing tag needed, it's very chill 🌈
  • Every option must be contained in a group. no option is allowed to just be floating around unsupervised πŸ™ˆ
  • If a group contains the same option key multiple times, the last occurrence wins. last one to speak gets the mic 🎀
  • Unrecognized group or option keys are silently ignored. no error, no drama, just silence πŸ’€
  • Any option which is not explicitly specified will take on its default value.
  • Group names, option keys, and values are all case-sensitive. so don't get cute with the capitals βœ‹

Options have the form key=value. Spaces before or after the = character are ignored. but listen, the escapes matter:

  • 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". and 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

  • connected β€” type: color, default: lime πŸ’š
  • connecting β€” type: color, default: yellow πŸ’›
  • disconnected β€” type: color, default: gray 🩢

πŸ¦‹ [indicator.colors.ap] πŸ¦‹

Indicator icon colors: AP mode

  • up β€” type: color, default: lime πŸ’š
  • down β€” type: color, default: gray 🩢

πŸ¦‹ [indicator.colors.adhoc] πŸ¦‹

Indicator icon colors: ad-hoc mode

  • up β€” type: color, default: lime πŸ’š
  • down β€” type: color, default: gray 🩢

πŸ¦‹ [indicator.colors.disabled] πŸ¦‹

Indicator icon colors: disabled device or adapter

  • device β€” type: color, default: gray 🩢
  • adapter β€” type: color, default: gray 🩢

πŸ¦‹ [network.colors] πŸ¦‹

Available network list β€” Signal strength icon colors

  • connected β€” type: color, default: lime πŸ’š
  • connecting β€” type: color, default: yellow πŸ’›
  • known β€” type: color, default: darkgreen 🌲
  • unknown β€” type: color, default: gray 🩢
  • hidden β€” type: color, default: gray 🩢

🌸 [known-network] 🌸

Known network list β€” last connection date/time β€” format string

  • last-connection-time.format β€” type: string, default: %x\n%l:%M %p πŸ•°οΈ

πŸͺŸ [window] πŸͺŸ

Dark mode and window dimensions

  • dark β€” type: boolean, default: false πŸŒ™
  • width β€” type: integer, default: 440 πŸ“
  • height β€” type: integer, default: 600 πŸ“

πŸ‘€ SEE ALSO πŸ‘€

iwgtk(1)


and that's the whole page bestie, you ate that 🫢 this was iwgtk(5) from 2026-01-21 (yes the date is giving future, it is what it is, don't question it πŸ’…) β€” go forth and configure, no cap βœ¨πŸŽ€πŸ’–

πŸ“¦ where this page comes from