fookb(1)

💖 fookb — the Xkb state indicator that's literally your keyboard's main character ✨

okay bestie, so fookb (that's manual page fookb(1), in the General Commands Manual section) is this adorable little Xkb state indicator with optional Window Maker support, and honestly? it's giving keyboard icon energy and I'm obsessed 💅

---

✨ SYNOPSIS ✨

fookb [options]

---

🌸 DESCRIPTION 🌸

so basically fookb is an Xkb state indicator, and what it does is display the icon that corresponds to the number of the Xkb locked group 🎀. you can also use mouse-clicks to change the Xkb locked group with your mouse, iconic. and on top of that, fookb can be configured to execute a program whenever the group changes — like, it'll run a whole command for you, periodt.

ngl, the fookb man page is based on the WMMail.app man page, but the program itself was written from scratch 💖.

and if you wanna use fookb with the Window Maker Dock? just drag the fookb icon onto the Window Maker Dock 🫶 — that works if fookb was compiled with Window Maker support, iykyk.

---

💅 OPTIONS 💅

⚠️ NB! Command line parameters take precedence over config file! like, the command line wins, no cap.

also important, bestie: all the icons should be of the same size or fookb will refuse to run 😭. and if you use icons bigger than 64x64, fookb will warn you, but it'll try to run anyway — so brave of it fr fr.

• --icon1 — the icon to show for the 1st Xkb group 🌸
• --icon2 — the icon to show for the 2nd Xkb group 🦋
• --icon3 — the icon to show for the 3rd Xkb group 🎀
• --icon4 — the icon to show for the 4th Xkb group ⭐
• --iconboom — the icon to show when the Xkb system goes crazy 💀 (yes really, that's what the man page says, and honestly? relatable)
• -d, --display — the X display to use (normally you don't need this, it's just there for the vibes)

---

🎀 CONFIGURATION FILE 🎀

so the config file is a single PropList dictionary, which is itself made up of several PropList key-value pairs 💖. here are the keys it recognizes:

• Icon1 Filename (mandatory) — an XPM file containing an icon for the 1st XKB group.
• Icon2 Filename (mandatory) — an XPM file containing an icon for the 2nd XKB group.
• Icon3 Filename (mandatory) — an XPM file containing an icon for the 3rd XKB group.
• Icon4 Filename (mandatory) — an XPM file containing an icon for the 4th XKB group.
• IconBoom Filename (mandatory) — an XPM file containing an icon for "broken Xkb" 😭 — please look in the BUGS section below, bestie, it explains everything.
• Sound (Yes|No) — if this is set to "Yes", fookb will run the command from the "Command" value (see below 👇). if this parameter isn't defined, you'll get a (non-fatal) error message. in any other case, the command will not be run. that's it, that's the rule.
• *Command *command_to_run** — this command gets run if the XKB locked group is changed <purple>and</purple> "Sound"is set to"Yes"`.

---

🌈 EXAMPLES 🌈

here's an example config file, look at her go:

{
  Icon1 = "/usr/local/share/fookb/icon1.xpm";
  Icon2 = "/usr/local/share/fookb/icon2.xpm";
  Icon3 = "/usr/local/share/fookb/icon3.xpm";
  Icon4 = "/usr/local/share/fookb/icon4.xpm";
  IconBoom = "/usr/local/share/fookb/crash.xpm";
  Sound = "Yes";
  Command = "/usr/bin/play /usr/local/share/fookb/click.au";
}

---

🦋 FILES 🦋

• ~/.fookb — fookb defaults 💖

---

💀 BUGS 💀

okay so sometimes fookb receives a message about changing XKB group, but message.state.group does not point to any existing XKB group. in this case, fookb will show the IconBoom picture (from the config file) 😭. iconic workaround honestly.

and as far as the author knows, the only way to look at this bug is to run vmware. yeah. that's the vibe.

---

⭐ VERSION ⭐

this man page is [hopefully] up-to-date for version 4.1 of fookb ✨

---

👑 AUTHORS 👑

• fookb is (c) 1998-2004 Alexey Vyskubov <alexey@mawhrin.net> 💖
• this manpage was written by Alexey Vyskubov <alexey@mawhrin.net> 🎀

---

and that's the whole page, bestie!! this was the fookb(1) General Commands Manual, dated September 2017, for fookb — go forth and slay your Xkb groups 💅✨🦋