Permissions
TilingBud needs one permission from macOS, Accessibility. Screen Recording and Input Monitoring are optional and add to single features. TilingBud works with SIP on and changes no security setting on its own.
Accessibility (required)
Section titled “Accessibility (required)”Accessibility lets TilingBud read where the windows of other apps are, move, resize and focus them, and switch spaces. TilingBud does not read what is inside the windows.
Grant it in System Settings › Privacy & Security › Accessibility: TilingBud has to be on there.
Screen Recording (optional)
Section titled “Screen Recording (optional)”Screen Recording lets TilingBud read the titles of other apps’ windows directly from macOS. Without it the titles are read through Accessibility, which is slower: titles of windows on other spaces appear with a delay.
Titles show in the menu bar with Show the focused window’s title and in the hover panel. See Menu bar.
Input Monitoring (optional)
Section titled “Input Monitoring (optional)”Input Monitoring is needed only for media keys as shortcut keys and for shortcut modes that capture the keyboard. Settings › Shortcuts says when one of these is configured and the permission is missing. Grant it in System Settings › Privacy & Security › Input Monitoring. See Shortcuts.
The permission window
Section titled “The permission window”When TilingBud starts while something required is missing, it opens its permission window. The setup assistant at the first start has the same step. It lists each item with why TilingBud needs it, the features that depend on it, and whether it is Required, Optional or Recommended.
- Request Access asks macOS for the permission. macOS shows its dialog only after you click it, and only once.
- Open Settings opens the page of System Settings that holds it.
The window updates by itself: an item turns to Granted the moment you switch it on. Set Up Missing Permissions… in the menu bar item’s menu opens it again while something required is missing. Settings › Permissions & Features shows the same list, and below it which of TilingBud’s features work on this Mac.
When a feature is not available, the menu shows how many are missing (“1 feature not available…”), and Settings › Permissions & Features names what you can do instead under each one.
If a permission does not take
Section titled “If a permission does not take”- Click Reset Entry in the permission window.
- Click Request Access again.
Or remove TilingBud from the list in System Settings with the minus button and add it again with the plus button.
Recommended system settings
Section titled “Recommended system settings”The permission window and Settings › Permissions & Features also list system settings that make TilingBud work better. None of them is required.
Keep spaces in their order
Section titled “Keep spaces in their order”In System Settings › Desktop & Dock, section Mission Control near the end of the page, turn off “Automatically rearrange Spaces based on most recent use”.
F1 to F12 as standard function keys
Section titled “F1 to F12 as standard function keys”Otherwise F1 to F12 control brightness, volume and media, and a shortcut on one of them works only with Fn held. In System Settings › Keyboard › Keyboard Shortcuts › Function Keys, turn on “Use F1, F2, etc. keys as standard function keys”.
Swiping left to TilingBud
Section titled “Swiping left to TilingBud”With scroll_swipe_fingers set, TilingBud scrolls the rows of scroll spaces
with a three- or four-finger swipe. If macOS switches spaces with the same swipe, both happen at once. In System
Settings › Trackpad, tab More Gestures, set “Swipe between full-screen applications” to the other finger count.
Update the tilingbud command
Section titled “Update the tilingbud command”When the tilingbud command on your PATH belongs to an older or removed TilingBud, scripts and tools that call it
fail. Update links the command to this TilingBud, the same as Install Command Line Tool… in the menu.
Switching spaces needs no setting
Section titled “Switching spaces needs no setting”TilingBud switches spaces with the Dock’s swipe and needs no macOS shortcut for it. macOS’s own “Switch to Desktop N” shortcuts (System Settings › Keyboard › Keyboard Shortcuts › Mission Control) are off by default. When one is on, TilingBud also uses it; Settings › Shortcuts shows which are on under macOS: Switch to Desktop.