Skip to content
EN
Download

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 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 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 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.

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.

  1. Click Reset Entry in the permission window.
  2. 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.

The permission window and Settings › Permissions & Features also list system settings that make TilingBud work better. None of them is required.

In System Settings › Desktop & Dock, section Mission Control near the end of the page, turn off “Automatically rearrange Spaces based on most recent use”.

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”.

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.

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.

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.