mcpcpc / xwm Goto Github PK

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.