NAME

howlc — client to control the howl(1) compositor

SYNOPSIS

howlc cmd [args ...]

COMMANDS

Aside from the configuration commands (bind, borders, etc.), all of the following commands take a window ID argument. Command arguments will always take order priority over the window IDs.

move, move_absolute x y: Move the window relative to its current position by x and y pixels, or to the absolute position on the screen specified by x and y.

resize, resize_absolute w h: Resize the window relative to its current size by w and h pixels, or to the absolute size specified by w and h.

teleport x y w h: Move and resize the window to the absolute geometry specified by x, y, w and h.

center: Move the window to the center of its current screen.

fullscreen: Fullscreen the window on its current screen.

show, hide: Map / unmap the window.

raise, lower: Raise / lower the window in the stack.

focus_next, focus_prev: Focus the next / previous window on the current workspace.

unfocus: Unfocus the current window.

close: Close the window.

workspace, move_workspace num: Switch to, or move the window to the workspace specified by num.

get_geometry, get_screen_geometry: Print the window's geometry in the format of x, y, width and height, or the main screen's geometry in the format of width and height.
get_pid: Print the window's controlling process' PID, or 0 if unknown.
get_title, get_app_id: Print the window's title or app ID.
get_focus: Print the currently focused window's ID. If no window is focused, the commands exits with a nonzero status.
get_workspace: Print the currently active workspace.
get_cursor_position: Print the cursor's position in the format of x and y.

list_windows [-mua]: Print a list of (by default) mapped windows. Alternatively, passing the -u option will make it print a list of unmapped windows, and passing the -a option will make it print a list of both mapped and unmapped windows.

bind keys cmd: Bind a combination of keys to execute cmd. keys is a string in the format of mods + keys, where mods can be either mod, alt, logo, ctrl, shift or any, and keys can be any valid keysym string as validated by xkb_keysym_from_name().

unbind keys: Unbind the key combination specified by keys, or, if not bound, exit with a nonzero status.

modkey keys: Change the modifier key combination as specified by keys. The combination is in the same format as mentioned above, see bind.

inner_unfocus_color, inner_unfocus_color, outer_focus_color, outer_unfocus_color color: Change the inner / outer border's focused / unfocused color to color.

inner_border_width, outer_border_width width: Change the inner / outer border's width to width.

title_format fmt

Change the format of the window title as displayed in the titlebar to fmt. Accepted format strings are:

‘%t’: window title
‘%a’: window app ID
‘%p’: window's controlling process' PID

set_decor path: Load the decoration folder at path.

quit: Exits the compositor.

EXIT STATUS

The howlc utility exits 0 on success, and >0 if an error occurs.

AUTHORS

wf <smite@netc.fr>

howl and howlc are maintained at https://git.sr.ht/~wf/howl.

BUGS

The manual has no information about the format of decoration folders; however, the src/decor.c file in the source does describe it somewhat extensively.

Many, many more.