SwiftBar transforms the Mac menu bar into a customizable dashboard through shell scripts and plugins. This MIT-licensed open-source project enables users to display any scriptable information directly in the menu bar without proprietary solutions or subscription fees.
The app operates on a straightforward principle: write a script in any programming language, drop it into the plugin folder, and the output appears in the menu bar. SwiftBar supports shell scripts, Python, Node.js, Ruby, and compiled binaries. The plugin API provides rich formatting options including colors, fonts, images, and dropdown menus, enabling sophisticated interfaces that rival purpose-built applications.
A notable feature is the extensive plugin ecosystem. The community maintains hundreds of plugins covering cryptocurrency prices, weather updates, GitHub notifications, Docker container status, and system monitoring. BitBar compatibility ensures years of community-developed plugins work seamlessly with SwiftBar.
Key capabilities include:
- Standard plugins that run continuously with configurable refresh intervals (from every second to once daily)
- Ephemeral plugins that execute only when clicked
- Environment variables for plugin refresh reasons
- Support for Ghostty terminal and detachable web view popovers
System requirements are minimal: macOS Catalina (10.15) or newer. Resource usage remains negligible, typically under 50MB memory and virtually no CPU when idle. Installation options include GitHub releases, Homebrew (brew install swiftbar), or building from source with Xcode.
Limitations include a plugin management interface that requires command-line familiarity, and no built-in script editor. Debugging failed scripts requires technical comfort with terminal workflows.
Alternatives include xbar (formerly BitBar) for similar script-based customization, or Stats for system monitoring without scripting requirements.
Suitable for users who want custom menu bar functionality through scripting, particularly developers and system administrators who work with shell scripts and value open-source solutions without vendor lock-in.
