Quick Reference
Bunch Syntax
| Bunch Line | Action |
|---|---|
| Apps | |
App Name | Launch app |
%App Name | Launch when opening the Bunch, but ignore when closing |
App Name ~5 | Launch app after 5 second delay |
- XX | close all windows of preceding app |
- File | open a file in preceding app (can be repeated) |
- 'spotlight search' | Run a spotlight search and open the results in preceding app |
- #tag1 #tag2 | Search for macOS tags |
- {@~w} | send a key command to the preceding app |
- [string] | type a string in the preceding app |
!AppName | Quit app |
!!AppName | Launch app when closing bunch (double negative) |
@AppName | Focus app (run at end of bunch to hide all other apps) |
AppName_ | Hide an app |
| Snippets | |
< my.snippet | An external file to be included in the bunch |
- KEY=value | A variable to define for use in the snippet as ${KEY} |
< my.snippet#id | Reference a section of a snippet file |
< my.snippet#id ?"Run this Snippet?" | Allow interactive confirmation of a snippet |
| URLS | |
http://url | Open URL in browser |
urlhandler:// | Open a system url handler |
| Bunch Commands | |
(command) | Run a Bunch command |
(dark mode [on|off]) | dark mode on/off |
(do not disturb [on|off]) | do not disturb on/off |
([hide|show] dock) | hide/show dock |
(dock [left|right|bottom]) | dock left/right/bottom |
([hide|show] desktop) | hide/show desktop |
(wallpaper [path(s)]) | change wallpaper |
(audio [input|output] device_name) | audio input/output |
(audio [input|output] volume [0-100]) | audio volume |
(audio [input|output] [mute|unmute]) | mute/unmute audio |
| AppleScripts | |
* AppleScript command | Execute Applescript |
| Automator Workflows | |
& Automator Workflow | Run an Automator Workflow |
- key=value | variable to pass to preceding workflow (can be repeated) |
| Shell Scripts/Commands | |
$ script_or_cmd [args] | Shell script to execute |
- KEY=value | Environment variable to export for preceding shell script (can be repeated) |
Frontmatter
You can control some aspects of your Bunch using Frontmatter, including the title and icons it uses in the menu. See the Frontmatter docs for details.
URL Handler
See documentation for details.
| URL | Method |
|---|---|
x-bunch://open?bunch=[BUNCH NAME] | Open a Bunch |
x-bunch://[BUNCH NAME] | Open shorthand |
x-bunch://close?bunch=[BUNCH NAME] | Close a Bunch |
x-bunch://close/[BUNCH NAME] | Close shorthand |
x-bunch://toggle?bunch=[BUNCH NAME] | Toggle a Bunch |
x-bunch://toggle/[BUNCH NAME] | Toggle shorthand |
x-bunch://raw?txt=[BUNCH TEXT] | Run raw text as a Bunch |
x-bunch://snippet?file=[SNIPPET PATH]&fragment=[FRAGMENT]&foo=bar | Run a snippet with fragment and variables |