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 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.
| 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. |
You need macOS 15 or later on Apple silicon. It was built and tested on macOS 26 with an M4 MacBook Pro.
- Download
DeskBar-1.1.2-macOS-AppleSilicon.zipfrom the latest release and unzip it. - Drag DeskBar.app into Applications.
- 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.
DeskBar is a Swift package with no dependencies.
git clone https://github.com/Osman246/DeskBar.git
cd DeskBar
./build.sh
open DeskBar.appbuild.sh builds a release binary, wraps it in DeskBar.app and signs it ad hoc so it runs on your
own 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.
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.
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.
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.
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.




