Open source from Blinken Labs

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.

Open source · v1.0.2 · MIT

BlinkenLights

Drive activity lights for every mounted volume on your Mac.

Open source · Free · MIT License

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 icon The app · macOS 15+ · Apple silicon and Intel

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.

SHA-256: 7ce8bcf0dea9e30b8f75b0311a005c39940816977f4161e63d4d2b28fe01858c
BlinkenLights icon The source · MIT License

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.

Swift · macOS 15+ · No sandbox (needs IOKit and nettop)

How it knows

macOS doesn't offer per-volume activity, so BlinkenLights works it out two ways.

Local volumes

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.

Network shares

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.

Build it yourself

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.