EasyBar is a lightweight, scriptable macOS status bar built with SwiftUI and Lua.
It combines native built-in widgets with custom Lua widgets and is designed for an AeroSpace-based macOS workflow.
- Native macOS bar window built with SwiftUI
- Built-in widgets plus scriptable Lua widgets
- AeroSpace integration for spaces, focused app state, and layout mode state
- Event-driven updates and interactive popups
- Calendar and network helper agents
- Homebrew install and service workflow
- Config-driven logging and troubleshooting support
- Lightweight runtime metrics
brew tap gi8lino/tap
brew install gi8lino/tap/easybarStart EasyBar and its helper agents:
brew services start gi8lino/tap/easybar-calendar-agent
brew services start gi8lino/tap/easybar-network-agent
brew services start gi8lino/tap/easybarFull documentation is available here: https://gi8lino.github.io/easybar/
Start with:
- Installation
- Configuration
- AeroSpace Integration
- Lua Widgets
- Troubleshooting
- Architecture
EasyBar reads its runtime config from:
~/.config/easybar/config.toml
You can override it with:
EASYBAR_CONFIG_PATH=/path/to/config.tomlThe repository includes:
This project is licensed under the Apache 2.0 License. See LICENSE for details.