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., 1m for one minute, 3h for 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 via stdin.
  • Supports hotkeys (shortcut parameter), alternate items for Option key, and markdown in titles.
  • Environment variable SWIFTBAR is set to 1 when 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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/swiftbarswiftbar.svg)](https://yunodb.com/tools/swiftbarswiftbar?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/swiftbarswiftbar?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/swiftbarswiftbar.svg" alt="Featured on YunoDB" height="20"></a>