Control StableBar from Shortcuts, Spotlight and stablebar:// links
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 5/5
- Estimated time
- Over a week
- Newbie friendliness
- 35/100
- Issue type
- Feature
- Clarity
- Mostly clear
- Activity status
- Active
- Tech stack
- macos, swift
- Domain
- desktop, developer-experience
Research direction
Start with the command-line controls in docs/command-line.md and trace how they become RuntimeRequest actions; inspect Resources/Info.plist and the app entry points under Sources for URL event handling. The issue calls for App Intents and stablebar:// links covering the same runtime actions, plus a decision on whether URL-triggered scripts need a setting. Done means both entry paths invoke the existing actions and the trigger safety behavior is defined.
Written by the indexing model from the issue text.
Description
Problem
Every runtime action goes through the command line: --popup, --profile, --refresh and --trigger (see Command-line controls). Shortcuts can only reach them through Run Shell Script with the full path to the binary, and launchers such as Raycast and Alfred need a script command for each action. Links in notes or web pages can't reach the bar at all.
macOS 26 brought Shortcuts automations (Focus, time of day, Wi-Fi) to the Mac and runs App Intents from Spotlight. A shortcut can also have a keyboard shortcut, so App Intents would give global hotkeys without StableBar needing a hotkey editor.
Proposal
- App Intents for the existing actions: open or close a widget's popup, switch the profile or return it to automatic, refresh a widget, and send an event with data. Widget and profile parameters list the IDs and names in the current configuration. An
AppShortcutsProvidermakes the common ones appear in Spotlight and Shortcuts without setup. - A
stablebar://URL scheme for the same actions, such asstablebar://popup/meeting,stablebar://profile/focus,stablebar://refresh/weatherandstablebar://trigger/deploy?STATUS=done. It needsCFBundleURLTypesinInfo.plistand a handler for the open-URL Apple Event. - Both go through the same
RuntimeRequestactions as the command line, so they behave the same and the CLI stays the reference. - Configuration edits (
--set,--add,--batch) stay on the command line. - Open question: a link can come from any web page or document, so decide whether
triggerover a URL, which can run widget scripts with the data it carries, should be allowed or need a setting.
Both use public APIs only: App Intents (macOS 13+) and URL types in Info.plist. Resources/Info.plist on main declares no URL types, and Sources has no App Intents.
Possible today
Partly. A Run Shell Script action, or a Raycast or Alfred script command, can call /Applications/StableBar.app/Contents/MacOS/StableBar --popup <id> and the other flags. That needs a shell for each action, shows up in Spotlight only through a user-made shortcut, and can't be a link.
Related
- #72 added
--popup; its example binds it in AeroSpace, skhd or Raycast through the binary. - #81 lets commands set conditions that profiles match; App Intents would let Shortcuts automations set them without a shell.
- #70 hides and shows the bar; when it lands, it fits the same intents and URLs.
- Demand elsewhere: Ice #501, Raycast integration (open, 28 reactions).
Triaged by Claude Code via T3 Code (Claude Opus 5.5).
- Dominant language
- Swift
- Stars
- 184
- Forks
- 12
- Avg merge
- 3h 50m
- Merged PRs (30d)
- 387
Getting set up
- No Dockerfile or Docker Compose file
- Has a pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from Seb-GRAF/StableBar
-
enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
Maintainers usually reply within 1 day
-
enhancement
Difficulty 4/5 3-5 days Newbie friendliness 52/100
Maintainers usually reply within 1 day
-
Menu bar items drawn as in the menu bar show the wrong part of the menu bar after a display changePossibly taken @Jonathanm10 claimed this today. Openneeds-triage
Difficulty 2/5 1-3 hours Newbie friendliness 35/100
Maintainers usually reply within 1 day
-
enhancement
Difficulty 5/5 Over a week Newbie friendliness 30/100
Maintainers usually reply within 1 day
-
Allow the App Menu to display the frontmost app iconPossibly taken @khatami10 claimed this today. Openenhancement needs-triage
Difficulty 3/5 1-2 days Newbie friendliness 35/100
Maintainers usually reply within 1 day
All issues in Seb-GRAF/StableBar
Similar issues
-
good first issue help wanted testing
Difficulty 1/5 Under an hour Newbie friendliness 78/100
-
area:cli documentation good first issue priority:low
Difficulty 1/5 Under an hour Newbie friendliness 94/100
isaaclins/freesnitch#430 ·
Maintainers usually reply within 1 day
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
MasterJ93/ATProtoKit#354 ·
-
enhancement help wanted
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
heysidhant/appvanish#4 ·
-
bug priority:low status:queued
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
Maintainers usually reply within 1 day