waitron - A client for windowchef(1)
waitron [-hv] command [args...]
waitron is the client for windowchef(1). It sends a given command to
windowchef(1) as an X client message. As a result,
waitron doesn't print
Print version information.
topleft | topright | bottomleft | bottomright | middle
Move the focused window y pixels horizontally and y pixels vertically.
Move the focused window to the position given by x and y.
Resize the focused window based on the relative pixel values x and y.
Resize the focused window up to width and height.
Hide the border and maximize the focused window on the current monitor. Execute it again after maximizing to revert the state of the window.
If the currently focused window is maximized in any way (fully, vertically, horizontally, monocled), return it to normal state.
Horizontally maximize the focused window on the current monitor, preserving its x component. Leaves a gap at the left and right of the monitor that can be configured. Execute it again after maximizing to revert the state of the window.
Vertically maximize the focused window on the current monitor, preserving its y component. Leaves a gap at the top and bottom of the monitor whose width can be configured. Execute it again after maximizing to revert the state of the window.
Puts the window in the "monocled" state: full screen but with borders visible. Monocle mode respects gaps.
Closes the focused window.
window_put_in_gridgrid_width grid_height cell_x cell_y
Moves and resizes the focused windows accordingly to fit in a cell defined by the cell_x and cell_y coordinates in a virtual grid with width grid_width and height grid_height on the current monitor. Gaps around the windows in the grid can be added along with monitor gaps.
Snap the window on the screen in a position defined by POSITION.
Cycle through mapped windows.
Reverse cycle through mapped windows.
Cycle trough mapped windows that belong to the same group as the focused window.
Reverse cycle through mapped windows that belong to the same group as the focused window.
Focus window by id. The id can be found using pfw(1) or lsw(1) from wmutils.
Focus the window that was focused before the currently focused window.
Focus the closest window in a direction, relative to the currently currently focused window. Does nothing if there is no window focused.
Add the focused window to the group_nr group.
Group numbers start from 0 and end at GROUPS_NO - 1.
Remove the focused window from its current group.
Remove all windows from the group_nr group.
Map all windows that belong to the group_nr group.
Unmap all windows that belong to the group_nr group.
Toggle the group_nr group.
Activate group group_nr and deactivate the rest.
Quit windowchef with exit_status exit_status.
Change the number of maximum groups to number_of_groups.
Windows that belong to a group that has a group_nr greater or equal to number_of_groups will become orphaned.
Information about the current state of windowchef is made available through X properties of the root window. Example:
xprop -root WINDOWCHEF_ACTIVE_GROUPS
Here is a list of exposed properties:
Configuring is done using the
wm_config command. Possible configuration keys
Sets the border width to width pixels.
Sets the border color to color for the focused and unfocused state respectively.
color is a hexadecimal value that may or may not start with
Make the first width pixels from the interior to the exterior of the
border of another color, so you get two borders.
The width of the external border is
color_unfocused, but for the internal
Sets the window gap at POSITION to width. POSITION can be equal to
all to set all gaps to POSITION.
Sets the window gap value used in virtual grids to width.
Sets the position of the cursor when moving or resizing windows.
Sets the number of groups to nr. If nr is less than the current number of groups, window that belong to groups whose numbers are greater than nr will be mapped to screen and assigned to the null group.
windowchef will respect window resize hints as defined by ICCCM. Most terminal emulators should have this feature.
Enable sloppy focus.
If sticky_windows is true, new windows will be assigned to the last activated group automatically. Recommended for people who like using workspaces over groups.
If true, border colors will be set each time a window gets/loses focus.
Setting it to false is useful when using another program to draw the borders
chwb2 from wmutils).
If true, when the currently focused window is unmapped or closed,
windowchef will focus the
previously focused window. See the
If true, then some settings will be applied on all windows instead of newly created windows. True by default.
If true, when clicking on an unfocused with the intent to focus it, windowchef will also send the click event to the target window. If false, the window will receive the click event only if it's already focused.
pointer_actionsPOINTER_ACTION POINTER_ACTION POINTER_ACTION
Sets the action that should be done whenever the modifier key and the corresponding button are clicked at the same time on the window. There are 3 actions for three mouse buttons: left, middle and right.
Set the modifier for pointer actions.
Set the mouse button that focuses the hovered window when clicked.
windowchef(1), sxhkd(1), wmutils(1), pfw(1), lsw(1), chwb2(1), lemonbar(1)
windowchef issue tracker: https://github.com/tudurom/windowchef/issues
<tudurom at gmail dot com>