---
name: "waybar-cffi"
section: "5"
platform: "linux"
package: "waybar"
version: "0.15.0-3"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/waybar-cffi"
---

# waybar-cffi(5)

cffi module

## NAME

waybar - cffi module

## DESCRIPTION

The **cffi** module gives full control of a GTK widget to a third-party dynamic library, to create more complex modules using different programming languages.

## CONFIGURATION

Addressed by **cffi/\<name\>**

**module\_path**: \
 typeof: string \
 The path to the dynamic library to load to control the widget.

**expand**: \
 typeof: bool \
 default: false \
 Enables this module to consume all left over space dynamically.

Some additional configuration may be required depending on the cffi dynamic library being used.

## EXAMPLES

### C example:

An example module written in C can be found at https://github.com/Alexays/Waybar/resources/custom\_modules/cffi\_example/

Waybar config to enable the module:

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

## STYLE

The classes and IDs are managed by the cffi dynamic library.