From Wikipedia, the free encyclopedia
Developer(s)Shawn Betts
Stable release
22.11[1] Edit this on Wikidata / 27 November 2022
Written inCommon Lisp
Operating systemUnix-like
TypeWindow manager

StumpWM is a tiling window manager that was created when developer Shawn Betts found ratpoison growing increasingly large and "lispy". Intended as a successor to ratpoison, StumpWM is released under the terms of the GPL-2.0-or-later license.[2]

As explained on the StumpWM wiki, the developers decided to largely re-implement ratpoison in Common Lisp using CLX:[3]

StumpWM grew out of the authors' frustration with writing ratpoison in C. Very quickly we realized we were building into ratpoison lispy-emacs style paradigms. We had a REPL hanging off 'C-t :', hooks, and a growing subset of Common Lisp in the implementation... It was clear what we really wanted was a window manager written in Lisp from the ground up with lots of room for customizing and real-time hacking.

The authors describe StumpWM in the following terms:[4]

StumpWM attempts to be customizable yet visually minimal. There are no window decorations, no icons, and no buttons. It does have various hooks to attach your personal customizations, and variables to tweak.

Lisp and customization[edit]

StumpWM can be run in both Steel Bank Common Lisp (SBCL) and GNU CLISP, with SBCL generally being preferred for better performance.[4] The SLIME environment is commonly used for applying real-time updates and customizations to StumpWM. There is also another program called stumpish ("StumpWM Interactive Shell") that provides a standard way to interface with the window manager from a terminal.[4]

Window manager customizations are stored in a .stumpwmrc file that is found in the home directory of each user. This file contains Lisp code for configuring StumpWM.[4]


StumpWM source code is hosted on GitHub and the version control system used is Git.[5] A mailing list is also available for StumpWM related issues.[6]

See also[edit]


  1. ^ "Release 22.11". 27 November 2022. Retrieved 26 December 2022.
  2. ^ a b StumpWM COPYING file.
  3. ^ "Background". The StumpWM wiki. 2006-10-05. Retrieved 2014-12-01.
  4. ^ a b c d "Stumpwm - ArchWiki".
  5. ^ "The Stump Window Manager: Downloads".
  6. ^ "Stump-devel".