docs/common-workflows/bar.md
komorebi-bar is a status bar for komorebi that renders on top of the tiling
window manager. It is configured through a komorebi.bar.json file, either
alongside your komorebi.json or at the path specified in the
bar_configurations array.
Widgets are placed in the left_widgets, center_widgets, or right_widgets
arrays. Each widget is an object with the widget type as key and its
configuration as value.
| Widget | Description |
|---|---|
Komorebi | Workspaces, layout, focused window, and more |
Battery | Battery level and charging status |
Date | Current date in configurable format |
Time | Current time in configurable format |
Media | Currently playing media information |
Memory | System memory usage |
Network | Network activity and connection status |
Storage | Disk usage information |
Update | Komorebi update notification |
Systray | Windows system tray icons |
Widgets with dedicated documentation pages:
Dedicated pages for the remaining widgets will be added in the future.
The full configuration schema is available at komorebi-bar.lgug2z.com/schema.
For running a bar on each monitor, see Multiple Bar Instances and Multi-Monitor Setup.