Skip to content
EN
Download

Keyboard and mouse

This page covers the settings that change how the keyboard and the mouse work with your windows. The shortcuts themselves are on Shortcuts.

TilingBud’s shortcuts lie on Control, and Caps Lock sits under your little finger. With Caps Lock as Control and Escape on Settings › Keyboard:

  • Caps Lock held is the left Control key.
  • Caps Lock tapped alone sends Escape.
  • Escape becomes Caps Lock.

It is off by default and part of the recommended settings of the setup assistant.

Longest tap is the longest press, 50 to 500 milliseconds, that still sends Escape (tap_ms, 250). Held longer, or with another key or a click in between, Caps Lock is Control only. While the setting is on, the page shows a tester with your last three presses of Caps Lock and how long each lasted.

[keyboard]
caps_lock_control_escape = true
tap_ms = 250

With Drag windows with a modifier key on Settings › Keyboard › Windows with the Mouse, hold the key, press anywhere in a window and drag it, not only at its title bar. Where you let go, the layout decides as after a drag at the title bar.

  • Modifier key: Option (the default), Control, Command, Shift, Fn, or Control and Command together. No other of these keys may be held with it.
  • Dragging with the right button: Resizes the window moves the corner nearest to where you pressed (the default); Does nothing leaves right clicks to the app.
[keyboard]
drag_windows = true
drag_modifier = "option"
right_drag = "resize"

It is off by default and part of the recommended settings as “Move windows from anywhere”.

You can drag an arranged window by its title bar, or anywhere with the modifier key, and drop it on another window. While you hold it over a window, an overlay shows the area it would get and says what letting go does, such as “Insert below Safari”.

  • The middle of the other window exchanges the two.
  • A side of the other window splits it on that side (bsp) or puts the window beside it (scroll: a column of its own left or right, or into the column above or below).
  • On a main space every part exchanges the two.
  • On a stacked space the window goes back to the stack.

With Windows stay where they are dropped under Settings › Layout & Tiling › Moving a Window by Hand (drag_keeps_place, on by default), a window of a bsp or scroll space that you drop within its space, not on another window, keeps the place where you let it go. The edges it shares with a neighbor follow it, and the edges at the screen border stay. An overlay marks the windows that make room while you drag.

Turned off, the window goes back to its place.

[tiling]
drag_keeps_place = true

Drag the edge between two arranged windows and the split follows; the neighbor adapts and nothing moves after you let go. In scroll, the edge of a column sets its width, and the edge between two windows of a column their heights. In main, dragging the divider changes the main area’s share for that space until TilingBud restarts.

Focus follows the mouse under Settings › Spaces › Focus gives the focus to the window under the pointer once the pointer rests on it for a moment:

Choice focus_follows_mouse What it does
Off "off" The default
Raise "autoraise" The window gets the focus and comes to the front
Focus Only "autofocus" The window gets the focus and stays behind the window in front

Where macOS does not allow Focus Only, TilingBud raises the window instead and Settings says so.

Pointer follows the focus to another display on the same page (mouse_follows_focus, on by default) moves the pointer when the focus goes to another display and the pointer is not on it: to the middle of the focused window, or of the display if it has no window. Within one display the pointer stays where it is.

[tiling]
focus_follows_mouse = "off"
mouse_follows_focus = true

With Show what a shortcut does on Settings › Shortcuts (shortcut_hints, off by default), each shortcut that runs shows its keys and what it does for about a second at the bottom of the display with the focus. The hint shows on every space and does not take the focus.

[keyboard]
shortcut_hints = true