https://github.com/mgxv/swiftbar-plugins
A collection of SwiftBar plugins for macOS - keeping your menu bar useful, minimal, and up-to-date.
https://github.com/mgxv/swiftbar-plugins
bash launchd macos macos-utilities menu-bar plugins shell-script swiftbar swiftbar-plugins wifi
Last synced: about 2 months ago
JSON representation
A collection of SwiftBar plugins for macOS - keeping your menu bar useful, minimal, and up-to-date.
- Host: GitHub
- URL: https://github.com/mgxv/swiftbar-plugins
- Owner: mgxv
- Created: 2026-03-23T19:51:12.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-03-23T20:38:33.000Z (3 months ago)
- Last Synced: 2026-03-24T18:40:43.108Z (3 months ago)
- Topics: bash, launchd, macos, macos-utilities, menu-bar, plugins, shell-script, swiftbar, swiftbar-plugins, wifi
- Language: Shell
- Homepage:
- Size: 88.9 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🍎 swiftbar-plugins
> A collection of [SwiftBar](https://github.com/swiftbar/SwiftBar) plugins for macOS — keeping your menu bar useful, minimal, and up-to-date.
---
## ⚡️ Prerequisites
### Install SwiftBar
```bash
brew install --cask swiftbar
```
> Don't have Homebrew? Install it first:
> ```bash
> /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
> ```
### Create your plugins folder
```bash
mkdir ~/swiftbar-plugins
```
### Point SwiftBar to your folder
1. Launch **SwiftBar**
2. When prompted, select your `~/swiftbar-plugins` folder
3. Or update it later via **SwiftBar → Preferences → Plugin Folder**
---
## 🔌 Plugins
| Plugin | Description |
|---|---|
| [📶 wifi-ssid](./wifi-ssid/) | Displays your current WiFi network in the menu bar, updates instantly on network changes |
---
## 📦 Installing a plugin
Each plugin has its own folder with a dedicated README. The general steps are:
```bash
# 1. Clone this repo
git clone https://github.com/matthew/swiftbar-plugins.git
# 2. Navigate to the plugin you want
cd swiftbar-plugins/wifi-ssid
# 3. Follow the README instructions in that folder
```
---
## 🗂 Repo structure
```
swiftbar-plugins/
├── README.md ← you are here
└── wifi-ssid/
├── README.md ← plugin-specific setup instructions
├── wifi-ssid.sh ← SwiftBar plugin script
├── wifi-watcher.sh ← launchd watcher script
├── com.user.wifiwatcher.plist
└── assets/
├── setup.jpg ← screenshot: Shortcut setup
└── execution.jpg ← screenshot: Shortcut execution
```