EasyBar is a lightweight, scriptable macOS status bar built with SwiftUI and Lua. It combines native widgets with custom Lua widgets and integrates with AeroSpace.
- Native widgets for Spaces, apps, system status, calendar, and more
- Scriptable Lua widgets with events, popups, groups, and context menus
- Installable Lua widgets and libraries from the official package registry
- Shared Inbox with unread state, grouping, Markdown, and widget actions
- File-based TOML themes and comment-preserving configuration updates
- AeroSpace integration and separate calendar and network helper agents
- Menu-bar controller and CLI for runtime control and diagnostics
See more screenshots in the EasyBar overview and the built-in widget guides.
- macOS 14 Sonoma or newer
- Homebrew for installation
- AeroSpace 0.21.0 or newer when using AeroSpace-backed widgets
brew tap easybar-app/tap
brew install --cask easybar-app/tap/easybar
open -a EasyBarSee the installation guide for upgrades, verification, and removal.
The full documentation is available at easybar.dev.
- Quick start
- Configuration
- Themes
- Lua widgets
- Widget packages
- Runtime and troubleshooting
- Development
Licensed under the Apache License 2.0.