Skip to content


Subversion checkout URL

You can clone with
Download ZIP
portable version of OpenBSD's cwm(1) window manager
C Groff Yacc Other


* refs/heads/master: (21 commits)
  Lost fix from r1.112; add comment.
  Mechanical change: group->gc
  Add consistent checks against NULL.
  Move client cycle grab/ungrab into a more relevant place; while here, update comments about why we need to grab/ungrab the keyboard.
  Re-add lost chunk in group_cycle from r1.113.
  Further simplify _NET_WM_DESKTOP handling using new group_assign().
  oops; remove left over debug print
  Allowing sending a valid 'nogroup' (0) group_ctx to group_assign() (since we init all groups), though assigning the client's group to NULL for 'sticky'; use this simplification in a few places (others to follow).
  Split out sticky mode checks and the restoring of a client's group and _NET_WM_DESKTOP from the config-based auto-grouping; no (intentional) behavior changes.  Needed for further work in cleaning up this area.
  Implement _NET_CLIENT_LIST_STACKING (from Thomas Admin), but bottom-to-top order, as per spec (notified Thomas as well).
  Don't allow freeze operations on fullscreen (consistent with what fullscreen does).
  Sort _NET_WM_STATE Atoms like the spec.
  Move CLIENT_STICKY logic from client hide/unhide to group hide/unhide; rationale being that clients should be able to hide/unhide independently of group switching.
  Add Xkb modifier to ignore mask; from Alexander Polakov.
  Fix whitespace.
  Add client freeze extension to _NET_WM_STATE Atom, allowing flag to persist. As usual with new Atoms, requires X restart.
  _NET_WM_STATE_STICKY implies only sticky at the group/desktop level, not position and size; based on discussion with a few.
  Instead of special casing the 'term' and 'lock' commands, go back to keeping them hidden; showing them has apparently caused confusion/angst.
  Leave command list order from .cwmrc alone; remove sort.
  Bring group and client cycle closer together.
latest commit 3f0b6cf4ea
okan authored
Failed to load latest commit information.
Makefile cvsimport
calmwm.c cvsimport
calmwm.h cvsimport
client.c cvsimport
conf.c cvsimport
cwm.1 Fix whitespace. also sign releases with signify
cwmrc.5 introduce 'groupsearch' for group menu search; matches on either group
fgetln.c Add missing functions
group.c cvsimport
kbfunc.c cvsimport
menu.c cvsimport
mousefunc.c cvsimport
parse.y cvsimport
queue.h queue.h: update.
reallocarray.c add reallocarray.c
screen.c cvsimport
search.c cvsimport
strlcat.c update imported str*.c
strlcpy.c update imported str*.c
strtonum.c update imported str*.c fix mirror
util.c cvsimport
xevents.c cvsimport
xmalloc.c cvsimport
xutil.c cvsimport


This is a port of OpenBSD's excellent cwm[0] to Linux and other

    cwm is a window manager for X11 which contains many features that
    concentrate on the efficiency and transparency of window
    management.  cwm also aims to maintain the simplest and most
    pleasant aesthetic.

This port requires pkg-config, Xft, Xinerama and Xrandr.  The included Makefile
should work with both GNU make and BSD make.  It has been built successfully on
OpenBSD, FreeBSD, NetBSD, OS X 10.9 and Linux.

This version actively tracks changes in the OpenBSD CVS repository.
Releases are roughly coordinated.

The revision controlled version is at
Releases can be found at

You are welcome to join the IRC channel ##cwm on Freenode to talk about cwm.


2012-05-02: First public release 5.1 of portable cwm.

2014-04-13: Second public release 5.5 of portable cwm.

User visible changes (for a full list including smaller bug fixes, see ff.)

Changes made between OpenBSD 5.1 and 5.2
* Fixed cwm(1) atom (WM_PROTOCOLS) style handing; closing a window will no
  longer close entire application if the client supports CLIENT_PROTO_DELETE.
* Re-implement atom handing for more consistent separation of cwm(1) and
  Extended Window Manager Hints.
* cwm(1) better integrated into the Window Manager
  Specification Project.

Changes made between OpenBSD 5.2 and 5.3
* Set the initial cwm(1) group to "1".
* Added cwm(1) per-group vert/horiz tiling support with new bind commands
  "vtile" and "htile."
* Made cwm(1) screen font an Xft(3) font.
* Specific last match for autogroup in cwmrc(5).
* Tab completion support for cwm(1) menus.
* Allow cwm(1) clients to be resized from a max state.
* Multibyte input to cwm(1) menu code now possible.

Changes made between OpenBSD 5.3 and 5.4
* Added support for mouse based group {,r}cycle to cwmrc(5).
* Allow mouse button4 and button5 in cwmrc(5).
* Made cwm(1) check for, and honour, CWStackMode and CWSibling change requests
  during a ConfigureRequest event.
* Honour PATH search order for cwm(1)'s exec.

Changes made between OpenBSD 5.5 and 5.4
* Only set the cwm(1) urgency flag if the client is not active.
* Allow the cwm(1) config parser continue parsing even after encountering an
* cwm(1) now follows the EWMH spec: if the cardinal returned is 0xFFFFFFFF (-1)
  then the window should appear on all desktops.
* Made cwm(1) supply a more useful title for windows launched via the ssh(1)
  command menu ("[ssh] ").
* Allowed cwm(1) to accept _NET_WM_DESKTOP and _NET_CURRENT_DESKTOP
* Implemented cwm(1) support for _NET_WM_STATE_FULLSCREEN hint, with keybinding
  changes: CM-f "fullscreen", CM-m "maximize".
* Instead of using the work area, use the Xinerama area for cwm(1) snap
* Save-set when cwm(1) is re-exec'ing so as to not lose State on our hidden
* Added cwmrc(5) support for XUrgency and matching
  _NET_WM_STATE_DEMANDS_ATTENTION ewmh hint, with configurable urgencyborder.
* Prepend the group shortcut in the cwm(1) client search menu;
  prepend shortcut in unhide menu.
* If not hidden during an UnmapNotify event, cwm(1) will now un-manage the
* Like "gap", made cwm(1) "snapdist" per-screen.
* Removed cwmrc(5) option to bind a key by keycode with brackets, which never
  worked. Users should be using keysym names not keycodes.
* Re-added cwm(1) support for WM_TAKE_FOCUS. Solves keyboard input focus loss
  for java apps.
* For cwm(1) clients that support WM_TAKE_FOCUS in their WM_PROTOCOLS property,
  send a ClientMessage event.

2015-01-24: Third public release 5.6 of portable cwm.

* Support building on FreeBSD and OS X.
* Support for sticky windows (_NET_WM_STATE_STICKY).
* Internal cleanups and bug fixes.

--Christian Neukirchen <>

Something went wrong with that request. Please try again.