ServerBar

A lightweight macOS menu bar app for monitoring server data usage at a glance.

Features

• Menu bar native — lives in your menu bar, no Dock icon
• Multiple servers — monitor as many servers as you need
• Visual progress bars — see usage and remaining quota instantly
• Auto-refresh — fetches usage data from your server's API automatically
• Custom API mapping — configure JSON key paths to match any API response
• Reset cycle tracking — shows days until your data resets
• Launch at login — start automatically when you log in
• Zero dependencies — pure Swift + AppKit, built with Swift Package Manager

Requirements

• macOS 14 (Sonoma) or later

Install

Homebrew

brew install --cask magic3584/tap/serverbar

Build from source

git clone https://github.com/magic3584/ServerBar.git
cd ServerBar
make build      # Release build → .build/ServerBar.app
make install    # Copy to /Applications

Run directly

make run        # Build and launch

Usage

1. Click the menu bar icon to see server usage
2. Open Settings (⌘,) to configure your servers
3. Add a server by providing:
   • Name — display label
   • Request URL — API endpoint that returns JSON
   • JSON keys — keys for data used, monthly total, and reset day

ServerBar will periodically fetch the API and display usage as progress bars in the dropdown menu.

License

MIT