Recipes
Scripts and Shortcuts that update Terminal Widget from the command line or automation tools.
-
Script
Planets
A Python script that lists the azimuth, altitude, and constellation for the Moon, Sun, Mercury, Venus, Mars, Jupiter, and Saturn. Example:…
-
Script
Links to flagged lines in a Hogbay Software Bike 2.0 outline
Hogbay Software's Bike 2.0 Outliner (build 294+) lets you flag any row (choosing from 7 flag colors, defaulting to red), via (⇧⌘A) Form…
-
Script
Remote nftables status colorized one-liner v3
This is a one-liner shell script which checks whether nftables (Debian Linux firewall) is active, inactive, or has failed. It's a one-liner…
-
Script
Random image from Flickr account
Show a random photo from your Flickr photostream in a Terminal Widget (--image + --padding fill). Uses the public Flickr REST API with your…
-
Script
OpenAI Image Generator
Generate a fresh image with the OpenAI Image API (GPT Image) and show it in a Terminal Widget via --image. Each run is a paid API call. Pre…
-
Script
Random Unsplash Image
Fetch a random photo from Unsplash (optionally filtered by keyword) and display it in a Terminal Widget with --image. Requirements Terminal…
-
Script
File copy progress
Use pv in numeric mode to stream integer percentages while copying a file, and update a Terminal Widget progress bar in real time. Same ide…
-
Shortcut
GitHub Contributions Square Widget
A square image widget Shortcut for GitHub contributions. Uses Brett's "Contrib" API. Enter your username at the top Select a theme: classic…
-
Shortcut
GitHub Contributions Widget
A Shortcut that uses Brett's "Contrib" API to generate a PNG of your github contributions, then display it as an image widget. Enter your G…
-
Shortcut
Local Temp Widget
A shortcut for getting the current location and temperature from Weather, and displaying a text widget with the response.
-
Script
AppFigures Sales Dashboard
Track Mac App Store downloads and revenue from AppFigures and push them to three Terminal Widget targets: a daily table and two sparkline c…
-
Script
LAN Performance
This recipe runs a quick LAN throughput test with iperf3, updates a TerminalWidget target, and also prints the measured Mbps to STDOUT. It…
-
Script
NA (Next Actions) Widget
Display your next actions for the current directory in a TerminalWidget. Uses NA. This is run as a prompt hook in Fish (though you can modi…
-
Script
Hostname with Figlet
Output your machine hostname using Figlet and display it in a nicely-formatted widget. Run manually or on login. Requires figlet and the Te…
-
Script
GitHub Contributions Graph
The contrib service at https://brettterpstra.com/contrib renders a PNG of a GitHub user's contribution activity. Point --image at the gener…
-
Script
GitHub Contributions Chart (smooth + JSON)
Drive a native --chart from contrib JSON (chart-data=1, json=1) with --caption-left / --caption-right for the visible date range. Requires…
-
Script
API Health Check
Poll a JSON health endpoint and show a green check or red error icon in Terminal Widget based on the response status.
-
Script
Network Speed History Chart (waveform)
Run networkQuality, append results to a CSV history file, and render download/upload waveform charts in Terminal Widget. Add medium widgets…
-
Script
Time Machine Status and Backup Progress
Show current Time Machine state, including percent complete while a backup is running. Run on an interval with a launchd user agent so the…
-
Script
Capture Real Command Progress (rsync)
Parse rsync --info=progress2 output and continuously update a Terminal Widget progress bar while syncing.
-
Script
Configure a Widget Tap Action
Persist tap/click actions on a widget target. Actions survive later display updates until changed or cleared with --clear-action.