i3barfodder documentation

i3barfodder collects information from workers and forwards it to i3bar, the status bar of the window manager i3. A worker is simply an executable that prints plain text or JSON to STDOUT in an endless loop.

i3barfodder’s main feature is to offer workers easy access to less straightforward concepts like bars and dynamic color gradients based on current values.

For workers written in Python 3 i3barfodder comes with i3bfutils, a package that

  • provides easy access to system information (CPU, network, storage, etc) and wraps low-level utilities like inotify,
  • offers various simple helpers, for example to calculate an average rate over time or to convert numbers to a human-readable format (1000000->1M),
  • optimizes complex output with user configurable templates.