waybar-cffi(5)

💖 NAME 💖

waybar — the cffi module, bestie 💅

---

✨ DESCRIPTION ✨

okay so picture this: the cffi module hands full control of a GTK widget over to a third-party dynamic library, so you can build way more complex modules in whatever programming language your heart desires 🌈🦋

like. the widget is literally theirs now. main character energy, no cap.

---

🎀 CONFIGURATION 🎀

you address this one by cffi/<name> — that's the vibe, iykyk.

• module_path — typeof: string. it's the path to the dynamic library you wanna load to control the widget 🫶
• expand — typeof: bool, default: false. flip this on and your module gets to consume all left over space dynamically — yes queen, take up that room 👑

also lowkey: some extra configuration might be required depending on which cffi dynamic library you're using. that part's on them, not on this page 💀

---

🌸 EXAMPLES 🌸

💜 C example:

there's an example module written in C sitting right here, go be nosy:

https://github.com/Alexays/Waybar/resources/custom_modules/cffi_example/

and here's the Waybar config to enable the module, fr fr:

"cffi/c_example": {
     "module_path": ".config/waybar/cffi/wb_cffi_example.so"
}

---

🦋 STYLE 🦋

here's the tea: the classes and IDs are managed by the cffi dynamic library. not you. not waybar. the library. periodt 💅✨

---

and that's the whole page bestie!! 🎀 this lil slice of the File Formats Manual is the waybar-cffi(5) page, dated 2026-02-08 — mwah, obsessed, go write something iconic 💖👑🌟