https://github.com/mcpcpc/xwm
A tiny XCB floating window manager.
https://github.com/mcpcpc/xwm
c99 posix window-manager wm xcb
Last synced: about 1 year ago
JSON representation
A tiny XCB floating window manager.
- Host: GitHub
- URL: https://github.com/mcpcpc/xwm
- Owner: mcpcpc
- License: mit
- Created: 2020-11-06T17:45:55.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2022-07-19T14:10:04.000Z (almost 4 years ago)
- Last Synced: 2025-02-02T17:42:42.415Z (over 1 year ago)
- Topics: c99, posix, window-manager, wm, xcb
- Language: C
- Homepage:
- Size: 42 KB
- Stars: 161
- Watchers: 3
- Forks: 13
- Open Issues: 1
-
Metadata Files:
- Readme: README
- Changelog: CHANGELOG
- Contributing: .github/CONTRIBUTING
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-ricing - xwm - A tiny XCB floating window manager. (C) (Packages / window-managers)
README
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.