Skip to content

About

macOS menu bar client for Komari server monitoring

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

VPSMonitor

中文说明

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.

Features

  • 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.

Requirements

  • macOS 14 or later.
  • Swift 6 toolchain / recent Xcode command line tools.
  • A Komari instance with RPC/API access.

Configuration

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

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.app

Repository Safety

This repository intentionally ignores local configuration, build output, app bundles, archives, logs, and common private key files.

Acknowledgements

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.

License

MIT

About

macOS menu bar client for Komari server monitoring

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages