SwiftBar
Powerful macOS menu bar customization tool
What is SwiftBar?
Powerful macOS menu bar customization tool
Overview of SwiftBar
What it is
SwiftBar is a macOS menu bar customization tool that allows users to add custom programs and scripts to the menu bar. It is open source under the MIT license and runs on macOS Monterey (12) and later. The tool is designed to be simple: users write a script, add it to SwiftBar, and it appears in the menu bar. SwiftBar can also load plugins from the BitBar repository or its own built-in Plugin Repository, accessible via the menu item “Get Plugins...”.
Key features
- Supports any executable script (shell, Python, etc.) as a plugin; scripts output is parsed into menu bar title and dropdown menu.
- Plugin files follow a naming convention
{name}.{time}.{ext}where{time}is an optional refresh interval (e.g.,1mfor one minute,3hfor three hours). - Rich formatting parameters for menu items: colors (CSS/HEX, light/dark), fonts, sizes, SF Symbols, images (Base64), checkmarks, tooltips, badges, and webview display.
- Actions on click: open a URL (
href), run a bash script (bash), refresh the plugin (refresh), or pass text viastdin. - Supports hotkeys (
shortcutparameter), alternate items for Option key, and markdown in titles. - Environment variable
SWIFTBARis set to1when a plugin runs.
Use cases
- Display system information (date, time, CPU usage, battery status) in the menu bar with custom refresh intervals.
- Create quick-launch menus for applications, scripts, or URLs.
- Build a custom dropdown menu with checkable items, images, and submenus for workflow automation.
- Integrate with external APIs (weather, stock prices, to‑do lists) by writing a script that fetches data and formats output.
- Replace or extend existing menu bar apps with a single script-based tool.
Getting started
Install via Homebrew: brew install swiftbar Alternatively, download from GitHub Releases. After installation, launch SwiftBar and set a “Plugin Folder”. Place executable scripts following the naming convention {name}.{time}.{ext} into that folder. For building from source, see the repository README.
License and pricing
The license is MIT. The software is open source and free.
Based on the project's public README and repository metadata.