Link Search Menu Expand Document

Bunch Special Commands

Lines surrounded in parenthesis are Bunch commands. These offer shortcuts to some system tasks.

(dark mode [on|off])
(do not disturb [on|off])
([hide|show] dock)
(dock [left|right|bottom])
([hide|show] desktop)
(wallpaper [path(s)])
(audio [input|output] device_name)
(audio [input|output] volume [0-100])
(audio [input|output] [mute|unmute])
Dark mode commands
Turn macOS Dark Mode on and off: (dark mode on), (dark mode off). An β€œon” command can be shortened to just (dark mode), and (dark mode off) can be shortened to (light mode).
Do not disturb commands
Toggle notifications. The commands can be abbreviated as (dnd on) and (dnd off). Actually, (dnd on) can just be (dnd), too. I like to make things intuitive by overcomplicating them sometimes.
Dock commands
((hide dock), (show dock)) show and hide the Dock (Turn Hiding On), or reposition the dock ((dock left), (dock bottom), (dock right)).
Desktop commands
Hide and show desktop icons: (hide desktop), (show desktop).
Wallpaper commands
Set the Desktop Image for one or more displays. Provide a full path to the image, e.g. (wallpaper ~/Pictures/my desktop.jpg). If a single path is given, all available displays will be set to that image. If multiple paths separated by a pipe (|) are provided, images will be applied to the available displays in order (first image path to first display, second path to second display, etc.). If you declare more paths than you have displays, additional paths will be ignored. The desktop image(s) that are in place when Bunch first launches will be restored when quitting any Bunch.

If you manually change the Desktop image while Bunch is running, use Preferences->Save Current Wallpaper as Default to update the fallback image(s).

Audio commands
Change your system input and output devices, as well as control the volume of either.
To set an audio device, you just need to specify input or output, and then provide all or a unique part of the name of an existing device (case insensitive, first match wins). For example, (audio input scarlett) would set my system input to my Scarlett Solo. (audio output io hub) would change my system audio output to my iO Hub.
The volume command defaults to output volume if input or output is not specified (e.g. (audio volume 50)). Specify input or output before a volume or mute command to affect one channel or the other. (audio output 0) will simulate mute β€” use (audio output mute) to actually mute the channel while preserving volume setting. (All of the preceding commands will work with either input or output.)

All commands are reversed when closing a Bunch, with the exception of the Dock positioning commands and the audio commands. To avoid reversing a command when closing the Bunch, precede the line with a % symbol, e.g. %(hide dock) (similar to ignoring applications when quitting).

To run the command only when closing a bunch, use an exclamation point (!) before the command, e.g. !(show desktop).