StableBar's lighthouse icon

StableBar

A native, configurable menu bar for macOS and an alternative to SketchyBar.
Themes, widgets, popups and workspaces, set up without writing scripts.

Latest release Downloads macOS 14 or later MIT License GitHub stars

Download for Mac · Website · User guide · Widget store · Discussions

Support us on Ko-fi

The top of your bar. A closer look at the widgets: Made yours. The camera pulls back and the intro loops.

## 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

Switching workspaces updates the selected workspace and the app window below, with the screen held still.

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).

The pointer opens music controls and then a CPU and memory graph beneath their widgets.

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

The same bar changes through the included themes while the screen and wallpaper stay still.

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

The pointer opens Edit Bar in Place, drags Now Playing beside the notch and clicks Done.

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

A shell script prints disk usage and its output appears as a widget on the bar.

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

The pointer gets Weather from the Store, and its widget appears on the bar.

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

StableBar Settings and config.json open beneath the bar in a fixed view.

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

M4n0x Seb-GRAF Jonathanm10 albucci amar9elbeg sailedev

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). [![Latest release](https://img.shields.io/github/v/release/Seb-GRAF/StableBar?label=release&color=ffe04a&labelColor=1d1813)](https://github.com/Seb-GRAF/StableBar/releases/latest) [![CI](https://github.com/Seb-GRAF/StableBar/actions/workflows/ci.yml/badge.svg)](https://github.com/Seb-GRAF/StableBar/actions/workflows/ci.yml)