Skip to content
Osman246Public

About

Is your Mac OK? One click answers in one sentence. A free macOS menu bar app for Apple silicon.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

The DeskBar icon: a MacBook whose screen shows a green check

DeskBar

CI

Is your Mac OK? One click answers in one sentence. The panel says All good, or names the one thing that isn't, with the fix next to it. Under that: heat, memory, disk and battery, a short report on your day, and a living 3D model of your MacBook. The lid follows your real lid, a MagSafe cable appears when you plug in, and your monitors appear when you connect them.

The DeskBar panel in dark mode   The DeskBar panel in light mode

Why

The Mac hides its vital signs in four places: Activity Monitor, System Settings, Control Centre and the battery menu. Most menu bar monitors fix that by adding more numbers. DeskBar takes the opposite approach:

  • One glance answers "is everything OK?" The top card says All good, or names the one thing that isn't: Running hot, Memory full, Disk almost full, Offline.
  • A quiet menu bar. A small MacBook when all's clear. Only when something needs you does it show a warning and what it is.
  • Detail only when you ask. Every tile opens in place: per-core CPU, memory pressure, the apps using it, battery health.
  • Things you'd otherwise dig for, one click away. Focus, Keep awake, Hide desktop, Mute mic, Display off, Screenshot, Clean up Downloads, Lock.

What's in the panel

Verdict All good, or the one problem in plain English (Memory full. Safari is using 6 GB.) with the action next to it, such as Quit.
Today A short daily report from the local history: the busiest and hottest apps, data downloaded, and how today compares with your usual day.
Living Mac A thumbnail beside the verdict; click it for the full-size 3D MacBook that mirrors the real one: lid angle, charging, MagSafe, AirPods, camera and microphone in use. Zooms into the ports to show what's plugged into each, and switches to a desk view with your external monitors.
CPU Efficiency and performance cores, GPU, temperature, fan, uptime, and a short history.
Memory · Disk · Battery Memory pressure, free space and Downloads cleanup, power draw, charger wattage, battery health and cycles.
Wi-Fi & network Link speed, latency, live throughput, public IP, VPN.
Sound & display Output device and volume. External monitor brightness over DDC, and Night Shift.
Speed test Runs macOS's own networkQuality and keeps your last ten results.
Devices Bluetooth battery levels, and what's using the camera or microphone.
Smart alerts Notifies you when memory is full, the Mac starts throttling, the battery or disk runs low, or your headphones or mouse need charging.
Window Open DeskBar (⌘O) opens a full window with history charts for CPU, memory, storage, battery, displays and network.

CPU detail Ports on the left side Network section

Install

You need macOS 15 or later on Apple silicon. It was built and tested on macOS 26 with an M4 MacBook Pro.

Download

  1. Download DeskBar-1.1.2-macOS-AppleSilicon.zip from the latest release and unzip it.
  2. Drag DeskBar.app into Applications.
  3. Open it. DeskBar isn't notarised by Apple yet, so the first time macOS will say it can't check it. Click Done, then go to System Settings → Privacy & Security and click Open Anyway next to DeskBar. You only need to do this once.

Every release zip is built by GitHub Actions from the tagged commit, not on someone's laptop. To check yours came from this repository, run gh attestation verify DeskBar-*.zip --repo Osman246/DeskBar.

DeskBar appears in your menu bar. It has no Dock icon until you open its window.

Build it yourself

DeskBar is a Swift package with no dependencies.

git clone https://github.com/Osman246/DeskBar.git
cd DeskBar
./build.sh
open DeskBar.app

build.sh builds a release binary, wraps it in DeskBar.app and signs it ad hoc so it runs on your own Mac.

The 3D Mac

The 3D MacBook Pro is Apple's own model, the one behind View in AR on apple.com. It isn't this project's to redistribute, so it isn't in this repository. On first launch the panel shows a flat MacBook. Click it, then Show in 3D, which downloads the model (10 MB) from apple.com into ~/Library/Application Support/DeskBar/. If you'd rather bundle it in your own build, put the file in Models/macbook-pro-14-space-black.usdz before running build.sh.

Privacy

Everything DeskBar shows is read on your Mac and stays on your Mac. There's no account, no analytics and no tracking. It only goes online for these:

What Where When
Latency a TCP connection to 1.1.1.1 (port 443) every 10 s
Public IP api.ipify.org every 10 minutes, or when you change network
Speed test Apple's networkQuality servers only when you run one
3D model apple.com only when you click Show in 3D

macOS will ask for permissions as you use features:

  • Location: only so macOS will reveal your Wi-Fi network's name.
  • Bluetooth: for device battery levels.
  • Notifications: for smart alerts.

Performance

A menu bar app should be invisible until you look at it. Rendering stops whenever the panel and window are closed. Idle CPU sits around 0–1.5%, and the 3D view renders only while it's on screen.

Every change is checked against a long-running build. That's how a slow leak in macOS's segmented control was found and designed out: it had pushed CPU to 50–100% after three days. Launch is quick too: the 3D Mac's graphics are prepared in the background, so the first frame draws in about 30 ms. The full story is in docs/PRODUCT.md.

Development

swift build                                              # debug build
swift test                                               # the verdict's rules (needs Xcode, not just the Command Line Tools)
./DeskBar.app/Contents/MacOS/DeskBar --snapshot out/     # renders the panel to PNGs, light and dark
DESKBAR_DEMO=1 ./DeskBar.app/Contents/MacOS/DeskBar --snapshot docs/images   # shareable screenshots
DESKBAR_DEMO=1 ./DeskBar.app/Contents/MacOS/DeskBar --snapshot out/ --demo-video --fonts <dir> [--credit "Built by …"] [--credit-note "…"]   # the demo video (--v6 for the 1.1 film, with --images and --before screenshot folders); <dir> holds EB Garamond (OFL)

The demo film's code is in Sources/DeskBar/DemoFilm, apart from the app itself. --snapshot modes render the real views offscreen. That's how every screenshot here was made, and how visual changes are checked without clicking through the app. DESKBAR_DEMO=1 swaps in a placeholder IP address and a generic Mac name.

Every push and pull request is built and tested by CI. Releases are built by the release workflow when a version tag is pushed.

What changed in each version is in CHANGELOG.md. To report a security problem, see SECURITY.md.

See CONTRIBUTING.md and the product thinking behind it in docs/PRODUCT.md.

Licence

MIT. See LICENSE. Apple, MacBook Pro, MagSafe and AirPods are trademarks of Apple Inc. DeskBar is an independent project and isn't affiliated with Apple.

About

Is your Mac OK? One click answers in one sentence. A free macOS menu bar app for Apple silicon.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages