Skip to content
DreamMaoMao edited this page Aug 29, 2026 · 4 revisions

Welcome to the mangobar wiki!

mangobar is a Wayland status bar for mangowm, built on wlr-layer-shell. It reads all of its runtime settings from JSONC and CSS; there are no hard-coded module defaults beyond the sample files below.

Configuration files

mangobar reads its configuration from these locations, in order of precedence:

File Env var override Default location
Bar / module configuration $MANGOBAR_CONFIG ~/.config/mangobar/config.jsonc
Styling (CSS) $MANGOBAR_CSS ~/.config/mangobar/style.css

Tip: the repository ships working examples to copy as a starting point: config.jsonc and style.css.example.

mkdir -p ~/.config/mangobar
cp config.jsonc ~/.config/mangobar/config.jsonc
cp style.css.example ~/.config/mangobar/style.css

Running

Run mangobar inside a mangowm session:

mangobar

The bar appears automatically and picks up the config and style files above. See Installation for build and package-manager options, Configuration for every bar/module option, and Styling for the CSS side.

Clone this wiki locally