TerminalWidget for Mac, iPhone, and iPad | TerminalWidget
Put Terminal Output on Your Desktop
TerminalWidget is a Mac, iPhone, and iPad app that shows text, progress bars, charts, and images in widgets, used by developers and power users to monitor scripts and automations at a glance.
Send output from the CLI, Shortcuts, AppleScript, or a URL scheme. Available as a universal App Store app for $19.99 .
Newsletter
Get updates and TerminalWidget recipes—shell scripts, shortcuts, and other tips for building dashboards.
Name
Marketing permission : I give my consent to BrettTerpstra.com to be in touch with me via email using the information I have provided in this form for the purpose of news, updates and marketing.
What to expect<br>If you wish to withdraw your consent and stop hearing from us, simply click the unsubscribe link at the bottom of every email we send or contact us at me@brettterpstra.com. We value and respect your personal data and privacy. To view our privacy policy, please visit our website. By submitting this form, you agree that we may process your information in accordance with these terms.
HP
Features
Output text from terminal commands or generate a wide variety of charts and tables from data
Multiple widgets can be targeted individually
Sync across multiple Macs and iOS devices
Display local or remote images, including those generated by APIs
Display images edge-to-edge
Full control over colors, fonts, and icon
Instant updates on macOS, rapid updates on iOS via iCloud
Full CLI included, incorporate into scripts
Shortcuts actions work on Mac and iOS, with AppleScript support and a URL scheme for automation
Display progress bars with any number 0-100
Display charts and graphs by passing serial integer data
Display matrix-style chart of integer values
macOS Widgets
Output any text, image, or chart data to fully customizable widgets
Use shell scripts or AppleScript output on macOS
Interact via Shortcuts or URL scheme on macOS and iOS
Assign actions to widgets to execute on tap/click
Text basic
Progress matrix
Radial chart
See the gallery
Mac + iPhone + iPad
Widgets sync across your Apple devices when iCloud is enabled.
iOS and iPadOS widgets support the same rich text, progress bar, and sparkline payloads.
Use the URL scheme or Shortcuts actions to update widgets from iPhone and iPad.
Existing CLI scripts continue to work the same for Mac workflows.
iOS progress trio
iOS chart styles
iOS image showcase
See the gallery
CLI Example
terminal-widget --target widget1 --text "Build complete" --icon "checkmark.seal.fill" --progress 100 --fg "#22c55e"
Read full CLI documentation
How it compares
TerminalWidget is a Mac, iPhone, and iPad app that shows text, progress bars, charts, and images in widgets, used by developers and power users to monitor scripts and automations at a glance.<br>You drive it from tools you already use — not a hosted monitoring product and not another static widget pack.
TerminalWidget<br>Typical alternatives
Footprint<br>Native Mac App Store app with WidgetKit widgets and a small CLI — no Electron shell or always-on web server.<br>Custom Electron/web dashboards or a self-hosted monitoring stack.
How you update<br>CLI, Shortcuts, AppleScript, or URL scheme targeting named widgets.<br>Agents, scrapers, or hand-built UI refresh loops.
Mac + iPhone + iPad<br>Same widget targets sync over iCloud when enabled.<br>Separate tools per platform, or your own sync relay.
What you can show<br>Text, progress, charts/sparklines, tables, and local or remote images.<br>Whatever you build into a custom dashboard — usually more setup.
Pricing<br>$19.99 one-time universal App Store purchase.<br>SaaS seats, infrastructure cost, or ongoing DIY maintenance.
FAQ
How do I update a widget from a script or remote job?<br>First add a TerminalWidget widget to the Desktop or Home Screen and set Edit Widget → Target name. Then use the included terminal-widget CLI with flags like --target, --text, --progress, --chart, --icon, and --fg, or push the same fields via Shortcuts, AppleScript, or the URL scheme. On Mac, updates apply immediately. On iPhone and iPad, content syncs through iCloud after TerminalWidget has been opened once and notification permission has been allowed (the prompt on first open) so background pulls can wake the app. Full setup: https://terminalwidget.app/integrations#getting-started
Why doesn’t my CLI or Shortcut update show on the widget?<br>TerminalWidget never auto-places widgets. You must add one yourself, then set its Target name to match --target, the Shortcuts Target field, or URL target=. Names are case-sensitive. Step-by-step guide: https://terminalwidget.app/integrations#getting-started
Can tapping a widget run an action?<br>Yes. You can assign a tap/click action per widget target — open a URL, open a Mac app, run a Shortcut, run a shell command (macOS), or refresh from a URL. Actions sync with the widget payload over iCloud. On iOS, URL and Shortcut actions are...