A lightweight macOS menu bar monitor for Komari VPS nodes. It shows node health, CPU, memory, disk, network traffic, latency, loss, uptime, and expiry metadata from the menu bar.
This app is a macOS menu bar client for Komari, a lightweight self-hosted server monitoring tool. You need a running Komari server and API/session credentials for this app to display data.
- Native macOS menu bar app built with SwiftUI and AppKit.
- Compact per-node status strip in the menu bar.
- Popover dashboard with resource usage, traffic, latency, packet loss, uptime, and expiry.
- WebSocket realtime updates with polling fallback.
- Optional launch-at-login control from the popover.
- macOS 14 or later.
- Swift 6 toolchain / recent Xcode command line tools.
- A Komari instance with RPC/API access.
The app reads its private config from:
~/.config/komari-swiftbar/config.json
On first launch, the app opens a settings window where you can enter your Komari URL and credentials. You can also reopen it from the popover with Settings.
If you prefer editing the config file manually, create the directory and copy the example:
mkdir -p ~/.config/komari-swiftbar cp config.example.json ~/.config/komari-swiftbar/config.json
Then edit the copied file with your own Komari URL and credentials.
Do not commit your real config.json. It may contain API keys, cookies, or session tokens.
Build the command line executable:
swift build -c release
Build and install the menu bar app to ~/Applications/VPSMonitor.app:
./scripts/build-app.sh
Run the installed app:
open ~/Applications/VPSMonitor.appThis repository intentionally ignores local configuration, build output, app bundles, archives, logs, and common private key files.
Thanks to Komari for providing the lightweight self-hosted server monitoring platform and API that this menu bar client builds on.
The popover card UI is inspired by komari-theme-Lumina. Thanks to the Lumina theme author for the visual direction.
MIT