Small Mac tools, free to read, build and change.
Some of what we make is too small to sell and too handy to keep to ourselves. These projects are open source under the MIT License: use them, learn from them, or send a fix.
BlinkenLights
Drive activity lights for every mounted volume on your Mac.
BlinkenLights
Drive activity lights for macOS
Where Blinken Labs began.
Old Macs had no lights to tell you the disk was busy, so the first Blinken Labs app drew them on screen. BlinkenLights brings them back: a tiny floating panel with a green light for reads and a red light for writes, for every volume you have mounted.
- Every volume, by its Finder name: the startup disk, external drives and disk images.
- Network shares too: SMB, NFS and AFP shares appear when mounted and go when unmounted.
- Stays out of the way: no Dock icon, no menu bar, on every Space and over full-screen apps.
- Right-click to set it up: vertical or horizontal, always on top, background opacity, update speed (100 ms to 2 s), launch at login.
- Swift
- SwiftUI + AppKit
- IOKit
- XcodeGen
Get BlinkenLights
Download the signed, notarized app, or build it yourself from source. Both are free.
BlinkenLights 1.0.2
Open the disk image and drag BlinkenLights to Applications. Signed with a Developer ID and notarized by Apple, so it opens without warnings. The panel appears at the top right; drag it anywhere.
S-Walabee/BlinkenLights
The whole app in a handful of Swift files, with the project spec it was built from. Read it, fork it, or open an issue.
How it knows
macOS doesn't offer per-volume activity, so BlinkenLights works it out two ways.
Counters from the disk driver
For each volume, BlinkenLights finds the IOBlockStorageDriver underneath it and compares
its read and write counts at every update. macOS counts I/O per drive, not per volume, so APFS volumes
on the same drive blink together.
Bytes on the wire
File sharing runs in the kernel, so BlinkenLights reads the kernel's per-connection byte counts from
nettop and matches them to each share's server. Bytes in light the green light; bytes out
light the red one.
From source in four commands
You need Xcode and XcodeGen.
git clone https://github.com/S-Walabee/BlinkenLights.git && cd BlinkenLights
xcodegen generate
xcodebuild -project BlinkenLights.xcodeproj -scheme BlinkenLights \
-configuration Release -derivedDataPath build/DD build CODE_SIGN_IDENTITY=-
open build/DD/Build/Products/Release/BlinkenLights.app
CODE_SIGN_IDENTITY=- makes an ad-hoc build for your own Mac. To sign with your own team, set
DEVELOPMENT_TEAM in project.yml instead.
Pitch in
Found a bug, or a volume that won't blink? We'd like to hear about it.
Report an issue
Say which macOS version you're on and what kind of volume it is: internal, external, disk image or network share. Open an issue.
Send a pull request
Fixes and small improvements are welcome. Keep it small and focused, like the app. Pull requests.
More on the way
Other small tools will join BlinkenLights here as they're opened up.
Open-source projects are offered as they are, under the MIT License, and aren't covered by Blinken Labs support. Like everything we make, they send Blinken Labs nothing.