core's Introduction

wmutils' core

wmutils' core is a set of tools for X windows manipulation. Each tool only has one purpose, to make it as flexible and reliable as possible.

Here's a quick example. This snippet will put the currently focused window in the middle of the screen:

#!/bin/sh

# get current window id, width and height
WID=$(pfw)
WW=$(wattr w $WID)
WH=$(wattr h $WID)

# get screen width and height
ROOT=$(lsw -r)
SW=$(wattr w $ROOT)
SH=$(wattr h $ROOT)

# move the current window to the center of the screen
wtp $(((SW - WW)/2)) $(((SH - WH)/2)) $WW $WH $WID

You also might want to check sxhkd, a daemon which allow binding applications to hot keys.

utilities

Here are the tools. This project is quite young, new tools can arrive without being added to this list, so take it with a grain of salt.

chwb - change window's border
chwso - change window's stacking order
ignw - ignore/unignore window
killw - kill windows
lsw - list windows
mapw - map/unmap windows
pfw - print focused window
wattr - show window's attributes
wmp - move the mouse pointer
wmv - move a window
wrs - resize a window
wtf - focus a window
wtp - teleport a window

All these tools come with a manpage ! read them for further informations.

dependencies

wmutils only relies on the XCB library.

license

All the code of this project is released under the ISC license. See LICENSE file.

build & install

System-wide installation (default PREFIX is /usr):

$ make
# make install

Here are the varialbes you can override, along with their default values:

CC         =  cc
LD         =  $(CC)
CFLAGS     =  -std=c99 -pedantic -Wall -Os
LDFLAGS    =  -lxcb
PREFIX     =  /usr
MANPREFIX  =  $(PREFIX)/man
DESTDIR    =

You can override them by passing them on the command line: