Bunch Tips

• Paths to documents can use a tilde ~ to represent the home directory. Spaces are fine, no quotes or escaping needed.
• You can also append an underscore to any single app name and Bunch will attempt to hide it after launching.
• When you change the Bunches folder location, it doesn't move or delete any of the Bunches at the previous location. That means that (in a fairly inelegant way) you can use different folders for different sets of Bunches. You can also quickly switch sets using the setPrefs URL handler.
• If you manually change the Desktop wallpaper while Bunch is running, use Preferences->Save Current Wallpaper as Default to update the fallback image(s).
• It's highly recommended that you set your alert style for Bunch notifications to "Alerts" in System Preferences->Notifications. This makes the information from Bunches more useful, and allows some actions (like scheduled Bunches) to provide a cancel method that would otherwise be quickly hidden.
• When using close after frontmatter, keep in mind that you can use % before app names to ignore them when closing. That means your Bunch can do things like turn on Do Not Disturb or toggle Dark Mode and then restore settings after a set period of time. Combine with an open option to toggle things on and off at set intervals. Apps that are already open will be unaffected by Bunch opens.
• You can fork a script using the $BUNCH variable. If you have a script with common tasks but you need it to differ between Bunches in some way, do something along the lines of (in Bash): if [[ $BUNCH == Podcast ]]; then...
• raw text processing in the URL handler and AppleScript dictionary is also useful in scripts where you want to read in the contents of a Bunch, modify them in some way, then execute the result. It won't mark that Bunch as "open" when it executes, but it's one way to add dynamic processing.
• To create a Bunch action in BetterTouchTool, Keyboard Maestro or other automation tool, just create an action that opens a URL and use something like x-bunch://toggle/BunchName to create a hotkey or button that toggles a Bunch. You can create a whole launch control panel on a Stream Deck with these, for example.
• The Bunch CLI can generate URLs that run various commands for use in other applications. Run bunch -i to interactively build a URL.
• The Bunch name in the URL handler is case insensitive, so "bunch name" works just as well as "Bunch Name."
• If you have a task in a task manager that requires a certain set of apps, create a Bunch and then add a link to the task's notes: x-bunch://open/WorkBunch