StableBar
A native, configurable menu bar for macOS and an alternative to SketchyBar.
Themes, widgets, popups and workspaces, set up without writing scripts.
Download for Mac ·
Website ·
User guide ·
Widget store ·
Discussions

## Install
Download [StableBar.dmg](https://github.com/Seb-GRAF/StableBar/releases/latest), drag it to Applications and open it. Setup walks you through a preset, a theme and a placement.
Or install with [Homebrew](https://brew.sh):
```sh
brew install --cask seb-graf/tap/stablebar
```
**macOS 14+ · Apple silicon · Free and open source.** Releases update themselves. See [Getting started](docs/getting-started.md) for permissions, beta updates and uninstalling.
## Workspaces and popups

Follow your workspaces with [AeroSpace](https://github.com/nikitabobko/AeroSpace), [yabai](https://github.com/koekeishiya/yabai), [OmniWM](https://github.com/OmniNull/OmniWM) or [Rift](https://github.com/acsandmann/rift). Without a window manager, try the opt-in [macOS Spaces source](docs/widgets.md#macos-spaces-workspaces).

Keep the active app, calendar, system stats and playback controls in reach. Widgets can open popups with graphs, lists and controls. Each display gets its own bar, with room for the notch.
[Built-in widgets](docs/widgets.md) · [Custom popups](docs/popups.md) · [Multiple displays](docs/layout.md)
## Make it yours

Choose from Built-in and six bundled themes, or save your own.

Right-click the bar and choose **Edit Bar in Place** to drag widgets between positions, add them with **+** or remove them with **−**. Changes save as you go, with undo.
[Themes](docs/themes.md) · [Editing your bar](docs/settings.md)
## Add your widgets

Run a command that prints text or JSON, and its output becomes a widget. Refresh on a timer or on events.

Find widgets and themes in **Settings → Store**. StableBar shows a package's commands, hosts and permissions before anything runs.
[Create a widget](docs/create-a-widget.md) · [Packages and the store](docs/packages.md#store)
A shell script is enough
```sh
#!/bin/sh
# ~/.config/stablebar/widgets/disk.sh
used=$(df -h / | awk 'NR == 2 { print $5 }')
printf '{"text":"%s","icon":"internaldrive"}' "$used"
```
```json
{
"id": "disk", "type": "script", "position": "right", "interval": 300,
"command": "~/.config/stablebar/widgets/disk.sh"
}
```
## Settings or JSON

Change content, appearance and behavior in Settings, with undo and redo. Or edit `~/.config/stablebar/config.json`: StableBar applies it when you save and keeps the last working bar if a change is invalid. The JSON schema gives your editor completion and validation.
[Settings](docs/settings.md) · [Configuration](docs/configuration.md) · [Command line](docs/command-line.md) · [Example setups](examples)
A minimal configuration
```json
{
"$schema": "https://raw.githubusercontent.com/Seb-GRAF/StableBar/main/stablebar.schema.json",
"theme": { "id": "catppuccin" },
"widgets": [
{ "id": "spaces", "type": "workspaces", "position": "left" },
{ "id": "app", "type": "activeApp", "position": "left" },
{ "id": "power", "type": "battery", "position": "right" },
{ "id": "clock", "type": "clock", "position": "right", "format": "EEE d MMM HH:mm" }
]
}
```
## Contributing
Built by [Sebastien Graf](https://github.com/Seb-GRAF) and [Steve Mendes Reis](https://github.com/M4n0x), with help from [everyone who has contributed](https://github.com/Seb-GRAF/StableBar/graphs/contributors).
Questions, ideas and setups to share go in [Discussions](https://github.com/Seb-GRAF/StableBar/discussions). Bug reports and pull requests are welcome. [CONTRIBUTING.md](CONTRIBUTING.md) explains how to build StableBar, run the tests and open a pull request. Report security issues privately through [SECURITY.md](.github/SECURITY.md).
Available under the [MIT License](LICENSE), including commercial use and redistribution.
If StableBar is useful to you, you can [buy us a coffee on Ko-fi](https://ko-fi.com/stablebar).
[](https://github.com/Seb-GRAF/StableBar/releases/latest)
[](https://github.com/Seb-GRAF/StableBar/actions/workflows/ci.yml)