Skip to content
schnabstarPublic

About

Glances 5 in your macOS menu bar – native menu bar app and dashboard for Glances servers

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

1 watching

Forks

MetriBar

CI

Glances 5 in your Mac menu bar, on iPhone and iPad.

MetriBar is a native macOS menu bar app and includes a dedicated iPhone and iPad app target for servers running Glances 5. See the status of your Raspberry Pi, NAS or Docker host at a glance, and open a native dashboard for the details.

No agent to install, no cloud, no account, no telemetry. An optional update check is off until you turn it on.

MetriBar dashboard showing CPU, memory, swap and load, trends, network, sensors and storage of a demo server

Status: MetriBar uses the Glances 5 REST API (/api/5), which is currently in beta. Glances 4 is not supported. Expect changes until Glances 5.0 and MetriBar 1.0 are released.

Features

  • Menu bar: one icon for the combined status of all servers; its shape changes on warnings, critical values or when a server is offline. Optionally shows up to three values of a server next to it (CPU, memory, swap, load, highest temperature, fullest disk, network download or upload, containers with problems), with symbols, words or numbers only, optionally with a trend line, and optionally only while something is wrong.
  • Popover: CPU, memory, load, uptime and containers of the selected server, with a server switcher. When a server cannot be read, MetriBar explains why and offers the fix.
  • Dashboard window with the sections of every server in the sidebar (⌘1–⌘8):
    • Overview with usage rings, trend, network, sensors (temperatures, fans), storage, containers, system information and active alerts
    • History charts from the history Glances keeps
    • File systems and disk I/O
    • Network interfaces
    • Sensors and GPU
    • Processes with search, sorting and an inspector; command lines only on request
    • Containers with CPU and memory limits, network, I/O, uptime and ports
    • Glances alerts and incidents
  • iPhone and iPad app (iOS 26): iPhone tabs with compact process, storage, container and alert views; iPad split view with sortable tables, keyboard shortcuts and trailing inspectors.
  • Your own thresholds: rules such as "CPU above 90 % for 5 minutes" or "a disk above 85 %" for one server or all, for CPU, memory, swap, load, disks, temperatures and network throughput, with a hold time and a hysteresis. A rule that fires changes the status icon like a warning from Glances and is reported by notifications. Rules only change what MetriBar shows; nothing changes on your servers.
  • Notifications (off by default): a macOS or iOS notification when a value reaches warning or critical, a container becomes unhealthy, or a server cannot be reached, with a hold time against short spikes, quiet hours and a switch per server. They are created on your device; nothing is sent anywhere.
  • Widgets and a control (iOS 26 and macOS 26): Home Screen widgets for one server or all servers, Lock Screen widgets for a server, and a control for Control Center. On Mac the control is also available in the menu bar. Add them from the widget gallery; MetriBar has to be running to keep them current.
  • Multiple servers, each polled independently. Only the data that is visible is fetched.
  • Secure by default: passwords in the Keychain, TLS validation with optional pinning of self-signed certificates, warnings for passwords over plain HTTP, strictly read-only access.
  • Helpful diagnostics: a step-by-step connection test, detection of a missing local network permission, and copyable diagnostic details without secrets.
  • English and German.

Processes of a demo server, sorted by CPU

The screenshots show the built-in demo data, not a real server.

Requirements

  • macOS 26 or later, on Apple silicon or Intel (the app is universal)
  • iOS 26 or later for the iPhone and iPad app
  • A server running Glances 5 as a web server (glances -s). See Setting up Glances 5.

Installation

  1. Download the disk image (MetriBar-<version>.dmg) from the latest release.
  2. Open the disk image and drag MetriBar to your Applications folder.

The app is signed with a Developer ID and notarized by Apple. Each release also lists a SHA-256 checksum (MetriBar-<version>.sha256) if you want to verify the download.

To try MetriBar without a server, choose Try with Demo Data after the first launch.

Updating

MetriBar does not install updates by itself. To update, download the new version from the releases page and replace the app in your Applications folder. Your servers and settings are kept; passwords stay in the Keychain.

To be told about new versions, turn on Check for updates automatically in Settings › General. MetriBar then asks GitHub once a day whether a newer release exists (GitHub sees your IP address, nothing else is sent) and points it out in the menu bar window. The setting is off by default, and Check for Updates… in the app menu checks once on request. You can also watch the repository (Watch › Custom › Releases).

You can also build MetriBar from source.

Documentation

  • Setting up Glances 5: Docker and pipx, password, HTTPS, allowed host names
  • Security: what MetriBar protects and what the server operator should do
  • Troubleshooting: connection problems and their fixes
  • Decisions: technical decisions and findings during development

Building from source

Requirements: Xcode 27 or later, XcodeGen 2.44 or later, and macOS 26 or later.

git clone https://github.com/schnabstar/MetriBar.git
cd MetriBar
xcodegen generate                  # project.yml is the source of truth
swift test --package-path Packages/MetriBarKit   # core library tests
open MetriBar.xcodeproj

Build the macOS app with the MetriBar scheme or the iPhone/iPad app with MetriBar-iOS. The iOS scheme also builds and embeds its WidgetKit extension. Both app targets need a valid signing identity and the App Group configured in Config/Shared.xcconfig for widgets and shared credentials to work.

The project signs with the maintainer's team by default. To build and run it yourself, copy Config/Local.xcconfig.example to Config/Local.xcconfig (ignored by git) and enter your own team ID and bundle identifier.

The widgets read MetriBar's data from an App Group, which is part of the signing as well. Builds without a provisioning profile can use the widget entitlements without the App Group (see the example file); the widgets then ask you to open MetriBar.

MetriBar stores passwords in the data protection keychain, which requires a provisioning profile. If your account cannot create one (for example a free Apple ID), the example file shows how to switch your local builds to the file-based keychain.

More in CONTRIBUTING.md.

Privacy

MetriBar talks to the Glances servers you add and, only if you turn it on, to GitHub for the update check. It collects no data and has no telemetry. See PRIVACY.md.

Contributing

Bug reports, ideas, translations and pull requests are welcome. Please read CONTRIBUTING.md and the Code of Conduct. Report security issues privately as described in SECURITY.md.

License

MetriBar is licensed under the Apache License 2.0.

MetriBar is an independent project and is not affiliated with or endorsed by the Glances project. See NOTICE.

About

Glances 5 in your macOS menu bar – native menu bar app and dashboard for Glances servers

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages