xwm - a tiny XCB floating window manager

A minimal viable solution that was developed with single-monitor workflows in mind. Despite the small footprint, xwm maintains extensibility and can be customized to enhance the user experience.

REQUIREMENTS

xcb-util-keysyms, along with any default or user defined utilities: application launcher https://git.suckless.org/dmenu terminal emulator https://git.suckless.org/st internet browser https://git.suckless.org/surf

COMMANDS

Default keys and behavior can be customized via the config.h file: Win+Button1 raise focused window to top of stack Win+Button3 raise focused window to top of stack Win+Button1+[drag] interactive window move Win+Button3+[drag] interactive window resize Win+Space run launcher menu (default: dmenu_run) Win+Enter create new terminal window (default: st) Win+b create new browser window (default: surf) Win+q kill focused window Win+f full-screen focused window Win+Shift+q quit window manager

INSTALL

Building and installing from source: $ git clone https://github.com/mcpcpc/xwm $ cd xwm $ make $ sudo make install

EXAMPLES

Checking the installed version of xwm: $ xwm -v

Using startx to run xwm: $ echo "exec xwm" > ~/.xinitrc $ startx

Using imagemagick to set a wallpaper: $ display -window root background.png

Patching xwm: $ patch -p0 < mypatch.patch

DISCLAIMER

xwm ("XCB Window Manager") is an homage to the original and now-defunct "X Window Manager". Both projects are unaffiliated and do not share any common source code.

CONTACT

For questions or issues, please contact michaelczigler[at]mcpcpc[dot]com.