Field Notes
fieldnotes.co
684 ↑ 12.4%
1,842 views 38% bounce 2m 41s avg
Native macOS menu bar app
Umami, without
the tab.
UmamiBar is a native menu bar client for your analytics. Visitors, trends, and site details for everything you track — one click away, never another browser tab.
Free and open source. No account, no telemetry, no cloud relay.
Websites
3Atlas Studio
atlas.studio
412 ↑ 4.1%
1,106 views 44% bounce 1m 58s avg
Kernel Weekly
kernel.weekly
188 New
512 views 51% bounce 1m 22s avg
Field Notes
fieldnotes.co
4,126 ↑ 8.2%
11.6K views 41% bounce 2m 37s avg
Atlas Studio
atlas.studio
2,483 ↓ 3.6%
6,930 views 46% bounce 1m 51s avg
Kernel Weekly
kernel.weekly
1,303 ↑ 21.9%
3,180 views 49% bounce 1m 27s avg
Field Notes
fieldnotes.co
16,942 ↑ 6.8%
48.2K views 43% bounce 2m 34s avg
Atlas Studio
atlas.studio
9,781 ↑ 1.2%
27.4K views 47% bounce 1m 49s avg
Kernel Weekly
kernel.weekly
4,685 New
12.9K views 52% bounce 1m 19s avg
Auto-refresh · 60s
Pure AppKit No WebKit, no local server
Universal Intel + Apple Silicon
Keychain Keys stay out of plain files
60-second refresh Only while the popover is open
MIT licensed Auditable end to end
What it does
A small surface.
Everything you need.
UmamiBar is not a shrunken dashboard. It is a focused menu bar client for the numbers you check between real work.
Every site, one list
Visitors, period-over-period change, a session chart, and traffic quality for each site — together in one popover.
Three ranges, one click
Last 24 hours, 7 days, or a calendar month. Every total is compared against the immediately preceding window.
Go deeper, stay in place
Open any site for a larger chart, top pages, and referrers. The back button restores your exact scroll position.
Native, not wrapped
Pure AppKit drawing and URLSession. No embedded browser, no local web server, and no Electron runtime.
Keychain by default
API keys live in macOS Keychain. Remote endpoints require HTTPS, and redirects never forward credentials.
Quiet in the background
Refreshes every 60 seconds only while open. Follows system appearance, keyboard access, and reduced motion.
Under the hood
Native, all the way down.
The charts are drawn by AppKit. Requests go straight from your Mac to the Umami endpoint you configure. There is no WebView, no bundled web server, and no analytics middleman — just the app, URLSession, and your instance.
Website requests run sequentially, so a large selection may take a little longer while staying polite to your server.
Sparkle 2 is the only third-party dependency.
Menu bar item Fixed width, tabular digits, exact count in tooltip
AppKit Popover Native glass, keyboard navigation, instant range switches
AppKit Transport Direct requests to your instance — no proxy, no web server
URLSession Credentials Bearer keys stored by macOS, never in plain files
Keychain Updates Signed, notarized releases checked in Settings
Sparkle 2 Screenshots
The actual app.
Not a mockup.
Native glass, warm chart colors, and the same considered layout in both appearances. These are real captures with sample data.
All selected websites in one scrollable list: visitors, comparison, session chart, and traffic quality.
Security
Keys in the Keychain. Nothing else.
UmamiBar talks only to the endpoint you configure. Credentials are handled by macOS rather than a JSON file sitting next to the app.
API key → macOS Keychain
HTTPS, except on localhost
Remote service URLs must use HTTPS. Plain HTTP is allowed only for localhost, 127.0.0.1, and ::1 during development.
Redirects are refused
A redirect could carry a Bearer key to another host, so UmamiBar rejects it instead of following it.
No keys in logs or URLs
API keys never appear in logs, preference files, request URLs, or diagnostics. Keys are stored with macOS Keychain.
No telemetry, no middleman
Traffic data goes from your Umami instance to your Mac. There is no UmamiBar cloud, account, or analytics pipeline.
Install
In your menu bar
in a minute.
Latest v0.1.4 Universal build · macOS
Homebrew
Recommended
$ brew tap helson-lin/umamibar https://github.com/helson-lin/umamibar
$ brew install --cask helson-lin/umamibar/umamibar
Tracks signed, notarized releases. Upgrade with
brew upgrade --cask.
Direct download
DMG
Universal build for Intel and Apple Silicon. Signed and notarized; open the disk image and drag UmamiBar to Applications.
Download v0.1.4 System
macOS 10.15+ (Intel) · 11+ (Apple Silicon)
Architecture
One universal binary for both Mac families
Updates
Sparkle 2 · checked in Settings → General
- 01 Connect
Enter your Umami API URL and key, then verify the connection.
- 02 Choose sites
Pick which websites should appear in the popover. Search and bulk select are included.
- 03 Save and glance
The menu bar count appears immediately. Use the gear any time to change the setup.
v0.1.4 is an early release. Review the current limits before relying on it. Requires an Umami deployment that supports API-key authentication.
Questions
The honest details.
What works today, what does not, and where your data actually goes. The README is the source of truth for current limits.
Read the READMEDoes it work with Umami Cloud and self-hosted instances?
Yes, as long as the deployment supports Bearer API keys. Umami Cloud uses https://api.umami.is/v1. For a root-deployed self-hosted instance, enter its base URL and the app adds /api; subpath deployments keep the path you supply. Older servers that only support password login are not compatible.
Is UmamiBar an official Umami app?
No. It is an independent, MIT-licensed client built by JarinHe. It is not affiliated with or endorsed by the Umami project.
How current is the data in the menu bar?
The popover refreshes every 60 seconds while it is open and pauses polling when closed. The menu bar number is the sum of visitors across selected websites for the active range — not a live online-user count, and not deduplicated across sites. Large numbers use compact suffixes; the exact count is in the tooltip.
Is the API key really only in the Keychain?
Yes. Requests carry the key from macOS Keychain, and it is never written to logs, preference files, or URLs. Remote endpoints must be HTTPS; redirects are refused. Removing the app's preferences does not delete the Keychain item — clear the connection in Settings first if you want it gone.
Can I connect more than one Umami instance?
Not yet. UmamiBar supports one instance at a time, with any number of websites from that instance. Cross-instance aggregation is not implemented.
Does it run on Intel Macs?
Yes. Releases are universal binaries with an Intel deployment target of macOS 10.15 Catalina and Apple Silicon support from macOS 11. Catalina hardware validation is still listed as a current limit in the project README.
How do updates work?
Tagged releases are Developer ID signed and notarized. UmamiBar checks for updates with Sparkle 2, and you can trigger a manual check under Settings → General. Ad-hoc CI artifacts are not eligible for in-app updates.
What languages does the interface support?
English and Simplified Chinese. Choose System, 简体中文, or English under Settings → General → Language; the change applies immediately, and System follows your macOS language.
UmamiBar · v0.1.4
Stop opening a dashboard for one number.
Put Umami in your menu bar. Native, private, and out of the way until the number matters.
macOS 10.15+ · Universal · MIT licensed. No account required.