Simple CLI tool for macOS to flash a colored border around the screen .

• Homepage
• Author: Sven Schwyn - Bitcetera

Thank you for supporting free and open-source software by sponsoring on GitHub or on Donorbox. Any gesture is appreciated, from a single Euro for a ☕️ cup of coffee to 🍹 early retirement.

On macOS, download the latest source file and compile it:

wget https://raw.githubusercontent.com/svoop/border-flash/refs/heads/main/border-flash.swift
swiftc border-flash.swift -o border-flash -framework Cocoa

To make it availble system-wide, simply move the compiled binary into the PATH:

sudo mv border-flash /usr/local/bin/

Execute it without arguments to learn all about the little it can do:

border-flash

Its original raison d'être is to provide a simple visual queue to signal whether the test suite of a software project runs successfully or not. Along with minitest-flash, a flashing green border indicates all tests to pass while a flashing red border indicates trouble in the code like so:

border-flash 255 0 0 8 2

I'm not usually developing in Swift, so the initial implementation of this little tool is the result of a few minutes of vibe coding and superficial code review.

You're welcome to submit issues and contribute code by forking the project and submitting pull requests.

The gem is available as open source under the terms of the MIT License.