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.
Caps Lock as Control and Escape
Section titled “Caps Lock as Control and Escape”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 = truetap_ms = 250Dragging windows with a modifier key
Section titled “Dragging windows with a modifier key”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 = truedrag_modifier = "option"right_drag = "resize"It is off by default and part of the recommended settings as “Move windows from anywhere”.
Dragging windows in the layout
Section titled “Dragging windows in the layout”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.
Dropped where you let go
Section titled “Dropped where you let go”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 = trueResizing with the mouse
Section titled “Resizing with the mouse”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 and the pointer
Section titled “Focus and the pointer”Focus follows the mouse
Section titled “Focus follows the mouse”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.
Mouse follows focus
Section titled “Mouse follows focus”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 = trueShortcut hints
Section titled “Shortcut hints”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